Partager via

Fonctions ODBC et bibliothèque de curseurs

s’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Important

Cette fonctionnalité sera supprimée dans une prochaine version de Windows. Évitez d’utiliser cette fonctionnalité dans le nouveau travail de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Microsoft recommande d’utiliser la fonctionnalité de curseur du pilote.

La bibliothèque de curseurs ODBC fournit la prise en charge des curseurs à défilement pour les pilotes ODBC 2.x qui prennent uniquement en charge les curseurs vers l’avant uniquement. Lorsque vous activez la bibliothèque de curseurs pour une connexion, le Gestionnaire de pilotes intercepte les appels de fonction et les route via la bibliothèque de curseurs plutôt que directement vers le pilote. La bibliothèque de curseurs exécute la fonction elle-même ou la transmet au pilote sous-jacent.

Fonctions exécutées par la bibliothèque de curseurs

Ces articles décrivent les fonctions ODBC que la bibliothèque de curseurs gère et qu’elle passe au pilote.

Article Descriptif
Fonctions ODBC exécutées par la bibliothèque de curseurs Répertorie les fonctions que la bibliothèque de curseurs implémente elle-même pour fournir des fonctionnalités de curseur pouvant faire défiler le curseur.
Fonctions ODBC non exécutées par la bibliothèque de curseurs Répertorie les fonctions que la bibliothèque de curseurs transmet au pilote sans modification.

Liaison de colonne et de paramètre

Ces fonctions gèrent les mémoires tampons d’application de liaison pour les colonnes de jeu de résultats et les paramètres d’instruction. La bibliothèque de curseurs modifie son comportement pour prendre en charge les mises à jour positionnées et les curseurs de bloc.

Fonction Descriptif
SQLBindCol (bibliothèque de curseurs) Lie les mémoires tampons d’application aux colonnes du jeu de résultats. La bibliothèque de curseurs suit les liaisons pour prendre en charge les opérations de mise à jour et de suppression positionnées.
SQLBindParameter (bibliothèque de curseurs) Lie les mémoires tampons d’application aux marqueurs de paramètres. La bibliothèque de curseurs transmet cet appel au pilote.

Opérations en bloc et positionnées

Ces fonctions effectuent des opérations en bloc sur les ensembles de lignes et positionnent les mises à jour sur des lignes individuelles au sein de l’ensemble de lignes actuel d’un curseur.

Fonction Descriptif
SQLBulkOperations (bibliothèque de curseurs) Effectue l’insertion, la mise à jour, la suppression ou la récupération en bloc par les opérations de signet. La bibliothèque de curseurs mappe ceci SQLSetPos lors de l’utilisation des pilotes ODBC 2.x.
SQLSetPos (bibliothèque de curseurs) Positionne le curseur dans un ensemble de lignes et permet aux applications d’actualiser, de mettre à jour ou de supprimer des données dans l’ensemble de lignes.

Gestion des curseurs et transactions

Ces fonctions gèrent la durée de vie des curseurs et les limites de transaction.

Fonction Descriptif
SQLCloseCursor (bibliothèque de curseurs) Ferme un curseur sur une instruction et ignore les résultats en attente.
SQLEndTran (bibliothèque de curseurs) Valide ou restaure une transaction. La bibliothèque de curseurs gère l’état du curseur au-delà des limites de transaction en fonction des paramètres et SQL_CURSOR_ROLLBACK_BEHAVIOR des SQL_CURSOR_COMMIT_BEHAVIOR paramètres.
SQLFreeStmt (bibliothèque de curseurs) Arrête le traitement des instructions, ferme tout curseur associé, ignore les résultats en attente et libère éventuellement toutes les ressources associées au handle d’instruction.

Récupération des données

Ces fonctions extraient les données des jeux de résultats. La bibliothèque de curseurs fournit des fonctionnalités de curseur défilables pour les pilotes qui prennent uniquement en charge les curseurs vers l’avant uniquement.

