Extraction des données de résultat
S’applique à :
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Une application ODBC offre trois options pour l'extraction des données de résultat.
La première option est basée sur SQLBindCol. Avant d’extraire le jeu de résultats, l’application utilise SQLBindCol pour lier chaque colonne du jeu de résultats à une variable de programme. Une fois les colonnes liées, le pilote transfère les données de la ligne actuelle dans les variables liées aux colonnes du jeu de résultats chaque fois que l’application appelle SQLFetch ou SQLFetchScroll. Le pilote gère les conversions de données si la colonne du jeu de résultats et la variable de programme possèdent des types de données différents. Si l’application a SQL_ATTR_ROW_ARRAY_SIZE définie sur plus de 1, elle peut lier des colonnes de résultats à des tableaux de variables, qui seront toutes remplies sur chaque appel à SQLFetchScroll.
La deuxième option est basée sur SQLGetData. L’application n’utilise pas SQLBindCol pour lier les colonnes du jeu de résultats aux variables de programme. Après chaque appel à SQLFetch, l’application appelle SQLGetData une fois pour chaque colonne du jeu de résultats. SQLGetData indique au pilote de transférer des données d’une colonne de jeu de résultats spécifique vers une variable de programme spécifique et spécifie les types de données de la colonne et de la variable. Le pilote peut ainsi convertir des données si la colonne de résultat et la variable de programme possèdent des types de données différents. Les colonnes texte, ntext et image sont généralement trop volumineuses pour s’adapter à une variable de programme, mais peuvent toujours être récupérées à l’aide de SQLGetData. Si le texte, ntext ou les données d’image dans la colonne de résultats sont supérieures à la variable de programme, SQLGetData retourne SQL_SUCCESS_WITH_INFO et SQLSTATE 01004 (données de chaîne, tronquées à droite). Les appels successifs à SQLGetData retournent des blocs successifs des données de texte ou d’image . Lorsque la fin des données est atteinte, SQLGetData retourne SQL_SUCCESS. Chaque extraction retourne un jeu de lignes, ou « ensemble de lignes », si SQL_ATTR_ROW_ARRAY_SIZE est supérieur à 1. Avant d’utiliser SQLGetData, vous devez d’abord utiliser SQLSetPos pour spécifier une ligne spécifique dans l’ensemble de lignes comme ligne active.
La troisième option consiste à utiliser une combinaison de SQLBindCol et SQLGetData. Une application peut, par exemple, lier les dix premières colonnes d’un jeu de résultats, puis, sur chaque extraction, appeler SQLGetData trois fois pour récupérer les données à partir de trois colonnes indépendantes. Cela est généralement utilisé lorsqu’un jeu de résultats contient un ou plusieurs colonnes de texte ou d’image .
Selon les options de curseur définies pour le jeu de résultats, une application peut également utiliser les options de défilement de SQLFetchScroll pour faire défiler le jeu de résultats.
L’utilisation excessive de SQLBindCol pour lier une colonne de jeu de résultats à une variable de programme est coûteuse, car SQLBindCol provoque l’allocation de mémoire par un pilote ODBC. Lorsque vous liez une colonne de résultat à une variable, cette liaison reste en vigueur jusqu’à ce que vous appeliez SQLFreeHandle pour libérer le handle d’instruction ou appeler SQLFreeStmt avec fOption défini sur SQL_UNBIND. Les liaisons ne sont pas automatiquement annulées à la fin de l'instruction.
Cette logique vous permet de gérer avec efficacité l'exécution à maintes reprises de la même instruction avec des paramètres différents. Étant donné que le jeu de résultats conserve la même structure, vous pouvez lier le jeu de résultats une fois, traiter toutes les instructions SELECT, puis appeler SQLFreeStmt avec fOption défini sur SQL_UNBIND après la dernière exécution. Vous ne devez pas appeler SQLBindCol pour lier les colonnes d’un jeu de résultats sans appeler d’abord SQLFreeStmt avec fOption défini sur SQL_UNBIND pour libérer les liaisons précédentes.
Lorsque vous utilisez SQLBindCol, vous pouvez effectuer une liaison en ligne ou en colonnes. La liaison selon les lignes est un tantinet plus rapide que la liaison selon les colonnes.
Vous pouvez utiliser SQLGetData pour récupérer des données sur une base de colonne par colonne au lieu de lier des colonnes de jeu de résultats à l’aide de SQLBindCol. Si un jeu de résultats contient seulement quelques lignes, l’utilisation de SQLGetData au lieu de SQLBindCol est plus rapide ; sinon, SQLBindCol offre les meilleures performances. Si vous ne placez pas toujours les données dans le même ensemble de variables, vous devez utiliser SQLGetData au lieu de la liaison constante. Vous ne pouvez utiliser SQLGetData que sur les colonnes qui se trouvent dans la liste de sélection une fois que toutes les colonnes sont liées à SQLBindCol. La colonne doit également apparaître après toutes les colonnes sur lesquelles vous avez déjà utilisé SQLGetData.
Les fonctions ODBC qui traitent du déplacement de données vers ou hors de variables de programme, telles que SQLGetData, SQLBindCol et SQLBindParameter, prennent en charge la conversion implicite du type de données. Par exemple, si une application lie une colonne d'entiers à une variable de programme de chaîne de caractères, le pilote convertit automatiquement les données d'entier en caractère avant de les insérer dans la variable de programme.
La conversion de données dans les applications doit être réduite. À moins que la conversion de données ne soit nécessaire pour le traitement pris en charge par l'application, les applications doivent lier les colonnes et les paramètres à des variables de programme du même type de données. En revanche, si les données doivent être converties d'un type à un autre, il est plus efficace de confier la conversion au pilote plutôt que de l'effectuer dans l'application. Le pilote ODBC SQL Server Native Client transfère normalement les données directement des mémoires tampons réseau aux variables de l’application. En confiant la conversion des données au pilote, vous forcez ce dernier à mettre les données en mémoire tampon et à les convertir au moyen de cycles processeur.
Les variables de programme doivent être suffisamment volumineuses pour contenir les données transférées à partir d’une colonne, à l’exception du texte, du ntext et des données d’image . Si une application tente d'extraire les données d'un jeu de résultats et de les placer dans une variable trop petite pour les contenir, le pilote émet un avertissement. Cette opération contraint le pilote à allouer de la mémoire pour le message et le pilote et l'application doivent tous les deux utiliser des cycles processeur pour traiter le message et gérer les erreurs. L'application doit soit allouer une variable suffisamment grande pour accueillir les données extraites, soit faire appel à la fonction SUBSTRING dans la liste de sélection pour réduire la taille de la colonne au sein du jeu de résultats.
Soyez vigilant lorsque vous utilisez SQL_C_DEFAULT pour définir le type de la variable C. SQL_C_DEFAULT spécifie que le type de la variable C correspond au type de données SQL de la colonne ou du paramètre. Si SQL_C_DEFAULT est spécifié pour une colonne ntext, nchar ou nvarchar , les données Unicode sont retournées à l’application. Ceci peut entraîner divers problèmes si l'application n'a pas été codée pour gérer des données Unicode. Les mêmes types de problèmes peuvent se produire avec le type de données uniqueidentifier (SQL_GUID).
les données texte, ntext et image sont généralement trop volumineuses pour s’adapter à une variable de programme unique et sont généralement traitées avec SQLGetData au lieu de SQLBindCol. Lorsque vous utilisez des curseurs de serveur, le pilote ODBC SQL Server Native Client est optimisé pour ne pas transmettre les données pour le texte, ntext ou les colonnes d’image non liées au moment de la récupération de la ligne. Le texte, le ntext ou les données d’image ne sont pas réellement récupérés du serveur tant que l’application n’émet pas SQLGetData pour la colonne.
Cette optimisation peut être appliquée aux applications afin qu’aucun texte, ntext ou données d’image ne s’affiche alors qu’un utilisateur fait défiler vers le haut et le bas un curseur. Une fois que l’utilisateur a sélectionné une ligne, l’application peut appeler SQLGetData pour récupérer le texte, ntext ou les données d’image . Cela permet d’enregistrer la transmission du texte, du ntext ou des données d’image pour l’une des lignes que l’utilisateur ne sélectionne pas et peut enregistrer la transmission de très grandes quantités de données.