sp_sproc_columns (Transact-SQL)
Fournit des informations de colonne pour une fonction définie par l'utilisateur ou une procédure stockée unique dans l'environnement courant.
Syntaxe
sp_sproc_columns [[@procedure_name = ] 'name']
[ , [@procedure_owner = ] 'owner']
[ , [@procedure_qualifier = ] 'qualifier']
[ , [@column_name = ] 'column_name']
[ , [@ODBCVer = ] 'ODBCVer']
[ , [@fUsePattern = ] 'fUsePattern']
Arguments
[ @procedure_name = ] 'name'
Nom de la procédure utilisée pour retourner les informations du catalogue. L'argument name est de type nvarchar(390) et %, qui en est la valeur par défaut, représente toutes les tables de la base de données actuelle. La recherche de correspondance avec des caractères génériques est prise en charge.[ @procedure_owner =] 'owner'
Nom du propriétaire de la procédure. owner est de type nvarchar(384) et sa valeur par défaut est NULL. La recherche de correspondance avec des caractères génériques est prise en charge. Si owner n'est pas spécifié, les règles de visibilité de la procédure par défaut du SGDB sous-jacent 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 owner n'est pas spécifié et que l'utilisateur actuel ne possède pas de procédure du nom spécifié, sp_sproc_columns va rechercher une procédure portant le nom spécifié et 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 =] 'qualifier'
Nom du qualificateur de la procédure. qualifier est de type sysname. Sa valeur par défaut est NULL. Divers produits SGDB prennent en charge les noms de table en trois parties (qualifier.owner.name). Dans SQL Server, ce paramètre représente le nom de la base de données. Dans certains SGBD, elle représente le nom (au sens du serveur) de l'environnement de base de données de la table.[ @column_name =] 'column_name'
Colonne unique utilisée lorsqu'une seule colonne d'informations de catalogue est souhaitée. column_name est de type nvarchar(384), avec la valeur NULL par défaut. Si l'argument 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 de type int, avec 2 comme valeur par défaut, qui représente ODBC version 2.0. Pour plus d'informations sur la différence entre la version 2.0 et la version 3.0 d'ODBC, consultez la spécification ODBC SQLProcedureColumns pour ODBC version 3.0.[ @fUsePattern =] 'fUsePattern'
Détermine si le trait de soulignement (_), le signe de pourcentage (%) et les crochets ([ ]) sont interprétés en tant que caractères génériques. Les valeurs qui sont acceptées par l'expression sont 0 (la correspondance de modèle est désactivée) et 1 (la correspondance de modèle est activée). fUsePattern est de type bit, avec 1 comme valeur par défaut.
Valeurs des codes renvoyés
Aucun
Jeux de résultats
Nom de colonne |
Type de données |
Description |
---|---|---|
PROCEDURE_QUALIFIER |
sysname |
Nom de l'identificateur 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 de chacune des colonnes de TABLE_NAME renvoyées. Cette colonne renvoie toujours une valeur. |
COLUMN_TYPE |
smallint |
Ce champ renvoie 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 de type de données natif est renvoyé dans la colonne TYPE_NAME. |
TYPE_NAME |
sysname |
Représentation sous forme de chaîne du type de données. Nom du type de données, tel qu'il existe dans le SGBD sous-jacent. |
PRECISION |
int |
Nombre de chiffres significatifs. La valeur renvoyée pour la colonne PRECISION 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éé en autorisant des valeurs NULL. 0 = Les valeurs NULL ne sont pas autorisées. |
NOTES |
varchar(254) |
Description de la colonne de procédure. SQL Server ne renvoie 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 telle qu'elle apparaît dans le champ TYPE du descripteur. Cette colonne est la même que la colonne DATA_TYPE, excepté pour les types de données datetime et interval ISO. Cette colonne renvoie toujours une valeur. |
SQL_DATETIME_SUB |
smallint |
datetime ou sous-code interval ISO si la valeur de SQL_DATA_TYPE est SQL_DATETIME ou SQL_INTERVAL. Pour les types de données autres que datetime et interval ISO, ce champ prend la valeur NULL. |
CHAR_OCTET_LENGTH |
int |
Longueur maximale en octets d'une colonne de type de données character ou binary. Pour tous les autres types de données, cette colonne renvoie une valeur NULL. |
ORDINAL_POSITION |
int |
Numéro d'ordre de la colonne dans la table. La première colonne dans la table porte le numéro 1. Cette colonne renvoie toujours une valeur. |
IS_NULLABLE |
varchar(254) |
Possibilité de valeur nulle dans la colonne de la table. Les règles ISO sont utilisées pour déterminer la possibilité de valeur NULL. Un SGBD compatible avec la norme ISO ne peut pas renvoyer de chaîne vide. Affiche YES si la colonne peut comprendre des valeurs NULL et NO dans le cas contraire. Cette colonne renvoie une chaîne de longueur zéro si la possibilité de valeur NULL n'est pas connue. La valeur renvoyée pour cette colonne est différente de celle renvoyée pour la colonne NULLABLE. |
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 est équivalente à SQLProcedureColumns dans ODBC. Les résultats renvoyés sont triés par PROCEDURE_QUALIFIER, PROCEDURE_OWNER, PROCEDURE_NAME et l'ordre dans lequel les paramètres apparaissent dans la définition de la procédure.
Autorisations
Nécessite l'autorisation SELECT pour le schéma.