Création d'une application de pilote ODBC SQL Server Native Client
L'architecture ODBC possède quatre composants qui effectuent les fonctions ci-dessous.
Composant |
Fonction |
|---|---|
Application |
Appelle les fonctions ODBC pour communiquer avec une source de données ODBC, soumet les instructions SQL et traite les jeux de résultats. |
Gestionnaire de pilote |
Gère la communication entre une application et tous les pilotes ODBC utilisés par cette application. |
Pilote |
Traite tous les appels des fonctions ODBC à partir de l'application, se connecte à une source de données, passe les instructions SQL de l'application à la source de données et retourne les résultats à l'application. Si nécessaire, le pilote traduit des données ODBC SQL de l'application en données SQL natif utilisées par la source de données. |
Source de données |
Contient toutes les informations dont un pilote a besoin pour accéder à une instance spécifique des données dans un SGBD. |
Une application qui utilise le pilote ODBC SQL Server Native Client pour communiquer avec une instance de SQL Server effectue les tâches suivantes :
Elle se connecte à une source de données.
Elle envoie les instructions SQL à la source de données.
Elle traite les résultats des instructions provenant de la source de données.
Elle traite les erreurs et les messages.
Elle met un terme à la connexion à la source de données.
Une application plus complexe écrite pour le pilote ODBC SQL Server Native Client peut également effectuer les tâches suivantes :
Utiliser des curseurs pour contrôler l'emplacement dans un jeu de résultats
Demander des opérations de validation ou de restauration pour le contrôle des transactions
Effectuer des transactions distribuées qui impliquent deux serveurs ou plus
Exécuter des procédures stockées sur le serveur distant
Appeler des fonctions de catalogue pour obtenir des informations sur les attributs d'un jeu de résultats
Effectuer des opérations de copie en bloc
Gérer des opérations de données volumineuses (colonnes varchar(max), nvarchar(max) et varbinary(max))
Utiliser la logique de reconnexion pour faciliter le basculement lorsque la mise en miroir de bases de données est configurée
Enregistrer des données de performances et des requêtes longues
Pour effectuer des appels de fonction ODBC, une application C ou C++ doit inclure les fichiers d'en-tête sql.h, sqlext.h et sqltypes.h. Pour effectuer des appels aux fonctions API du programme d'installation ODBC, une application doit inclure le fichier d'en-tête odbcinst.h. Une application ODBC Unicode doit inclure le fichier d'en-tête sqlucode.h. Les applications ODBC doivent être liées au fichier odbc32.lib. Les applications ODBC qui appellent les fonctions API du programme d'installation ODBC doivent être liées au fichier odbccp32.lib. Ces fichiers sont inclus dans le Kit de développement Platform SDK de Windows.
De nombreux pilotes ODBC, y compris le pilote ODBC SQL Server Native Client, offrent des extensions ODBC spécifiques au pilote. Pour tirer parti des extensions spécifiques au pilote ODBC SQL Server Native Client, une application doit inclure le fichier d'en-tête sqlncli.h. Ce fichier d'en-tête contient :
Les attributs de connexion spécifiques au pilote ODBC SQL Server Native Client.
Les attributs d'instruction spécifiques au pilote ODBC SQL Server Native Client.
Les attributs de colonne spécifiques au pilote ODBC SQL Server Native Client.
Les types de données spécifiques à SQL Server.
Les types de données définis par l'utilisateur spécifiques à SQL Server.
Les types SQLGetInfo spécifiques au pilote ODBC SQL Server Native Client.
Les champs de diagnostic du pilote ODBC SQL Server Native Client.
Les codes de fonction dynamique de diagnostic spécifiques à SQL Server.
Les définitions de type C/C++ pour les types de données C natifs spécifiques à SQL Server (retournées lorsque les colonnes ont créé une liaison avec le type de données C SQL_C_BINARY).
Tapez la définition pour la structure de données SQLPERF.
Copiez en bloc les macros et les prototypes pour prendre en charge l'utilisation d'API de copie en bloc par le biais d'une connexion ODBC.
Appelez les fonctions API de métadonnées de requête distribuée pour obtenir les listes des serveurs liés et leurs catalogues.
Toute application ODBC C ou C++ qui utilise la fonctionnalité de copie en bloc du pilote ODBC SQL Server Native Client doit être liée au fichier sqlncli10.lib. Les applications qui appellent les fonctions API de métadonnées de requête distribuée doivent également être liées à sqlncli10.lib. Les fichiers sqlncli.h et sqlncli10.lib sont distribués dans le cadre des outils du développeur SQL Server. Les répertoires SQL Server Include et Lib doivent correspondre aux chemins d'accès INCLUDE et LIB du compilateur, comme suit :
LIB=c:\Program Files\Microsoft Data Access SDK 2.8\Libs\x86\lib;C:\Program Files\Microsoft SQL Server\100\Tools\SDK\Lib;
INCLUDE=c:\Program Files\Microsoft Data Access SDK 2.8\inc;C:\Program Files\Microsoft SQL Server\100\Tools\SDK\Include;
Une décision de conception à prendre tôt dans le processus de génération d'une application est de savoir si l'application doit avoir plusieurs appels ODBC en attente en même temps. Il existe deux méthodes de prise en charge des appels ODBC concurrents multiples ; elles sont décrites dans les autres rubriques de cette section. Pour plus d'informations, consultez le Guide de référence du programmeur ODBC.