Étape 4a : Extraire les résultats

L’étape suivante consiste à extraire les résultats, comme illustré dans l’illustration suivante.

Si l’instruction exécutée à l’étape 3 : Générer et exécuter une instruction SQL était une instruction SELECT ou une fonction de catalogue, l’application appelle d’abord SQLNumResultCols pour déterminer le nombre de colonnes dans le jeu de résultats. Cette étape n’est pas nécessaire si l’application connaît déjà le nombre de colonnes du jeu de résultats, par exemple lorsque l’instruction SQL est codée en dur dans une application verticale ou personnalisée.

Ensuite, l’application récupère le nom, le type de données, la précision et l’échelle de chaque colonne de jeu de résultats avec SQLDescribeCol. Là encore, cela n’est pas nécessaire pour les applications telles que les applications verticales et personnalisées qui connaissent déjà ces informations. L’application transmet ces informations à SQLBindCol, qui lie une variable d’application à une colonne dans le jeu de résultats.

L’application appelle maintenant SQLFetch pour récupérer la première ligne de données et placer les données de cette ligne dans les variables liées à SQLBindCol. S’il existe de longues données dans la ligne, elle appelle ENSUITE SQLGetData pour récupérer ces données. L’application continue d’appeler SQLFetch et SQLGetData pour récupérer des données supplémentaires. Une fois l’extraction de données terminée, elle appelle SQLCloseCursor pour fermer le curseur.

Pour obtenir une description complète de la récupération des résultats, consultez Récupération des résultats (de base) et Récupération des résultats (avancés).

L’application retourne désormais à « Étape 3 : Générer et exécuter une instruction SQL » pour exécuter une autre instruction dans la même transaction ; ou passe à « Étape 5 : Valider la transaction » pour valider ou restaurer la transaction.