Partager via


Ensemble de lignes de schéma DBSCHEMA_PROVIDER_TYPES

Identifie les types de données (de base) pris en charge par le fournisseur de données.

Colonnes de l'ensemble de lignes

L'ensemble de lignes DBSCHEMA_PROVIDER_TYPES contient les colonnes suivantes.

Nom de colonne

Indicateur de type

Longueur

Description

TYPE_NAME

DBTYPE_WSTR

Nom du type de données spécifique au fournisseur.

DATA_TYPE

DBTYPE_UI2

Indicateur du type de données.

COLUMN_SIZE

DBTYPE_UI4

Longueur d'un paramètre ou d'une colonne non numérique qui fait référence soit à la longueur maximale soit à la longueur définie pour ce type par le fournisseur. Pour les données de type caractère, il s'agit de la longueur maximale ou de la longueur définie en nombre de caractères. Pour les données de type DateTime, il s'agit de la longueur de la représentation de chaîne (en supposant la précision maximale autorisée pour le composant fractions de secondes).

Si les données sont de type numérique, il s'agit de la limite supérieure de la précision maximale du type de données.

LITERAL_PREFIX

DBTYPE_WSTR

Caractère(s) utilisé(s) comme préfixe pour un littéral de ce type dans une commande de texte.

LITERAL_SUFFIX

DBTYPE_WSTR

Caractère(s) utilisé(s) comme suffixe pour un littéral de ce type dans une commande de texte.

CREATE_PARAMS

DBTYPE_WSTR

Paramètres de création spécifiés par l'utilisateur lors de la création d'une colonne de ce type de données. Par exemple, le type de données SQL, DECIMAL, requiert une précision et une échelle. Dans ce cas, les paramètres de création peuvent être la chaîne "précision, échelle". Dans une commande de texte pour créer une colonne DECIMAL avec une précision de 10 et une échelle de 2, la valeur de la colonne TYPE_NAME pourrait être DECIMAL() et la spécification de type complète serait DECIMAL(10,2).

Les paramètres de création apparaissent sous la forme d'une liste de valeurs séparées par des virgules, dans l'ordre où elles sont fournies et sans parenthèses. Si un paramètre de création est longueur, longueur maximale, précision, échelle, valeur de départ ou incrément, utilisez "length", "max length", "precision", "scale", "seed" et "increment", respectivement. Si le paramètre de création est une autre valeur, le fournisseur détermine quel texte sera utilisé pour décrire le paramètre de création.

Si le type de données requiert des paramètres de création, "()" apparaît généralement dans le nom de type. Cela indique la position à laquelle insérer les paramètres de création. Si le nom de type n'inclut pas "()", les paramètres de création sont placés entre parenthèses et ajoutés au nom du type de données.

IS_NULLABLE

DBTYPE_BOOL

Valeur booléenne qui indique si le type de données autorise la valeur Null.

VARIANT_TRUE indique que le type de données autorise la valeur Null.

VARIANT_FALSE indique que le type de données n'autorise pas la valeur Null.

NULL indique que le fait que le type de données autorise ou non la valeur Null n'est pas connu.

CASE_SENSITIVE

DBTYPE_BOOL

Valeur booléenne qui indique si le type de données est de type caractère et s'il respecte la casse.

VARIANT_TRUE indique que les données sont de type caractère et qu'elles respectent la casse.

VARIANT_FALSE indique que les données ne sont pas de type caractère ou qu'elles ne respectent pas la casse.

SEARCHABLE

DBTYPE_UI4

Entier qui indique comment le type de données peut être utilisé dans les recherches si le fournisseur prend en charge ICommandText ; sinon, NULL.

Les valeurs possibles pour cette colonne sont les suivantes :

  • DB_UNSEARCHABLE indique que le type de données ne peut pas être utilisé dans une clause WHERE.

  • DB_LIKE_ONLY indique que le type de données peut être utilisé dans une clause WHERE, avec le prédicat LIKE uniquement.

  • DB_ALL_EXCEPT_LIKE indique que le type de données peut être utilisé dans une clause WHERE, avec tous les opérateurs de comparaison à l'exception de LIKE.

  • DB_SEARCHABLE indique que le type de données peut être utilisé dans une clause WHERE avec n'importe quel opérateur de comparaison.

UNSIGNED_ATTRIBUTE

DBTYPE_BOOL

Valeur booléenne qui indique si le type de données est non signé.

VARIANT_TRUE indique que le type de données est non signé.

VARIANT_FALSE indique que le type de données est signé.

NULL indique que ce paramètre n'est pas applicable à ce type de données.

FIXED_PREC_SCALE

DBTYPE_BOOL

Valeur booléenne qui indique si le type de données a une précision fixe et une échelle.

VARIANT_TRUE indique que le type de données a une précision fixe et une échelle.