Fonction Descriptif
SQLFetch (bibliothèque de curseurs) Récupère l’ensemble de lignes suivant des données du jeu de résultats. Lorsque vous utilisez des pilotes ODBC 2.x, la bibliothèque de curseurs mappe cette valeur à SQLExtendedFetch.
SQLFetchScroll (bibliothèque de curseurs) Récupère l’ensemble de lignes spécifié de données à partir du jeu de résultats et retourne des données pour toutes les colonnes liées. Prend en charge différentes directions de défilement, notamment le premier, le dernier, le suivant, l’avant, l’absolu et le positionnement relatif.
SQLExtendedFetch (bibliothèque de curseurs) Récupère l’ensemble de lignes spécifié à partir du jeu de résultats. Cette fonction est déconseillée dans ODBC 3.x ; utilisez SQLFetchScroll à la place.
SQLGetData (bibliothèque de curseurs) Récupère les données d’une seule colonne dans le jeu de résultats après SQLFetch ou SQLFetchScroll a été appelée.

Opérations de descripteur

Ces fonctions obtiennent et définissent des valeurs de champ de descripteur. Les descripteurs définissent les attributs des paramètres et des colonnes du jeu de résultats.

Fonction Descriptif
SQLGetDescField et SQLGetDescRec (bibliothèque de curseurs) Récupérez des valeurs de champ individuelles ou des enregistrements de descripteur complets. La bibliothèque de curseurs les gère pour ses descripteurs internes.
SQLSetDescField et SQLSetDescRec (bibliothèque de curseurs) Définissez des valeurs de champ individuelles ou des enregistrements de descripteur complets. La bibliothèque de curseurs suit les modifications apportées aux champs de descripteur.

Requêtes de capacité de pilote

Ces fonctions retournent des informations sur les fonctionnalités de la bibliothèque de pilotes et de curseurs.

Fonction Descriptif
SQLGetFunctions (bibliothèque de curseurs) Retourne des informations sur les fonctions ODBC que le pilote prend en charge. La bibliothèque de curseurs modifie la réponse pour inclure les fonctions qu’elle implémente.
SQLGetInfo (bibliothèque de curseurs) Retourne des informations générales sur le pilote et la source de données. La bibliothèque de curseurs modifie certains types d’informations liés au curseur pour refléter ses fonctionnalités.

Attributs d’instruction et de connexion

Ces fonctions obtiennent et définissent des attributs d’instruction, de connexion et d’environnement qui affectent le comportement du curseur.

Fonction Descriptif
SQLGetStmtAttr (bibliothèque de curseurs) Retourne la valeur actuelle d’un attribut d’instruction. La bibliothèque de curseurs gère les attributs liés au comportement du curseur.
SQLGetStmtOption (bibliothèque de curseurs) Retourne les valeurs d’option d’instruction. Cette fonction est déconseillée dans ODBC 3.x ; utilisez SQLGetStmtAttr à la place.
SQLSetStmtAttr (bibliothèque de curseurs) Définit un attribut d’instruction. La bibliothèque de curseurs traite les attributs liés au curseur pour implémenter la prise en charge du curseur à défilement.
SQLSetScrollOptions (bibliothèque de curseurs) Définit les options qui contrôlent le comportement du curseur. Cette fonction est déconseillée dans ODBC 3.x ; utilisez SQLSetStmtAttr plutôt des attributs liés au curseur.
SQLSetConnectAttr (bibliothèque de curseurs) Définit un attribut de connexion. La bibliothèque de curseurs traite l’attribut SQL_ATTR_ODBC_CURSORS pour activer ou désactiver l’utilisation de la bibliothèque de curseurs.
SQLSetEnvAttr (bibliothèque de curseurs) Définit un attribut d’environnement. La bibliothèque de curseurs passe cet appel au Gestionnaire de pilotes.

Opérations de traduction et de ligne SQL

Ces fonctions gèrent la traduction d’instructions SQL et la récupération du nombre de lignes.

Fonction Descriptif
SQLNativeSql (bibliothèque de curseurs) Retourne la chaîne SQL telle qu’elle a été modifiée par le pilote. La bibliothèque de curseurs transmet cet appel au pilote sans modification.
SQLRowCount (bibliothèque de curseurs) Retourne le nombre de lignes affectées par une instruction UPDATE, INSERT ou DELETE. La bibliothèque de curseurs suit le nombre de lignes pour les opérations de mise à jour et de suppression positionnées.

Contenu connexe

  • Last updated on