Mises à jour positionnées (ODBC)
S’applique à :
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
ODBC prend en charge deux méthodes permettant d'effectuer des mises à jour positionnées dans un curseur :
SQLSetPos
Clause WHERE CURRENT OF
L’approche la plus courante consiste à utiliser SQLSetPos. Il a les options suivantes.
SQL_POSITION
Positionne le curseur sur une ligne spécifique dans l'ensemble de lignes actif.
SQL_REFRESH
Actualise les variables de programme liées aux colonnes de jeu de résultats avec les valeurs provenant de la ligne sur laquelle le curseur est actuellement positionné.
SQL_UPDATE
Met à jour la ligne active du curseur avec les valeurs stockées dans les variables de programme liées aux colonnes de jeu de résultats.
SQL_DELETE
Supprime la ligne active du curseur.
SQLSetPos peut être utilisé avec n’importe quel jeu de résultats d’instruction lorsque les attributs de curseur de handle d’instruction sont définis pour utiliser des curseurs serveur. Les colonnes de jeu de résultats doivent être liées à des variables de programme. Dès que l’application a extrait une ligne, elle appelle SQLSetPos(SQL_POSTION) pour positionner le curseur sur la ligne. L'application peut ensuite appeler SQLSetPos(SQL_DELETE) pour supprimer la ligne active, ou elle peut déplacer les nouvelles valeurs de données dans les variables de programme liées et appeler SQLSetPos(SQL_UPDATE) pour mettre à jour la ligne active.
Les applications peuvent mettre à jour ou supprimer n’importe quelle ligne de l’ensemble de lignes avec SQLSetPos. L’appel de SQLSetPos est une alternative pratique à la construction et à l’exécution d’une instruction SQL. SQLSetPos fonctionne sur l’ensemble de lignes actuel et ne peut être utilisé qu’après un appel à SQLFetchScroll.
La taille de l’ensemble de lignes est définie par un appel à SQLSetStmtAttr avec un argument d’attribut de SQL_ATTR_ROW_ARRAY_SIZE. SQLSetPos utilise une nouvelle taille d’ensemble de lignes, mais uniquement après un appel à SQLFetch ou SQLFetchScroll. Par exemple, si la taille de l’ensemble de lignes est modifiée, SQLSetPos est appelé, puis SQLFetch ou SQLFetchScroll est appelé. L’appel à SQLSetPos utilise l’ancienne taille d’ensemble de lignes, mais SQLFetch ou SQLFetchScroll utilise la nouvelle taille d’ensemble de lignes.
La première ligne de l'ensemble de lignes porte le numéro 1. L’argument RowNumber dans SQLSetPos doit identifier une ligne dans l’ensemble de lignes ; autrement dit, sa valeur doit se trouver dans la plage comprise entre 1 et le nombre de lignes qui ont été extraites le plus récemment. Cette valeur peut être inférieure à la taille de l'ensemble de lignes. Si RowNumber a la valeur 0, l'opération s'applique à chaque ligne de l'ensemble de lignes.
L’opération de suppression de SQLSetPos supprime une ou plusieurs lignes sélectionnées d’une table. Pour supprimer des lignes avec SQLSetPos, l’application appelle SQLSetPos avec l’opération définie sur SQL_DELETE et rowNumber définie sur le nombre de lignes à supprimer. Si RowNumber a la valeur 0, toutes les lignes de l'ensemble de lignes sont supprimées.
Une fois QUE SQLSetPos est retourné, la ligne supprimée est la ligne actuelle et son état est SQL_ROW_DELETED. La ligne ne peut pas être utilisée dans d’autres opérations positionnées, telles que les appels à SQLGetData ou SQLSetPos.
Lorsque vous supprimez toutes les lignes de l’ensemble de lignes (RowNumber est égal à 0), l’application peut empêcher le pilote de supprimer certaines lignes à l’aide du tableau d’opérations de ligne comme pour l’opération de mise à jour de SQLSetPos.
Chaque ligne supprimée doit être une ligne qui existe dans le jeu de résultats. Si les mémoires tampons de l'application ont été remplies par extraction et si un tableau de statut de ligne a été maintenu, ses valeurs à chacune de ces positions de ligne ne doivent pas être SQL_ROW_DELETED, SQL_ROW_ERROR ou SQL_ROW_NOROW.
Les mises à jour positionnées peuvent également être réalisées à l'aide de la clause WHERE CURRENT OF sur les instructions UPDATE, DELETE et INSERT. WHERE CURRENT OF nécessite un nom de curseur que ODBC génère lorsque la fonction SQLGetCursorName est appelée, ou que vous pouvez spécifier en appelant SQLSetCursorName. La procédure générale suivante est utilisée pour effectuer une mise à jour de WHERE CURRENT OF dans une application ODBC :
Appelez SQLSetCursorName pour établir un nom de curseur pour le handle d’instruction.
Générez une instruction SELECT avec une clause FOR UPDATE OF et exécutez-la.
Appelez SQLFetchScroll pour récupérer un ensemble de lignes ou SQLFetch pour récupérer une ligne.
Appelez SQLSetPos (SQL_POSITION) pour positionner le curseur sur la ligne.
Générez et exécutez une instruction UPDATE avec une clause WHERE CURRENT OF à l’aide du nom du curseur défini avec SQLSetCursorName.
Vous pouvez également appeler SQLGetCursorName après avoir exécuté l’instruction SELECT au lieu d’appeler SQLSetCursorName avant d’exécuter l’instruction SELECT. SQLGetCursorName retourne un nom de curseur par défaut attribué par ODBC si vous ne définissez pas de nom de curseur à l’aide de SQLSetCursorName.
SQLSetPos est préféré à WHERE CURRENT OF lorsque vous utilisez des curseurs de serveur. Si vous utilisez un curseur statique pouvant être mis à jour avec la bibliothèque de curseurs ODBC, la bibliothèque de curseurs implémente les mises à jour WHERE CURRENT OF en ajoutant une clause WHERE avec les valeurs de clé pour la table sous-jacente. Cela peut entraîner des mises à jour inattendues si les clés de la table ne sont pas uniques.