Défilement et récupération (fetch) de lignes - Ajout de signets aux lignes dans ODBC

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Un signet est une valeur utilisée pour identifier une ligne de données. La signification de la valeur du signet est connue uniquement du pilote ou de la source de données. Par exemple, il peut être aussi simple qu'un numéro de ligne ou aussi complexe qu'une adresse disque. Dans ODBC, l'application demande un signet pour une ligne particulière, le stocke, puis le passe au curseur à retourner à la ligne.

Lors de l’extraction de lignes avec SQLFetchScroll, une application peut utiliser un signet comme base pour sélectionner la ligne de départ. Il s'agit d'une forme d'adressage absolu qui ne dépend pas de la position actuelle du curseur. Pour faire défiler vers une ligne avec signet, l’application appelle SQLFetchScroll avec une FetchOrientation de SQL_FETCH_BOOKMARK. Cette opération utilise le signet vers lequel pointe l'attribut d'option SQL_ATTR_FETCH_BOOKMARK_PTR. Elle retourne l'ensemble de lignes démarrant à la ligne identifiée par ce signet. Une application peut spécifier un décalage pour cette opération dans l’argument FetchOffset de l’appel à SQLFetchScroll. Lorsqu'un décalage est spécifié, la première ligne de l'ensemble de lignes retourné est déterminée par l'ajout du nombre présent dans l'argument FetchOffset au numéro de la ligne identifiée par le signet. Le pilote ODBC SQL Server Native Client prend uniquement en charge les signets sur les curseurs statiques et de jeu de clés. Si un curseur dynamique est demandé lorsque les signets sont définis, un curseur de jeu de clés est ouvert à la place.

Les signets peuvent également être utilisés avec la fonction SQLBulkOperations pour effectuer des opérations sur un ensemble de lignes commençant par le signet.

Voir aussi

Défilement et récupération (fetch) de lignes