sp_datatype_info (Transact-SQL)
S’applique à : SQL Server Azure Synapse Analytics
Retourne des informations sur les types de données pris en charge par l'environnement actuel.
Conventions de la syntaxe Transact-SQL
Syntaxe
sp_datatype_info
[ [ @data_type = ] data_type ]
[ , [ @ODBCVer = ] ODBCVer ]
[ ; ]
Arguments
[ @data_type = ] data_type
Numéro de code pour le type de données spécifié. @data_type est int, avec la valeur par défaut 0
. Pour obtenir une liste de tous les types de données, omettez ce paramètre.
[ @ODBCVer = ] ODBCVer
Version d’ODBC utilisée. @ODBCVer est tinyint, avec une valeur par défaut de 2
.
Valeurs des codes de retour
Aucune.
Jeu de résultats
Nom de la colonne | Type de données | Description |
---|---|---|
TYPE_NAME |
sysname | Type de données dépendant du SGBD (système de gestion de base de données) |
DATA_TYPE |
smallint | Code pour le type ODBC sur lequel toutes les colonnes de ce type sont mappées. |
PRECISION |
int | Précision maximale du type de données de la source de données. NULL est retourné pour les types de données pour lesquels la précision n’est pas applicable. La valeur de retour de la PRECISION colonne est en base 10. |
LITERAL_PREFIX |
varchar(32) | Caractères utilisés devant une constante. Par exemple, un guillemet unique (' ) pour les types de caractères et 0x pour le binaire. |
LITERAL_SUFFIX |
varchar(32) | Caractères utilisés pour terminer une constante. Par exemple, un guillemet unique (' ) pour les types de caractères et aucun guillemet pour le binaire. |
CREATE_PARAMS |
varchar(32) | Description des paramètres de création de ce type de données. Par exemple, la décimale est precision, scale , float est NULL , et varchar est max_length . |
NULLABLE |
smallint | Spécifie la possibilité de contenir une valeur NULL.1 = Autorise les valeurs Null.0 = N’autorise pas les valeurs Null. |
CASE_SENSITIVE |
smallint | Spécifie le respect de la casse.1 = Toutes les colonnes de ce type respectent la casse (pour les classements).0 = Toutes les colonnes de ce type ne respectent pas la casse. |
SEARCHABLE |
smallint | Spécifie la capacité de recherche du type de colonne :1 = Impossible de rechercher.2 = Pouvant faire l’objet d’une recherche avec LIKE.3 = Pouvant faire l’objet d’une recherche avec WHERE .4 = Pouvant faire l’objet d’une recherche avec WHERE ou LIKE . |
UNSIGNED_ATTRIBUTE |
smallint | Spécifie la signature du type de données.1 = Type de données non signé.0 = Type de données signé. |
MONEY |
smallint | Spécifie le type de données money.1 = type de données money .0 = Type de données money . |
AUTO_INCREMENT |
smallint | Spécifie l'auto-incrémentation.1 = Création automatique.0 = Pas de création automatique.NULL = Attribut non applicable Une application peut insérer des valeurs dans une colonne qui est cet attribut, mais l’application ne peut pas mettre à jour les valeurs de la colonne. À l’exception du type de données bit , AUTO_INCREMENT est valide uniquement pour les types de données appartenant aux catégories de types de données Numériques exacts et Numériques approximatifs. |
LOCAL_TYPE_NAME |
sysname | Version localisée du nom de type de données dépendant de la source de données. Par exemple, DECIMAL est DECIMALE en français. NULL est retourné si un nom localisé n’est pas pris en charge par la source de données. |
MINIMUM_SCALE |
smallint | Échelle minimale du type de données de la source de données. Si un type de données a une échelle fixe, les colonnes et MAXIMUM_SCALE les MINIMUM_SCALE deux contiennent cette valeur. NULL est retourné lorsque l’échelle n’est pas applicable. |
MAXIMUM_SCALE |
smallint | Échelle maximale du type de données de la source de données. Si l’échelle maximale n’est pas définie séparément sur la source de données, mais qu’elle est définie pour être identique à la précision maximale, cette colonne contient la même valeur que la PRECISION 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 d’intervalle datetime et ANSI. Ce champ retourne toujours une valeur. |
SQL_DATETIME_SUB |
smallint | sous-code d’intervalle datetime ou ANSI si la valeur est SQL_DATA_TYPE SQL_DATETIME ou SQL_INTERVAL . Pour les types de données autres que datetime et intervalle ANSI, ce champ est NULL . |
NUM_PREC_RADIX |
int | Le nombre de bits ou de chiffres pour le calcul du nombre maximal pouvant être contenu dans la colonne. Si le type de données est un type de données numérique approximatif, cette colonne contient la valeur 2 pour indiquer plusieurs bits. Pour les types numériques exacts, cette colonne contient la valeur 10 pour indiquer plusieurs chiffres décimaux. Sinon, cette colonne est NULL . En combinant la précision et la base, l'application peut calculer le nombre maximal que la colonne peut contenir. |
INTERVAL_PRECISION |
smallint | Valeur de la précision de début de l’intervalle si @data_type est intervalle ; sinon NULL . |
USERTYPE |
smallint | valeur usertype de la systypes table. |
Notes
sp_datatype_info
équivaut à SQLGetTypeInfo
ODBC. Les résultats retournés sont classés, DATA_TYPE
puis en fonction de la précision du type de données mappé au type de données ODBC SQL correspondant.
autorisations
Nécessite l'appartenance au rôle public .
Exemples
L’exemple suivant récupère des informations pour les types de données sysname et nvarchar en spécifiant la valeur @data_type de -9
.
USE master;
GO
EXEC sp_datatype_info -9;
GO