SQLConfigDataSource (pilote Access)

Notes

Cette rubrique fournit des informations spécifiques au pilote d’accès. Pour obtenir des informations générales sur cette fonction, consultez la rubrique appropriée sous Référence de l’API ODBC.

La fonction SQLConfigDataSource utilisée pour ajouter, modifier ou supprimer une source de données dynamiquement utilise les mots clés suivants.

Mot clé	Description
COLLATINGSEQUENCE	Séquence dans laquelle les champs sont triés. Cette opération définit la même option que la séquence de classement dans la boîte de dialogue d’installation.
COMPACT_DB	Effectue le compactage des données sur un fichier de base de données. A le format suivant : COMPACT_DB=<path_name><optionaL_sort_order><mot clé> ENCRYPT facultatif. Lorsque vous utilisez le COMPACT_DB mot clé dans la même instruction avec un mot clé DSN, ce pilote ignore le mot clé DSN. Par conséquent, le compactage d’une base de données et la spécification d’un DSN sont un processus en deux étapes.
CREATE_DB	Crée un fichier de base de données. A le format suivant : CREATE_DB=<path_name><optional_ENCRYPT mot clé d’ordre><optional_sort>, où le nom du chemin d’accès est le chemin d’accès complet à une base de données Microsoft Access. Une erreur est retournée si le nom du chemin d’accès spécifie une base de données existante. L’ordre de tri est défini dans la boîte de dialogue Nouvelle base de données affichée lorsque vous appuyez sur le bouton Créer dans la boîte de dialogue Configuration de Microsoft Access. Si aucun ordre de tri n’est spécifié, Général est utilisé. Lorsque vous utilisez le CREATE_DB mot clé dans la même instruction avec un mot clé DSN, ce pilote ignore le mot clé DSN. Par conséquent, la création d’une base de données et la spécification d’un DSN sont un processus en deux étapes. Lorsque vous utilisez le CREATE_DB mot clé, si le chemin d’accès de la base de données Microsoft Access à créer contient un ou plusieurs espaces, le nom de chemin entier doit être entouré de guillemets doubles, comme illustré dans les exemples suivants : « C :\PROGRAM FILES\COMMON FILES\ MyAccess.mdb » « C :\PROGRAM FILES\Access2.mdb » CREATE_DB=C :\TEMP\test.mdb (aucun guillemet nécessaire)
CREATE_SYSDB	Crée un fichier de base de données système. A le format suivant : CREATE_SYSDB=<path-name><optional-sort-order>, où le nom du chemin d’accès est le chemin complet d’une base de données Microsoft Access. Une erreur est retournée si le nom du chemin d’accès spécifie une base de données existante. L’ordre de tri est défini dans la boîte de dialogue Nouvelle base de données affichée lorsque vous cliquez sur le bouton Créer dans la boîte de dialogue Configuration ODBC Microsoft Access . Si aucun ordre de tri n’est spécifié, Général est utilisé.
CREATE_V2DB	Crée un fichier de base de données compatible avec Microsoft Access 2.0. A le format suivant : CREATE_V2DB=<path-name><optional-sort-order>, où le nom du chemin est le chemin complet d’une base de données Microsoft Access. Une erreur est retournée si le nom du chemin d’accès spécifie une base de données existante. L’ordre de tri est défini dans la boîte de dialogue Nouvelle base de données affichée lorsque vous appuyez sur le bouton Créer dans la boîte de dialogue Configuration de Microsoft Access. Si aucun ordre de tri n’est spécifié, Général est utilisé. Lorsque vous utilisez le CREATE_V2DB mot clé dans la même instruction avec un mot clé DSN, ce pilote ignore le mot clé DSN. Par conséquent, la création d’une base de données et la spécification d’un DSN sont un processus en deux étapes. Lorsque vous utilisez le CREATE_V2DB mot clé, si le chemin d’accès de la base de données Microsoft Access à créer contient un ou plusieurs espaces, le nom de chemin entier doit être entouré de guillemets doubles, comme illustré dans les exemples suivants : « C :\PROGRAM FILES\COMMON FILES\ MyAccess.mdb » « C :\PROGRAM FILES\Access2.mdb » CREATE_V2DB=C :\TEMP\test.mdb (aucun guillemet nécessaire)
DBQ	Nom du fichier de base de données. Cela définit la même option que la base de données dans la boîte de dialogue d’installation.
DEFAULTDIR	Spécification du chemin d’accès au fichier de base de données.
Description	Description des données dans la source de données. Cette opération définit la même option que Description dans la boîte de dialogue d’installation.
DRIVER	Spécification du chemin d’accès à la DLL du pilote.
DRIVERID	ID entier du pilote. 25 (Microsoft Access)
FIL	Type de fichier MS Access pour Microsoft Access
IMPLICITCOMMITSYNC	Détermine si le pilote Microsoft Access effectue des validations internes ou implicites de manière asynchrone. Cette valeur est initialement définie sur « Oui », ce qui signifie que le pilote Microsoft Access attend que les validations dans une transaction interne/implicite soient terminées. La valeur de cette option ne doit pas être modifiée sans un examen attentif des conséquences. Pour plus d’informations sur l’option, consultez le Guide du programmeur du moteur de base de données Microsoft Jet. Cela définit la même option que ImplicitCommitSync dans la boîte de dialogue d’installation.
MAXBUFFERSIZE	Taille de la mémoire tampon interne, en kilo-octets, utilisée par Microsoft Access pour transférer des données vers et depuis le disque. La taille de mémoire tampon par défaut est de 2 048 Ko (affichée sous la forme 2048). Toute valeur entière divisible par 256 peut être utilisée. Cette opération définit la même option que la taille de la mémoire tampon dans la boîte de dialogue d’installation.
MAXSCANROWS	Nombre de lignes à analyser lors de la définition du type de données d’une colonne en fonction des données existantes. Vous pouvez entrer un nombre compris entre 1 et 16 pour les lignes à analyser. La valeur par défaut est 8 ; si elle est définie sur 0, toutes les lignes sont analysées. (Un nombre en dehors de la limite renvoie une erreur.) Cela définit la même option que Lignes à analyser dans la boîte de dialogue d’installation.
PAGETIMEOUT	Spécifie la période de temps, en millisecondes, pendant laquelle une page (si elle n’est pas utilisée) reste dans la mémoire tampon avant d’être supprimée. La valeur par défaut est de cinq dixièmes de seconde (0,5 seconde). Notez que cette option s’applique à toutes les sources de données qui utilisent le pilote ODBC. Cette opération définit la même option que délai d’expiration de la page dans la boîte de dialogue d’installation.
PWD	Mot de passe.
READONLY	TRUE pour rendre le fichier en lecture seule ; FALSE pour que le fichier ne soit pas en lecture seule. Cette opération définit la même option en lecture seule dans la boîte de dialogue d’installation.
REPAIR_DB	Répare une base de données endommagée par une défaillance qui se produit pendant le processus de validation. Lorsque vous utilisez le REPAIR_DB mot clé dans la même instruction avec un mot clé DSN, ce pilote ignore le mot clé DSN. Par conséquent, la réparation d’une base de données et la spécification d’un DSN sont un processus en deux étapes.
SYSTEMDB	Pour le pilote Microsoft Access, spécification du chemin d’accès au fichier de base de données système. Cette opération définit la même option que la base de données système dans la boîte de dialogue d’installation.
FILS	Nombre de threads d’arrière-plan que le moteur doit utiliser. Cette valeur par défaut est 3, mais peut être modifiée. Cette opération définit la même option que Threads dans la boîte de dialogue d’installation.
Identificateur d’utilisateur	Pour le pilote Microsoft Access, nom d’ID utilisateur utilisé pour la connexion.
USERCOMMITSYNC	Détermine si le pilote Microsoft Access effectue des transactions définies par l’utilisateur de manière asynchrone. Cette valeur est initialement définie sur « Oui », ce qui signifie que le pilote Microsoft Access attend que les validations dans une transaction définie par l’utilisateur soient terminées. La valeur de cette option ne doit pas être modifiée sans un examen attentif des conséquences. Pour plus d’informations sur l’option, consultez le Guide du programmeur du moteur de base de données Microsoft Jet. Cela définit la même option que UserCommitSync dans la boîte de dialogue d’installation.