VARIANT_FALSE indique que le type de données n'a pas une précision fixe et une échelle.

AUTO_UNIQUE_VALUE

DBTYPE_BOOL

Valeur booléenne qui indique si le type de données est à auto-incrémentation.

VARIANT_TRUE indique que les valeurs de ce type peuvent être incrémentées automatiquement.

VARIANT_FALSE indique que les valeurs de ce type ne peuvent pas être incrémentées automatiquement.

Si cette valeur est VARIANT_TRUE, le fait qu'une colonne de ce type soit toujours incrémentée automatiquement dépend de la propriété de colonne DBPROP_COL_AUTOINCREMENT du fournisseur. Si la propriété DBPROP_COL_AUTOINCREMENT est en lecture/écriture, le fait qu'une colonne de ce type soit ou non incrémentée automatiquement dépend du paramètre de la propriété DBPROP_COL_AUTOINCREMENT. Si DBPROP_COL_AUTOINCREMENT est une propriété en lecture seule, soit la totalité soit aucune des colonnes de ce type ne seront incrémentées automatiquement.

LOCAL_TYPE_NAME

DBTYPE_WSTR

La version localisée de TYPE_NAME. NULLest retournée si un nom localisé n'est pas pris en charge par le fournisseur de données.

MINIMUM_SCALE

DBTYPE_I2

Si l'indicateur de type est DBTYPE_VARNUMERIC, DBTYPE_DECIMAL ou DBTYPE_NUMERIC, nombre minimal de chiffres autorisés à droite de la virgule décimale. Sinon, NULL.

MAXIMUM_SCALE

DBTYPE_I2

Nombre maximal de chiffres autorisés à droite de la virgule décimale si l'indicateur de type est DBTYPE_VARNUMERIC, DBTYPE_DECIMAL ou DBTYPE_NUMERIC ; sinon, NULL.

GUID

DBTYPE_GUID

(Destiné à une utilisation ultérieure) GUID du type, si le type est décrit dans une bibliothèque de types. Sinon, NULL.

TYPELIB

DBTYPE_WSTR

(Destiné à une utilisation ultérieure) Bibliothèque de types contenant la description du type, s'il est décrit dans une bibliothèque de types. Sinon, NULL.

VERSION

DBTYPE_WSTR

(Destiné à une utilisation ultérieure) Version de la définition du type. Les fournisseurs peuvent attribuer des versions aux définitions de type. Des fournisseurs différents peuvent utiliser des méthodes de suivi des versions différentes, par exemple un horodateur ou un nombre (entier ou flottant). NULL si ce paramètre n'est pas pris en charge.

IS_LONG

DBTYPE_BOOL

Valeur booléenne qui indique si le type de données est un objet blob qui comporte des données très longues.

VARIANT_TRUE indique que le type de données est un BLOB qui contient des données très longues ; la définition de données très longues est spécifique au fournisseur.

VARIANT_FALSE indique que le type de données n'est pas un BLOB comportant des données très longues ou un BLOB.

Cette valeur détermine le paramètre de l'indicateur DBCOLUMNFLAGS_ISLONG retourné par GetColumnInfo dans IColumnsInfo et GetParameterInfo dans ICommandWithParameters.

BEST_MATCH

DBTYPE_BOOL

Valeur booléenne qui indique si le type de données est une correspondance la plus proche.

VARIANT_TRUE indique que le type de données est la correspondance la plus proche entre tous les types de données du magasin de données et le type de données OLE DB indiqué par la valeur de la colonne DATA_TYPE.

VARIANT_FALSE indique que le type de données n'est pas la correspondance la plus proche.

Pour chaque ensemble de lignes dans lequel la valeur de la colonne DATA_TYPE est identique, la colonne BEST_MATCH n'a la valeur VARIANT_TRUE que dans une seule ligne.

IS_FIXEDLENGTH

DBTYPE_BOOL

Valeur booléenne qui indique si la colonne a une longueur fixe.

VARIANT_TRUE indique que les colonnes de ce type créées par le langage de définition de données (DDL) seront de longueur fixe.

VARIANT_FALSE indique que les colonnes de ce type créées par le DDL seront de longueur variable.

Si le champ est NULL, le fait que le fournisseur mappe ce champ avec une colonne de longueur fixe ou de longueur variable n'est pas connu.

L'ensemble de lignes est trié selon DATA_TYPE.

Colonnes de restriction

L'ensemble de lignes DBSCHEMA_PROVIDER_TYPES peut être restreint sur les colonnes répertoriées dans le tableau suivant.

Nom de la colonne

Indicateur de type

État de la restriction

DATA_TYPE

DBTYPE_UI2

BEST_MATCH

DBTYPE_BOOL

Voir aussi

Référence

Ensembles de lignes des schémas OLE DB