VENTES: 1-800-867-1389
Développer Réduire

sys.dm_exec_describe_first_result_set_for_object

Mis à jour: avril 2011

Cette rubrique est obsolète. La version actualisée est disponible à la page Référence SQL 14 Transact-SQL.

ImportantImportant
Cette rubrique n'est pas tenue à jour. Pour obtenir la version actuelle, consultez sys.dm_exec_describe_first_result_set_for_object.

Cette fonction de gestion dynamique accepte un @object_id comme paramètre et décrit les premières métadonnées de résultat pour le module avec cet ID. L'identifiant @object_id spécifié peut être l'ID d'une procédure stockée Transact-SQL ou un déclencheur Transact-SQL. S'il s'agit de l'ID de tout autre objet (tel qu'une vue, une table, une fonction ou une procédure CLR), une erreur sera spécifiée dans les colonnes d'erreur du résultat.

sys.dm_exec_describe_first_result_set_for_object a la même définition de jeu de résultats que sys.dm_exec_describe_first_result_set et est semblable à sp_describe_first_result_set (Transact-SQL).

Conventions de la syntaxe Transact-SQL


sys.dm_exec_describe_first_result_set_for_object 
    ( @object_id,@include_browse_information )

@object_id
L'identifiant @object_id d'une procédure stockée Transact-SQL ou un déclencheur Transact-SQL. @object_id est du type int.

@include_browse_information
@include_browse_information est du type bit. Lorsque la valeur 1 est définie, chaque requête est analysée comme si elle comportait une option FOR BROWSE sur la requête. Retourne des colonnes clés supplémentaires et des informations de table source.

Ces métadonnées communes sont retournées en tant que jeu de résultats avec une ligne pour chaque colonne dans les métadonnées de résultats. Chaque ligne décrit le type et la possibilité de valeur NULL de la colonne dans le format décrit dans la section suivante. S'il n'existe pas de première instruction pour chaque chemin d'accès de contrôle, un jeu de résultats avec des lignes nulles est retourné.

 

Nom de la colonne Type de données Description

is_hidden

bit

Spécifie si la colonne est une colonne supplémentaire ajoutée à titre d'informations de navigation qui ne s'affiche pas réellement dans le jeu de résultats.

column_ordinal

int

Contient la position ordinale de la colonne dans le jeu de résultats. La position de la première colonne sera spécifiée comme 1.

nom

sysname

Contient le nom de la colonne si un nom peut être déterminé. Sinon, la valeur est NULL.

is_nullable

bit

Contient la valeur 1 si la colonne autorise des valeurs NULL, 0 si la colonne n'autorise pas de valeurs NULL et 1 s'il est impossible de déterminer que la colonne autorise des valeurs NULL.

system_type_id

int

Contient le system_type_id du type de données de la colonne comme spécifié dans sys.types. Pour les types CLR, bien que la colonne system_type_name retourne NULL, cette colonne retournera la valeur 240.

system_type_name

nvarchar(256)

Contient le nom du type de données. Inclut des arguments (tels que la longueur, la précision, l'échelle) spécifiés pour le type de données de la colonne. Si le type de données est un type d'alias défini par l'utilisateur, le type de système sous-jacent est spécifié ici. S'il s'agit d'un type clr défini par l'utilisateur, NULL est retourné dans cette colonne.

max_length

smallint

Longueur maximale (en octets) de la colonne.

-1 = Les données de la colonne sont de type varchar(max), nvarchar(max), varbinary(max) ou xml.

Pour les colonnes de text, la valeur max_length sera 16 ou la valeur définie par sp_tableoption 'text in row'.

precision

tinyint

Précision de la colonne si elle est numérique. Dans le cas contraire, retourne la valeur 0.

scale

tinyint

Échelle de la colonne si elle est numérique. Dans le cas contraire, retourne la valeur 0.

collation_name

sysname

Nom du classement de la colonne si elle est basée sur les caractères. Dans le cas contraire, la valeur NULL est retournée.

user_type_id

int

Pour les types d'alias et CLR, contient l'information user_type_id du type de données de la colonne comme spécifié dans sys.types. Sinon, la valeur est NULL.

user_type_database

sysname

Pour les types d'alias et CLR, contient le nom de la base de données dans laquelle le type est défini. Sinon, la valeur est NULL.

user_type_schema

sysname

Pour les types d'alias et CLR, contient le nom du schéma dans lequel le type est défini. Sinon, la valeur est NULL.

user_type_name

sysname

Pour les types d'alias et CLR, contient le nom du type. Sinon, la valeur est NULL.

assembly_qualified_type_name

nvarchar(4000)

Pour les types CLR, retourne le nom de l'assembly et de la classe définissant le type. Sinon, la valeur est NULL.

xml_collection_id

int

Contient l'information xml_collection_id du type de données de la colonne comme spécifié dans sys.columns. Cette colonne retournera NULL si le type retourné n'est pas associé à une collection de schémas XML.

xml_collection_database

sysname

Contient la base de données dans laquelle la collection de schémas XML associée à ce type est définie. Cette colonne retournera NULL si le type retourné n'est pas associé à une collection de schémas XML.

xml_collection_schema

sysname

Contient le schéma dans lequel la collection de schémas XML associée à ce type est définie. Cette colonne retournera NULL si le type retourné n'est pas associé à une collection de schémas XML.

xml_collection_name

sysname

Contient le nom de la collection de schémas XML associé à ce type. Cette colonne retournera NULL si le type retourné n'est pas associé à une collection de schémas XML.

is_xml_document

bit

Retourne 1 si le type de données retourné est XML et que ce type est garanti être un document XML complet (nœud racine compris), par opposition à un fragment XML. Dans le cas contraire, retourne la valeur 0.

is_case_sensitive

bit

Retourne 1 si la colonne est d'un type chaîne sensible à la casse et 0 si ce n'est pas le cas.

is_fixed_length_clr_type

bit

Retourne 1 si la colonne est d'un type CLR de longueur fixe et 0 si ce n'est pas le cas.

source_server

sysname

Nom du serveur d'origine retourné par la colonne dans ce résultat (s'il provient d'un serveur distant). Le nom est donné tel qu'il s'affiche dans sys.servers. Retourne NULL si la colonne provient du serveur local, ou s'il est impossible de déterminer la provenance du serveur. Fourni uniquement si les informations de navigation sont demandées.

source_database

sysname

Nom de la base de données d'origine retourné par la colonne dans ce résultat. Retourne NULL si la base de données ne peut pas être déterminée. Fourni uniquement si les informations de navigation sont demandées.

source_schema

sysname

Nom du schéma d'origine retourné par la colonne dans ce résultat. Retourne NULL si le schéma ne peut pas être déterminé. Fourni uniquement si les informations de navigation sont demandées.

source_table

sysname

Nom de la table d'origine retourné par la colonne dans ce résultat. Retourne NULL si la table ne peut pas être déterminée. Fourni uniquement si les informations de navigation sont demandées.

source_column

sysname

Nom de la colonne d'origine retourné par la colonne dans ce résultat. Retourne NULL si la colonne ne peut pas être déterminée. Fourni uniquement si les informations de navigation sont demandées.

is_identity_column

bit

Retourne 1 si la colonne est une colonne d'identité et 0 dans le cas contraire. Retourne NULL s'il est impossible de déterminer que la colonne est une colonne d'identité.

is_part_of_unique_key

bit

Retourne 1 si la colonne fait partie d'un index unique (notamment la contrainte unique et primaire) et 0 dans le cas contraire. Retourne NULL s'il est impossible de déterminer que la colonne fait partie d'un index unique. Fourni uniquement si les informations de navigation sont demandées.

is_updateable

bit

Retourne 1 si la colonne peut être mise à jour et 0 dans le cas contraire. Retourne NULL s'il est impossible de déterminer que la colonne peut être mise à jour.

is_computed_column

bit

Retourne 1 si la colonne est une colonne calculée et 0 dans le cas contraire. Retourne NULL s'il est impossible de déterminer que la colonne est une colonne calculée.

is_sparse_column_set

bit

Retourne 1 si la colonne est une colonne éparse et 0 dans le cas contraire. Retourne NULL s'il est impossible de déterminer que la colonne fait partie d'un jeu de colonnes éparses.

ordinal_in_order_by_list

smallint

Position de cette colonne dans la liste ORDER BY. Retourne NULL si la colonne ne s'affiche pas dans la liste ORDER BY ou si la liste ORDER BY ne peut pas être déterminée de manière unique.

order_by_list_length

smallint

Longueur de la liste ORDER BY. Retourne NULL s'il n'existe aucune liste ORDER BY ou si la liste ORDER BY ne peut pas être déterminée de manière unique. Notez que cette valeur sera la même pour toutes les lignes retournées par sp_describe_first_result_set.

order_by_is_descending

smallint NULL

Si la valeur ordinal_in_order_by_list n'est pas NULL, la colonne order_by_is_descending indique la direction de la clause ORDER BY pour cette colonne. Sinon, elle indique NULL.

error_number

int

Contient le numéro d'erreur retourné par la fonction. Contient NULL si aucune erreur ne s'est produite dans la colonne.

error_severity

int

Contient la gravité retournée par la fonction. Contient NULL si aucune erreur ne s'est produite dans la colonne.

error_state

int

Contient le message d'état retourné par la fonction. La colonne contient NULL si aucune erreur ne s'est produite.

error_message

nvarchar(4096)

Contient le message retourné par la fonction. Si aucune erreur ne s'est produite, la colonne contiendra NULL.

error_type

int

Contient un entier qui représente l'erreur retournée. Mappé à error_type_desc. Consultez la liste sous les notes.

error_type_desc

nvarchar(60)

Contient une chaîne majuscule courte qui représente l'erreur retournée. Mappé à error_type. Consultez la liste sous les notes.

Cette fonction utilise le même algorithme que sp_describe_first_result_set. Pour plus d'informations, consultez sp_describe_first_result_set (Transact-SQL).

Le tableau suivant répertorie les types d'erreur et leur description.

 

error_type error_type Description

1

MISC

Toutes les erreurs qui ne font pas l'objet d'une description.

2

SYNTAX

Une erreur de syntaxe s'est produite dans le lot.

3

CONFLICTING_RESULTS

Le résultat n'a pas pu être déterminé en raison d'un conflit entre deux premières instructions possibles.

4

DYNAMIC_SQL

Le résultat n'a pas pu être déterminé en raison du SQL dynamique qui pourrait éventuellement retourner le premier résultat.

5

CLR_PROCEDURE

Le résultat n'a pas pu être déterminé parce qu'une procédure stockée clr pourrait éventuellement retourner le premier résultat.

6

CLR_TRIGGER

Le résultat n'a pas pu être déterminé parce qu'un déclencheur CLR pourrait éventuellement retourner le premier résultat.

7

EXTENDED_PROCEDURE

Le résultat n'a pas pu être déterminé parce qu'une procédure stockée étendue pourrait éventuellement retourner le premier résultat.

8

UNDECLARED_PARAMETER

Le résultat n'a pas pu être déterminé car le type de données d'une ou plusieurs des colonnes du jeu de résultats dépend potentiellement d'un paramètre non déclaré.

9

RECURSION

Le résultat n'a pas pu être déterminé car le lot contient une instruction récursive.

10

TEMPORARY_TABLE

Le résultat n'a pas pu être déterminé car le lot contient une table temporaire qui n'est pas prise en charge par sp_describe_first_result_set.

11

UNSUPPORTED_STATEMENT

Le résultat n'a pas pu être déterminé car le lot contient une instruction qui n'est pas prise en charge par sp_describe_first_result_set (par exemple, FETCH, REVERT etc.).

12

OBJECT_ID_NOT_SUPPORTED

L'identifiant @object_id passé à la fonction n'est pas pris en charge (autrement dit, il ne s'agit pas d'une procédure stockée)

13

OBJECT_ID_DOES_NOT_EXIST

L'identifiant @object_id passé à la fonction était introuvable dans le catalogue système.

Requiert l'autorisation d'exécuter l'argument @tsql.

L'exemple suivant crée une procédure stockée nommée TestProc2 qui retourne deux jeux de résultats. Puis l'exemple montre que sys.dm_exec_describe_first_result_set retourne les informations à propos du premier jeu de résultats dans la procédure, avec et sans les informations de navigation.

CREATE PROC TestProc2
AS
SELECT object_id, name FROM sys.objects ;
SELECT name, schema_id, create_date FROM sys.objects ;
GO

SELECT * FROM sys.dm_exec_describe_first_result_set_for_object(OBJECT_ID('TestProc2'), 0) ;
SELECT * FROM sys.dm_exec_describe_first_result_set_for_object(OBJECT_ID('TestProc2'), 1) ;
GO

L'exemple suivant utilise à la fois l'affichage catalogue système sys.procedures et la fonction sys.dm_exec_describe_first_result_set_for_object pour afficher des métadonnées pour les jeux de résultats de toutes les procédures stockées dans la base de données .

USE AdventureWorks2012;
GO

SELECT p.name, r.* 
FROM sys.procedures AS p
CROSS APPLY sys.dm_exec_describe_first_result_set_for_object(p.object_id, 0) AS r;
GO

Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.
Afficher:
© 2014 Microsoft