sp_sproc_columns (Transact-SQL)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Point de terminaison analytique SQL dans Microsoft FabricEntrepôt dans Microsoft Fabric

Fournit des informations de colonne pour une fonction définie par l'utilisateur ou une procédure stockée unique dans l'environnement courant.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_sproc_columns
    [ [ @procedure_name = ] N'procedure_name' ]
    [ , [ @procedure_owner = ] N'procedure_owner' ]
    [ , [ @procedure_qualifier = ] N'procedure_qualifier' ]
    [ , [ @column_name = ] N'column_name' ]
    [ , [ @ODBCVer = ] ODBCVer ]
    [ , [ @fUsePattern = ] fUsePattern ]
[ ; ]

Arguments

[ @procedure_name = ] N’procedure_name'

Nom de la procédure utilisée pour retourner les informations du catalogue. @procedure_name est nvarchar(390), avec une valeur par défaut %, ce qui signifie que toutes les tables de la base de données active. La recherche de correspondance avec des caractères génériques est prise en charge.

[ @procedure_owner = ] N’procedure_owner'

Nom du propriétaire de la procédure. @procedure_owner est nvarchar(384), avec la valeur par défaut NULL. La recherche de correspondance avec des caractères génériques est prise en charge. Si @procedure_owner n’est pas spécifié, les règles de visibilité de procédure par défaut du système de gestion de base de données sous-jacent (SGBD) s’appliquent.

Si l'utilisateur actuel possède une procédure du nom spécifié, les informations relatives à cette procédure sont retournées. Si @procedure_owner n’est pas spécifié et que l’utilisateur actuel ne possède pas de procédure portant le nom spécifié, sp_sproc_columns recherche une procédure portant le nom spécifié appartenant au propriétaire de la base de données. Si la procédure existe, les informations relatives à ses colonnes sont renvoyées.

[ @procedure_qualifier = ] N’procedure_qualifier'

Nom du qualificateur de procédure. @procedure_qualifier est sysname, avec la valeur par défaut NULL. Différents produits SGBD prennent en charge le nommage en trois parties pour les tables (<qualifier>.<owner>.<name>). Dans SQL Server, ce paramètre représente le nom de la base de données. Dans d'autres produits, elle représente le nom du serveur de l'environnement de base de données de la table.

[ @column_name = ] N’column_name'

Une seule colonne est utilisée quand une seule colonne d’informations de catalogue est souhaitée. @column_name est nvarchar(384), avec la valeur par défaut NULL. Si @column_name est omis, toutes les colonnes sont retournées. La recherche de correspondance avec des caractères génériques est prise en charge. Pour assurer une interopérabilité maximale, le client de la passerelle ne doit utiliser que les modèles de comparaison standard ISO (caractères génériques % et _).

[ @ODBCVer = ] ODBCVer

Version d’ODBC utilisée. @ODBCVer est int, avec une valeur par défaut 2, qui indique ODBC version 2.0. Pour plus d’informations sur les différences entre ODBC version 2.0 et ODBC version 3.0, consultez la spécification ODBC SQLProcedureColumns pour ODBC version 3.0.

[ @fUsePattern = ] fUsePattern

Détermine si les caractères de soulignement (_), de pourcentage (%) et de crochet ([et]) sont interprétés comme génériques carte caractères. @fUsePattern est bit, avec la valeur par défaut 1. Les valeurs valides sont 0 (la mise en correspondance des modèles est désactivée) et 1 (la mise en correspondance des modèles est activée).

Valeurs des codes de retour

Aucune.

Jeu de résultats

Nom de la colonne Type de données Description
PROCEDURE_QUALIFIER sysname Nom du qualificateur de procédure. Cette colonne peut être NULL.
PROCEDURE_OWNER sysname Nom du propriétaire de la procédure. Cette colonne renvoie toujours une valeur.
PROCEDURE_NAME nvarchar(134) Nom de la procédure. Cette colonne renvoie toujours une valeur.
COLUMN_NAME sysname Nom de colonne pour chaque colonne du TABLE_NAME retour. Cette colonne renvoie toujours une valeur.
COLUMN_TYPE smallint Ce champ retourne toujours une valeur :

0 = SQL_PARAM_TYPE_UNKNOWN
1 = SQL_PARAM_TYPE_INPUT
2 = SQL_PARAM_TYPE_OUTPUT
3 = SQL_RESULT_COL
4 = SQL_PARAM_OUTPUT
5 = SQL_RETURN_VALUE
DATA_TYPE smallint Code entier d'un type de données ODBC. Si ce type de données ne peut pas être mappé à un type ISO, la valeur est NULL. Le nom du type de données natif est retourné dans la TYPE_NAME colonne.
TYPE_NAME sysname Représentation sous forme de chaîne du type de données. Cette valeur est le nom du type de données tel qu’il est présenté par le SGBD sous-jacent.
PRECISION int Nombre de chiffres significatifs. La valeur de retour de la PRECISION colonne est en base 10.
LENGTH int Taille de transfert des données.
SCALE smallint Nombre de chiffres situés à droite du séparateur décimal.
RADIX smallint Base des types numériques.
NULLABLE smallint Précise la possibilité de valeur nulle.

1 = Le type de données peut être créé autorisant les valeurs Null.
0 = Les valeurs Null ne sont pas autorisées.
REMARKS varchar(254) Description de la colonne de procédure. SQL Server ne retourne pas de valeur pour cette colonne.
COLUMN_DEF nvarchar(4000) Valeur par défaut de la colonne.
SQL_DATA_TYPE smallint Valeur du type de données SQL tel qu’il apparaît dans le TYPE champ du descripteur. Cette colonne est identique à la DATA_TYPE colonne, à l’exception des types de données datetime et ISO. Cette colonne renvoie toujours une valeur.
SQL_DATETIME_SUB smallint Sous-code d’intervalle ISO datetime si la valeur est SQL_DATETIMESQL_DATA_TYPE ou SQL_INTERVAL. Pour les types de données autres que datetime et intervalle ISO, ce champ est NULL.
CHAR_OCTET_LENGTH int Longueur maximale en octets d’une colonne de type de données caractères ou binaires . Pour tous les autres types de données, cette colonne retourne un NULL.
ORDINAL_POSITION int Numéro d'ordre de la colonne dans la table. La première colonne de la table est 1. Cette colonne renvoie toujours une valeur.
IS_NULLABLE varchar(254) Possibilité de valeurs NULL dans la colonne de la table. Les règles ISO sont utilisées pour déterminer la possibilité de valeur Null. Un SGBD conforme ISO ne peut pas retourner une chaîne vide.

Affiche YES si la colonne peut inclure des valeurs Null et NO si la colonne ne peut pas inclure de valeurs Null.

Cette colonne renvoie une chaîne de longueur zéro si la possibilité de valeurs Null n'est pas connue.

La valeur retournée pour cette colonne est différente de la valeur retournée pour la NULLABLE colonne.
SS_DATA_TYPE tinyint Type de données SQL Server utilisé par les procédures stockées étendues. Pour plus d’informations, consultez Types de données (Transact-SQL)

Notes

sp_sproc_columns équivaut à SQLProcedureColumns ODBC. Les résultats retournés sont classés par PROCEDURE_QUALIFIER, PROCEDURE_OWNERet PROCEDURE_NAMEl’ordre dans lequel les paramètres apparaissent dans la définition de procédure.

Autorisations

Nécessite l’autorisation SELECT sur le schéma.

Contenu connexe