Conformidade da interface central

Todos os drivers ODBC devem apresentar pelo menos conformidade de interface ao nível do Core. Como as funcionalidades ao nível Core são as exigidas pela maioria das aplicações genéricas interoperáveis, o driver pode trabalhar com essas aplicações. As funcionalidades ao nível Core também correspondem às funcionalidades definidas na especificação ISO CLI e às funcionalidades não opcionais definidas na especificação Open Group LI. Um driver ODBC compatível com interface ao nível do núcleo permite à aplicação fazer tudo o seguinte:

• Aloque e liberte todos os tipos de handles, chamando SQLAllocHandle e SQLFreeHandle.

• Use todas as formas da função SQLFreeStmt .

• Associe as colunas do conjunto de resultados, chamando SQLBindCol.

• Tratar parâmetros dinâmicos, incluindo arrays de parâmetros, apenas na direção de entrada, chamando SQLBindParameter e SQLNumParams. (Os parâmetros na direção de saída são a característica 203 na Conformidade da Interface de Nível 2.)

• Especifique um deslocamento de ligação.

• Use o diálogo data-at-execution, que envolve chamadas para SQLParamData e SQLPutData.

• Gerir cursores e nomes de cursor, chamando SQLCloseCursor, SQLGetCursorName e SQLSetCursorName.

• Aceda à descrição (metadados) dos conjuntos de resultados, chamando SQLColAttribute, SQLDescribeCol, SQLNumResultCols e SQLRowCount. (A utilização destas funções na coluna número 0 para recuperar metadados de favoritos é a característica 204 na Conformidade da Interface de Nível 2.)

• Consulta o dicionário de dados chamando as funções do catálogo SQLColumns, SQLGetTypeInfo, SQLStatistics e SQLTables.

  O driver não é obrigado a suportar nomes multipartes de tabelas e visões de bases de dados. (Para mais informações, veja a funcionalidade 101 em Conformidade de Interface Nível 1 e a funcionalidade 201 em Conformidade de Interface Nível 2.) No entanto, certas características da especificação SQL-92, como a qualificação das colunas e os nomes dos índices, são sintaticamente comparáveis à nomeação multiparte. A lista atual de funcionalidades ODBC não pretende introduzir novas opções nestes aspetos do SQL-92.

• Gere fontes de dados e ligações, chamando SQLConnect, SQLDataSources, SQLDisconnect e SQLDriverConnect. Obtenha informações sobre os drivers, independentemente do nível ODBC que suportem, chamando o SQLDrivers.

• Prepare e execute instruções SQL, chamando SQLExecDirect, SQLExecute e SQLPrepare.

• Busque uma linha de um conjunto de resultados ou várias linhas, apenas na direção direta, chamando SQLFetch ou apelando SQLFetchScroll com o argumento FetchOrientation definido para SQL_FETCH_NEXT.

• Obtenha uma coluna não vinculada em partes, chamando SQLGetData.

• Obtenha os valores atuais de todos os atributos, chamando SQLGetConnectAttr, SQLGetEnvAttr e SQLGetStmtAttr, e defina todos os atributos para os valores predefinidos e certos atributos para valores não predefinidos, chamando SQLSetConnectAttr, SQLSetEnvAttr e SQLSetStmtAttr.

• Manipule certos campos de descritores, chamando SQLCopyDesc, SQLGetDescField, SQLGetDescRec, SQLSetDescField e SQLSetDescRec.

• Obtenha informação de diagnóstico, chamando SQLGetDiagField e SQLGetDiagRec.

• Detetar capacidades dos drivers, chamando SQLGetFunctions e SQLGetInfo. Além disso, detete o resultado de quaisquer substituições de texto feitas numa instrução SQL antes de esta ser enviada para a fonte de dados, chamando SQLNativeSql.

• Utilize a sintaxe de SQLEndTran para confirmar uma transação. Um driver ao nível do núcleo não precisa de suportar transações verdadeiras; Portanto, a aplicação não pode especificar SQL_ROLLBACK nem SQL_AUTOCOMMIT_OFF para o atributo SQL_ATTR_AUTOCOMMIT de conexão. (Para mais informações, veja a funcionalidade 109 em Conformidade de Interface de Nível 2.)

• Chame SQLCancel para cancelar o diálogo de dados na execução e, em ambientes multithread, para cancelar uma função ODBC a executar noutro thread. A conformidade com interfaces ao nível do núcleo não exige suporte para execução assíncrona de funções, nem o uso do SQLCancel para cancelar uma função ODBC a executar assíncrona. Nem a plataforma nem o driver ODBC precisam de ser multithread para que o driver realize atividades independentes ao mesmo tempo. No entanto, em ambientes multithread, o driver ODBC deve ser seguro para execução em múltiplas threads. A serialização dos pedidos da aplicação é uma forma conforme de implementar esta especificação, mesmo que possa criar sérios problemas de desempenho.

• Obtenha a coluna identificadora de linhas SQL_BEST_ROWID das tabelas, chamando SQLSpecialColumns. (O suporte para SQL_ROWVER é a funcionalidade 208 na Conformidade de Interface de Nível 2.)

  Importante

  Os drivers ODBC devem implementar as funções no nível de conformidade da interface Core.