Transições de conexão

As conexões ODBC têm os seguintes estados.

Estadual	Descrição
C0	Ambiente não alocado, conexão não alocada
C1	Ambiente alocado, conexão não alocada
C2	Ambiente alocado, conexão alocada
C3	A função de conexão precisa de dados
C4	Conexão conectada
C5	Conexão conectada, instrução alocada
C6	Conexão conectada, transação em andamento. É possível que uma conexão esteja no estado C6 sem instruções alocadas na conexão. Por exemplo, suponha que a conexão esteja no modo de confirmação manual e no estado C4. Se uma instrução for alocada, executada (iniciando uma transação) e depois liberada, a transação permanecerá ativa, mas não haverá instruções na conexão.

As tabelas a seguir mostram como cada função ODBC afeta o estado da conexão.

SQLAllocHandle

C0 Sem Env.	C1 Não Alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
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] Esta linha mostra as transições quando HandleType foi SQL_HANDLE_ENV.

[2] Esta linha mostra transições quando HandleType foi SQL_HANDLE_DBC.

[3] Esta linha mostra transições quando HandleType foi SQL_HANDLE_STMT.

[4] Esta linha mostra as transições quando HandleType foi SQL_HANDLE_DESC.

[5] Chamar SQLAllocHandle com OutputHandlePtr apontando para um identificador válido substitui esse identificador sem considerar o conteúdo anterior desse identificador e pode causar problemas para drivers ODBC. É uma programação incorreta de aplicativos ODBC chamar SQLAllocHandle duas vezes com a mesma variável de aplicativo definida para *OutputHandlePtr sem chamar SQLFreeHandle para liberar o identificador antes de realocá-lo. Substituir identificadores ODBC dessa maneira pode levar a um comportamento inconsistente ou erros por parte dos drivers ODBC.

SQLBrowseConnect

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
(IH)	(IH)	C3 [d] C4 [s]	-- [d] C2 [e] C4 [s]	(08002)	(08002)	(08002)

SQLCloseCursor

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
(IH)	(IH)	(IH)	(IH)	(IH)	--	--[1] C5[2]

[1] A conexão estava no modo de confirmação manual.

[2] A conexão estava no modo de confirmação automática.

SQLColumnPrivileges, SQLColumns, SQLForeignKeys, SQLGetTypeInfo, SQLPrimaryKeys, SQLProcedureColumns, SQLProcedures, SQLSpecialColumns, SQLStatistics, SQLTablePrivileges e SQLTables

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
(IH)	(IH)	(IH)	(IH)	(IH)	--[1] C6[2]	--

[1] A conexão estava no modo de confirmação automática ou a fonte de dados não iniciou uma transação.

[2] A conexão estava no modo de confirmação manual e a fonte de dados iniciou uma transação.

SQLConnect

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
(IH)	(IH)	C4	(08002)	(08002)	(08002)	(08002)

SQLCopyDesc, SQLGetDescField, SQLGetDescRec, SQLSetDescField e SQLSetDescRec

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
(IH)	(IH)	(IH)	(IH)	--[1]	--	--

[1] Nesse estado, os únicos descritores disponíveis para o aplicativo são descritores explicitamente alocados.

SQLDataSources e SQLDrivers

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
(IH)	--	--	--	--	--	--

SQLDisconnect

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
(IH)	(IH)	(08003)	C2	C2	C2	25000

SQLDriverConnect

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
(IH)	(IH)	C4 s -- n[f]	(08002)	(08002)	(08002)	(08002)

SQLEndTran

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
(IH) [1]	--[3]	--[3]	--[3]	--	--	--[4] ou ([5], [6] e [8]) C4[5] e [7] C5[5], [6] e [9]
(IH) [2]	(IH)	(08003)	(08003)	--	--	C5

[1] Esta linha mostra as transições quando HandleType foi SQL_HANDLE_ENV.

[2] Esta linha mostra transições quando HandleType foi SQL_HANDLE_DBC.

[3] Como a conexão não está em um estado conectado, ela não é afetada pela transação.

[4] O commit ou rollback falhou na conexão. A função retorna SQL_ERROR nesse caso.

[5] O commit ou rollback foi bem-sucedido na conexão. A função retorna SQL_ERROR se a confirmação ou reversão falhou em outra conexão, ou a função retorna SQL_SUCCESS se a confirmação ou reversão foi bem-sucedida em todas as conexões.

[6] Havia pelo menos uma declaração alocada na conexão.

[7] Não houve declarações alocadas na conexão.

[8] A conexão tinha pelo menos uma instrução para a qual havia um cursor aberto e a fonte de dados preserva cursores quando as transações são confirmadas ou revertidas, o que se aplicar (dependendo se CompletionType foi SQL_COMMIT ou SQL_ROLLBACK). Para obter mais informações, consulte os atributos SQL_CURSOR_COMMIT_BEHAVIOR e SQL_CURSOR_ROLLBACK_BEHAVIOR em SQLGetInfo.

[9] Se a conexão tivesse instruções para as quais houvesse cursores abertos, os cursores não eram preservados quando a transação era confirmada ou revertida.

SQLExecDirect e SQLExecute

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
(IH)	(IH)	(IH)	(IH)	(IH)	--[1] C6[2] C6[3]	--

[1] A conexão estava no modo de confirmação automática e a instrução executada não era uma especificação de cursor (como uma instrução SELECT); ou a conexão estava no modo de confirmação manual e a instrução executada não iniciava uma transação.

[2] A conexão estava no modo de confirmação automática e a instrução executada era uma especificação de cursor (como uma instrução SELECT).

[3] A conexão estava no modo de confirmação manual e a fonte de dados iniciou uma transação.

SQLFreeHandle

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
(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] e [8] C5[6] e [8]
(IH) [4]	(IH)	(IH)	(IH)	--	--	--

