Alças de conexão

Uma ligação consiste num driver e numa fonte de dados. Uma alavanca de ligação identifica cada ligação. O handler de ligação define não só qual driver usar, mas qual fonte de dados usar com esse driver. Dentro de um segmento de código que implementa ODBC (o Gestor de Controladores ou um driver), o handle de ligação identifica uma estrutura que contém informação de ligação, tais como as seguintes:

• O estado da ligação

• Os diagnósticos atuais ao nível da ligação

• Os identificadores das instruções e descritores atualmente atribuídos à conexão

• As definições atuais de cada atributo de ligação

O ODBC não impede múltiplas ligações simultâneas, se o driver as suportar. Assim, num determinado ambiente ODBC, múltiplas alças de conexão podem apontar para uma variedade de controladores e fontes de dados, para o mesmo controlador e várias fontes de dados, ou até para múltiplas conexões com o mesmo controlador e fonte de dados. Alguns drivers limitam o número de ligações ativas que suportam; a opção SQL_MAX_DRIVER_CONNECTIONS no SQLGetInfo especifica quantas ligações ativas um determinado driver suporta.

Os handles de ligação são usados principalmente ao ligar à fonte de dados (SQLConnect, SQLDriverConnect ou SQLBrowseConnect), desligar da fonte de dados (SQLDisconnect), obter informações sobre o driver e a fonte de dados (SQLGetInfo), recuperar diagnósticos (SQLGetDiagField e SQLGetDiagRec) e realizar transações (SQLEndTran). Também são usados ao definir e obter atributos de ligação (SQLSetConnectAttr e SQLGetConnectAttr) e ao obter o formato nativo de uma instrução SQL (SQLNativeSql).

Os handles de ligação são atribuídos com SQLAllocHandle e libertados com SQLFreeHandle.