Transitions de connexion
Les connexions ODBC ont les états suivants.
| State | Description |
|---|---|
| C0 | Environnement non alloué, connexion non allouée |
| C1 | Environnement alloué, connexion non allouée |
| C2 | Environnement alloué, connexion allouée |
| C3 | La fonction de connexion a besoin de données |
| C4 | Connexion connectée |
| C5 | Connexion connectée, instruction allouée |
| C6 | Connexion connectée, transaction en cours. Il est possible qu’une connexion soit dans l’état C6 sans instructions allouées sur la connexion. Par exemple, supposons que la connexion est en mode de validation manuelle et qu’elle est dans l’état C4. Si une instruction est allouée, exécutée (démarrage d’une transaction), puis libérée, la transaction reste active, mais il n’y a pas d’instructions sur la connexion. |
Les tableaux suivants montrent comment chaque fonction ODBC affecte l’état de connexion.
SQLAllocHandle
| C0
Pas d’env. |
C1 non alloué | C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| C1[1] | --[5] | --[5] | --[5] | --[5] | --[5] | --[5] |
| (IH)[2] | C2 | --[5] | --[5] | --[5] | --[5] | --[5] |
| (IH)[3] | (IH) | (08003) | (08003) | C5 | --[5] | --[5] |
| (IH)[4] | (IH) | (08003) | (08003) | --[5] | --[5] | --[5] |
[1] Cette ligne affiche les transitions lorsque HandleType a été SQL_HANDLE_ENV.
[2] Cette ligne affiche les transitions lorsque HandleType a été SQL_HANDLE_DBC.
[3] Cette ligne affiche les transitions lorsque HandleType a été SQL_HANDLE_STMT.
[4] Cette ligne affiche les transitions lorsque HandleType a été SQL_HANDLE_DESC.
[5] Appel de SQLAllocHandle avec OutputHandlePtr pointant vers un handle valide remplace ce handle sans tenir compte du contenu précédent du handle, et peut entraîner des problèmes pour les pilotes ODBC. Il est incorrect de programmer une application ODBC pour appeler SQLAllocHandle deux fois avec la même variable d’application définie pour *OutputHandlePtr sans appeler SQLFreeHandle pour libérer le handle avant de la réallouer. Le remplacement des handles ODBC d’une telle manière peut entraîner des erreurs ou comportements incohérents dans la partie des pilotes ODBC.
SQLBrowseConnect
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| (IH) | (IH) | C3 [d] C4 [s] | -- [d] C2 [e] C4 [s] | (08002) | (08002) | (08002) |
SQLCloseCursor
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| (IH) | (IH) | (IH) | (IH) | (IH) | -- | --[1] C5[2] |
[1] La connexion était en mode de validation manuelle.
[2] La connexion était en mode de validation automatique.
SQLColumnPrivileges, SQLColumns, SQLForeignKeys, SQLGetTypeInfo, SQLPrimaryKeys, SQLProcedureColumns, SQLProcedures, SQLSpecialColumns, SQLStatistics, SQLTablePrivileges et SQLTables
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| (IH) | (IH) | (IH) | (IH) | (IH) | --[1] C6[2] | -- |
[1] La connexion était en mode de validation automatique, ou la source de données n’a pas commencé une transaction.
[2] La connexion était en mode de validation manuelle et la source de données a commencé une transaction.
SQLConnect
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| (IH) | (IH) | C4 | (08002) | (08002) | (08002) | (08002) |
SQLCopyDesc, SQLGetDescField, SQLGetDescRec, SQLSetDescField et SQLSetDescRec
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| (IH) | (IH) | (IH) | (IH) | --[1] | -- | -- |
[1] Dans cet état, les seuls descripteurs disponibles pour l’application sont des descripteurs alloués explicitement.
SQLDataSources et SQLDrivers
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| (IH) | -- | -- | -- | -- | -- | -- |
SQLDisconnect
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| (IH) | (IH) | (08003) | C2 | C2 | C2 | 25000 |
SQLDriverConnect
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| (IH) | (IH) | C4 s -- n[f] | (08002) | (08002) | (08002) | (08002) |
SQLEndTran
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| (IH)[1] | --[3] | --[3] | --[3] | -- | -- | --[4] ou ([5], [6], et [8]) C4[5] et [7] C5[5], [6] et [9] |
| (IH)[2] | (IH) | (08003) | (08003) | -- | -- | C5 |
[1] Cette ligne affiche les transitions lorsque HandleType a été SQL_HANDLE_ENV.
[2] Cette ligne affiche les transitions lorsque HandleType a été SQL_HANDLE_DBC.
[3] Étant donné que la connexion n’est pas dans un état connecté, elle n’est pas affectée par la transaction.
[4] Échec de la validation ou de la restauration sur la connexion. La fonction retourne SQL_ERROR dans ce cas.
[5] Validation ou restauration réussie sur la connexion. La fonction retourne SQL_ERROR si la validation ou la restauration a échoué sur une autre connexion, ou si la fonction retourne SQL_SUCCESS si la validation ou la restauration a réussi sur toutes les connexions.
[6] Au moins une instruction a été allouée sur la connexion.
[7] Aucune instruction n’a été allouée sur la connexion.
[8] La connexion avait au moins une instruction pour laquelle il y avait un curseur ouvert, et la source de données conserve les curseurs lorsque les transactions sont validées ou restaurées, selon que CompletionType était SQL_COMMIT ou SQL_ROLLBACK). Pour plus d’informations, consultez les attributs SQL_CURSOR_COMMIT_BEHAVIOR et SQL_CURSOR_ROLLBACK_BEHAVIOR dans SQLGetInfo.
[9] Si la connexion avait des instructions pour lesquelles il y avait des curseurs ouverts, les curseurs n’ont pas été conservés lorsque la transaction a été validée ou restaurée.
SQLExecDirect et SQLExecute
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| (IH) | (IH) | (IH) | (IH) | (IH) | --[1] C6[2] C6[3] | -- |
[1] La connexion était en mode de validation automatique et l’instruction exécutée n’était pas une spécification de curseur (par exemple, une instruction SELECT) ; ou la connexion était en mode de validation manuelle et l’instruction exécutée n’a pas commencé une transaction.
[2] La connexion était en mode de validation automatique et l’instruction exécutée était une spécification de curseur (par exemple, une instruction SELECT).
[3] La connexion était en mode de validation manuelle et la source de données a commencé une transaction.
SQLFreeHandle
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| (IH)[1] | C0 | (HY010) | (HY010) | (HY010) | (HY010) | (HY010) |
| (IH)[2] | (IH) | (C1) | (HY010) | (HY010) | (HY010) | (HY010) |
| (IH)[3] | (IH) | (IH) | (IH) | (IH) | C4[5] --[6] | --[7] C4[5] et [8] C5[6] et [8] |
| (IH)[4] | (IH) | (IH) | (IH) | -- | -- | -- |
[1] Cette ligne affiche les transitions lorsque HandleType a été SQL_HANDLE_ENV.
[2] Cette ligne affiche les transitions lorsque HandleType a été SQL_HANDLE_DBC.
[3] Cette ligne affiche les transitions lorsque HandleType a été SQL_HANDLE_STMT.
[4] Cette ligne affiche les transitions lorsque HandleType a été SQL_HANDLE_DESC.
[5] Il n’y avait qu’une seule instruction allouée sur la connexion.
[6] Plusieurs instructions ont été allouées sur la connexion.
[7] La connexion était en mode de validation manuelle.
[8] La connexion était en mode de validation automatique.
SQLFreeStmt
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| (IH)[1] | (IH) | (IH) | (IH) | (IH) | -- | C5[3] --[4] |
| (IH)[2] | (IH) | (IH) | (IH) | (IH) | -- | -- |
[1] Cette ligne affiche les transactions lorsque l’argument Option est SQL_CLOSE.
[2] Cette ligne affiche les transactions lorsque l’argument Option est SQL_UNBIND ou SQL_RESET_PARAMS.
[3] La connexion était en mode de validation automatique et aucun curseur n’était ouvert sur les instructions à l’exception de celle-ci.
[4] La connexion était en mode de validation manuelle, ou elle était en mode de validation automatique et un curseur était ouvert sur au moins une autre instruction.
SQLGetConnectAttr
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| IH | IH | --[1] 08003[2] | HY010 | -- | -- | -- |
[1] L’argument Attribut était SQL_ATTR_ACCESS_MODE, SQL_ATTR_AUTOCOMMIT, SQL_ATTR_LOGIN_TIMEOUT, SQL_ATTR_ODBC_CURSORS, SQL_ATTR_TRACE ou SQL_ATTR_TRACEFILE, ou une valeur avait été définie pour l’attribut de connexion.
[2] L’argument Attribut n’était pas SQL_ATTR_ACCESS_MODE, SQL_ATTR_AUTOCOMMIT, SQL_ATTR_LOGIN_TIMEOUT, SQL_ATTR_ODBC_CURSORS, SQL_ATTR_TRACE ou SQL_ATTR_TRACEFILE, et une valeur n’avait pas été définie pour l’attribut de connexion.
SQLGetDiagField et SQLGetDiagRec
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| (IH)[1] | -- | -- | -- | -- | -- | -- |
| (IH)[2] | (IH) | -- | -- | -- | -- | -- |
| (IH)[3] | (IH) | (IH) | (IH) | (IH) | -- | -- |
| (IH)[4] | (IH) | (IH) | (IH) | -- | -- | -- |
[1] Cette ligne affiche les transitions lorsque HandleType a été SQL_HANDLE_ENV.
[2] Cette ligne affiche les transitions lorsque HandleType a été SQL_HANDLE_DBC.
[3] Cette ligne affiche les transitions lorsque HandleType a été SQL_HANDLE_STMT.
[4] Cette ligne affiche les transitions lorsque HandleType a été SQL_HANDLE_DESC.
SQLGetEnvAttr
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| IH | -- | -- | -- | -- | -- | -- |
SQLGetFunctions
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| IH | IH | HY010 | HY010 | -- | -- | -- |
SQLGetInfo
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| IH | IH | --[1] 08003[2] | 08003 | -- | -- | -- |
[1] L’argument InfoType était SQL_ODBC_VER.
[2] L’argument InfoType n’était pas SQL_ODBC_VER.
SQLMoreResults
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| (IH) | (IH) | (IH) | (IH) | (IH) | --[1] C6[2] | --[3] C5[1] |
[1] La connexion était en mode de validation automatique et l’appel à SQLMoreResults n’a pas initialisé le traitement d’un jeu de résultats d’une spécification de curseur.
[2] La connexion était en mode de validation automatique et l’appel à SQLMoreResults a initialisé le traitement d’un jeu de résultats d’une spécification de curseur.
[3] La connexion était en mode de validation manuelle.
SQLNativeSql
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| (IH) | (IH) | (08003) | (08003) | -- | -- | -- |
SQLPrepare
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| (IH) | (IH) | (IH) | (IH) | (IH) | --[1] C6[2] | -- |
[1] La connexion était en mode de validation automatique, ou la source de données n’a pas commencé une transaction.
[2] La connexion était en mode de validation manuelle et la source de données a commencé une transaction.
SQLSetConnectAttr
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| IH | IH | --[1] 08003[2] | HY010 | --[3] 08002[4] HY011[5] | --[3] 08002[4] HY011[5] | --[3] et [6] C5[8] 08002[4] HY011[5] ou [7] |
[1] L’argument Attribut n’a pas été SQL_ATTR_TRANSLATE_LIB ni SQL_ATTR_TRANSLATE_OPTION.
[2] L’argument Attribut était SQL_ATTR_TRANSLATE_LIB ou SQL_ATTR_TRANSLATE_OPTION.
[3] L’argument Attribut n’a pas été SQL_ATTR_ODBC_CURSORS ni SQL_ATTR_PACKET_SIZE.
[4] L’argument Attribut était SQL_ATTR_ODBC_CURSORS.
[5] L’argument Attribut était SQL_ATTR_PACKET_SIZE.
[6] L’argument Attribut n’était pas SQL_ATTR_AUTOCOMMIT, ou l’argument Attribut était SQL_ATTR_AUTOCOMMIT et la définition de cet attribut n’a pas validée la transaction.
[7] L’argument Attribut était SQL_ATTR_TXN_ISOLATION.
[8] L’argument Attribut a été SQL_ATTR_AUTOCOMMIT et la définition de cet attribut a validé la transaction.
SQLSetEnvAttr
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| (IH) | -- | -- | (HY010) | -- | -- | -- |
Toutes les autres fonctions ODBC
| C0
Pas d’env. |
C1 Non alloué |
C2 Affecté |
C3 Besoin de données |
C4 Connecté |
C5 . |
C6 Transaction |
|---|---|---|---|---|---|---|
| (IH) | (IH) | (IH) | (IH) | (IH) | -- | -- |