SQLProcedureColumns
S’applique à :
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
SQLProcedureColumns retourne une ligne signalant 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 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 versions ultérieures pour retourner le catalogue et le schéma, respectivement, 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 défini par l’utilisateur CLR 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, SS_TYPE_CATALOG_NAME et SS_TYPE_SCHEMA_NAME apparaissent avant que toutes les colonnes spécifiques au pilote soient 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 Les types CLR définis par l’utilisateur (ODBC) volumineux.
Voir aussi
SQLProcedureColumns, fonction
Détails de l’implémentation d’API ODBC