[1] Esta linha mostra as transições quando HandleType foi SQL_HANDLE_ENV.

[2] Esta linha mostra transições quando HandleType foi SQL_HANDLE_DBC.

[3] Esta linha mostra transições quando HandleType foi SQL_HANDLE_STMT.

[4] Esta linha mostra as transições quando HandleType foi SQL_HANDLE_DESC.

[5] Havia apenas uma declaração alocada na conexão.

[6] Havia várias declarações alocadas na conexão.

[7] A conexão estava no modo de confirmação manual.

[8] A conexão estava no modo de confirmação automática.

SQLFreeStmt

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
(IH) [1]	(IH)	(IH)	(IH)	(IH)	--	C5[3] --[4]
(IH) [2]	(IH)	(IH)	(IH)	(IH)	--	--

[1] Esta linha mostra transações quando o argumento Option é SQL_CLOSE.

[2] Esta linha mostra transações quando o argumento Option é SQL_UNBIND ou SQL_RESET_PARAMS.

[3] A conexão estava no modo de confirmação automática e nenhum cursor estava aberto em nenhuma instrução, exceto esta.

[4] A conexão estava no modo de confirmação manual ou no modo de confirmação automática e um cursor estava aberto em pelo menos uma outra instrução.

SQLGetConnectAttr

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
IH	IH	--[1] 08003[2]	HY010	--	--	--

[1] O argumento Attribute era SQL_ATTR_ACCESS_MODE, SQL_ATTR_AUTOCOMMIT, SQL_ATTR_LOGIN_TIMEOUT, SQL_ATTR_ODBC_CURSORS, SQL_ATTR_TRACE ou SQL_ATTR_TRACEFILE, ou um valor foi definido para o atributo de conexão.

[2] O argumento Attribute não era SQL_ATTR_ACCESS_MODE, SQL_ATTR_AUTOCOMMIT, SQL_ATTR_LOGIN_TIMEOUT, SQL_ATTR_ODBC_CURSORS, SQL_ATTR_TRACE ou SQL_ATTR_TRACEFILE, e um valor não havia sido definido para o atributo de conexão.

SQLGetDiagField e SQLGetDiagRec

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
(IH) [1]	--	--	--	--	--	--
(IH) [2]	(IH)	--	--	--	--	--
(IH) [3]	(IH)	(IH)	(IH)	(IH)	--	--
(IH) [4]	(IH)	(IH)	(IH)	--	--	--

[1] Esta linha mostra as transições quando HandleType foi SQL_HANDLE_ENV.

[2] Esta linha mostra transições quando HandleType foi SQL_HANDLE_DBC.

[3] Esta linha mostra transições quando HandleType foi SQL_HANDLE_STMT.

[4] Esta linha mostra as transições quando HandleType foi SQL_HANDLE_DESC.

SQLGetEnvAttr

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
IH	--	--	--	--	--	--

SQLGetFunctions

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
IH	IH	HY010	HY010	--	--	--

SQLGetInfo

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
IH	IH	--[1] 08003[2]	08003	--	--	--

[1] O argumento InfoType foi SQL_ODBC_VER.

[2] O argumento InfoType não foi SQL_ODBC_VER.

SQLMoreResults

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
(IH)	(IH)	(IH)	(IH)	(IH)	--[1] C6[2]	--[3] C5[1]

[1] A conexão estava no modo de confirmação automática e a chamada para SQLMoreResults não inicializou o processamento de um conjunto de resultados de uma especificação de cursor.

[2] A conexão estava no modo de confirmação automática e a chamada para SQLMoreResults inicializou o processamento de um conjunto de resultados de uma especificação de cursor.

[3] A conexão estava no modo de confirmação manual.

SQLNativeSql

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
(IH)	(IH)	(08003)	(08003)	--	--	--

SQLPrepare

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
(IH)	(IH)	(IH)	(IH)	(IH)	--[1] C6[2]	--

[1] A conexão estava no modo de confirmação automática ou a fonte de dados não iniciou uma transação.

[2] A conexão estava no modo de confirmação manual e a fonte de dados iniciou uma transação.

SQLSetConnectAttr

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
IH	IH	--[1] 08003[2]	HY010	--[3] 08002[4] HY011[5]	--[3] 08002[4] HY011[5]	--[3] e [6] C5[8] 08002[4] HY011[5] ou [7]

[1] O argumento Atributo não foi SQL_ATTR_TRANSLATE_LIB ou SQL_ATTR_TRANSLATE_OPTION.

[2] O argumento Attribute era SQL_ATTR_TRANSLATE_LIB ou SQL_ATTR_TRANSLATE_OPTION.

[3] O argumento Attribute não foi SQL_ATTR_ODBC_CURSORS ou SQL_ATTR_PACKET_SIZE.

[4] O argumento Attribute foi SQL_ATTR_ODBC_CURSORS.

[5] O argumento Attribute foi SQL_ATTR_PACKET_SIZE.

[6] O argumento Attribute não foi SQL_ATTR_AUTOCOMMIT, ou o argumento Attribute foi SQL_ATTR_AUTOCOMMIT e definir esse atributo não confirmou a transação.

[7] O argumento Attribute foi SQL_ATTR_TXN_ISOLATION.

[8] O argumento Attribute foi SQL_ATTR_AUTOCOMMIT e definir esse atributo confirmou a transação.

SQLSetEnvAttr

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
(IH)	--	--	(HY010)	--	--	--

Todas as outras funções ODBC

C0 Sem Env.	C1 Não alocado	C2 Alocado	C3 Precisa de dados	C4 Conectado	C5 Instrução	C6 Transação
(IH)	(IH)	(IH)	(IH)	(IH)	--	--