SQLProcedureColumns

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

SQLProcedureColumns retourne une ligne indiquant les attributs de valeur de retour de toutes les procédures stockées SQL Server.

SQLProcedureColumns retourne SQL_SUCCESS qu'il existe ou pas des valeurs pour les paramètres CatalogName, SchemaName, ProcNameou ColumnName . SQLFetch retourne SQL_NO_DATA lorsque des valeurs non valides sont utilisées dans ces paramètres.

SQLProcedureColumns peut être exécuté sur un curseur côté serveur statique. Une tentative d'exécution de SQLProcedureColumns sur un curseur pouvant être mis à jour (dynamique ou jeu de clés) retourne SQL_SUCCESS_WITH_INFO, ce qui indique que le type de curseur a été modifié.

Le tableau suivant répertorie les colonnes retournées par le jeu de résultats et la façon dont elles ont été étendues pour gérer les types de données udt et xml via le pilote ODBC SQL Server Native Client :

Nom de la colonne	Description
SS_UDT_CATALOG_NAME	Retourne le nom du catalogue contenant le type défini par l'utilisateur (UDT).
SS_UDT_SCHEMA_NAME	Retourne le nom du schéma contenant l'UDT.
SS_UDT_ASSEMBLY_TYPE_NAME	Retourne le nom qualifié de l'assembly du type défini par l'utilisateur (UDT).
SS_XML_SCHEMACOLLECTION_CATALOG_NAME	Retourne le nom du catalogue dans lequel un nom de collection de schémas XML est défini. Si le nom du catalogue est introuvable, cette variable contient une chaîne vide.
SS_XML_SCHEMACOLLECTION_SCHEMA_NAME	Retourne le nom du schéma dans lequel un nom de collection de schémas XML est défini. Si le nom du schéma est introuvable, cette variable contient une chaîne vide.
SS_XML_SCHEMACOLLECTION_NAME	Retourne le nom d'une collection de schémas XML. Si le nom est introuvable, cette variable contient une chaîne vide.

SQLProcedureColumns et paramètres table

SQLProcedureColumns gère les paramètres table d’une manière similaire aux types CLR définis par l’utilisateur. Dans les lignes retournées pour les paramètres table, les colonnes ont les valeurs suivantes :

Nom de la colonne	Description/valeur
DATA_TYPE	SQL_SS_TABLE
TYPE_NAME	Nom du type de table pour le paramètre table.
COLUMN_SIZE	NULL
BUFFER_LENGTH	0
DECIMAL_DIGITS	Nombre de colonnes du paramètre table.
NUM_PREC_RADIX	NULL
NULLABLE	SQL_NULLABLE
Remarques	NULL
COLUMN_DEF	NULL. Les types table ne peuvent pas avoir de valeurs par défaut.
SQL_DATA_TYPE	SQL_SS_TABLE
SQL_DATEIME_SUB	NULL
CHAR_OCTET_LENGTH	NULL
IS_NULLABLE	"YES"
SS_TYPE_CATALOG_NAME	Retourne le nom du catalogue qui contient la table ou le type CLR défini par l'utilisateur.
SS_TYPE_SCHEMA_NAME	Retourne le nom du schéma qui contient la table ou le type CLR défini par l'utilisateur.

Les colonnes SS_TYPE_CATALOG_NAME et SS_TYPE_SCHEMA_NAME sont disponibles dans SQL Server 2008 (10.0.x) et les versions ultérieures pour retourner respectivement le catalogue et le schéma pour les paramètres table. Ces colonnes sont remplies pour les paramètres table, et également pour les paramètres de type CLR défini par l'utilisateur. (Les colonnes de schéma et de catalogue existantes pour les paramètres de type CLR définis par l’utilisateur ne sont pas affectées par cette fonctionnalité supplémentaire. Elles sont également remplies pour maintenir la compatibilité descendante).

Conformément à la spécification ODBC, les SS_TYPE_CATALOG_NAME et les SS_TYPE_SCHEMA_NAME s’affichent devant toutes les colonnes spécifiques au pilote ajoutées dans les versions précédentes de SQL Server, et après toutes les colonnes mandatées par ODBC lui-même.

Pour plus d’informations sur les paramètres table, consultez Paramètres table (ODBC).

Prise en charge par SQLProcedureColumns des fonctionnalités de date et heure améliorées

Pour les valeurs retournées pour les types de date/heure, consultez Catalog Metadata.

Pour plus d’informations générales, consultez Améliorations de date et d’heure (ODBC).

Prise en charge par SQLProcedureColumns des grands types CLR définis par l'utilisateur

SQLProcedureColumns prend en charge les grands types CLR définis par l'utilisateur. Pour plus d’informations, consultez Grands types de User-Defined CLR (ODBC).

Voir aussi

Fonction SQLProcedureColumns
Détails de l’implémentation d’API ODBC