Compartilhar via

Conectando-se a uma fonte de dados (ODBC)

Depois de alocar identificadores de ambiente e conexão e definir quaisquer atributos de conexão, o aplicativo se conecta à fonte de dados ou ao driver. Há três funções que você pode usar para se conectar:

  • SQLConnect

  • SQLDriverConnect

  • SQLBrowseConnect

Para obter mais informações sobre como fazer conexões com uma fonte de dados, incluindo as várias opções de cadeia de conexão disponíveis, consulte Usando palavras-chave de cadeia de conexão com o SQL Server Native Client.

SQLConnect

SQLConnect é a função de conexão mais simples. Ele aceita três parâmetros: um nome de fonte de dados, uma ID de usuário e uma senha. Use SQLConnect quando esses três parâmetros contiverem todas as informações necessárias para se conectar ao banco de dados. Para fazer isso, crie uma lista de fontes de dados usando SQLDataSources; solicitar ao usuário uma fonte de dados, uma ID de usuário e uma senha; e, em seguida, chame SQLConnect.

O SQLConnect pressupõe que um nome de fonte de dados, uma ID de usuário e uma senha são suficientes para se conectar a uma fonte de dados e que a fonte de dados ODBC contém todas as outras informações que o driver ODBC precisa para fazer a conexão. Ao contrário de SQLDriverConnect e SQLBrowseConnect, o SQLConnect não usa uma cadeia de conexão.

SQLDriverConnect

O SQLDriverConnect é usado quando mais informações do que o nome da fonte de dados, a ID do usuário e a senha são necessárias. Um dos parâmetros para SQLDriverConnect é uma cadeia de conexão que contém informações específicas do driver. Você pode usar SQLDriverConnect em vez de SQLConnect pelos seguintes motivos:

  • Para especificar informações específicas do driver no momento da conexão.

  • Para solicitar que o driver solicite ao usuário informações de conexão.

  • Para se conectar sem usar uma fonte de dados ODBC.

A cadeia de conexão SQLDriverConnect contém uma série de pares de palavra-chave-valor que especificam todas as informações de conexão compatíveis com um driver ODBC. Cada driver dá suporte às palavras-chave ODBC padrão (DSN, FILEDSN, DRIVER, UID, PWD e SAVEFILE), além de palavras-chave específicas do driver para todas as informações de conexão compatíveis com o driver. O SQLDriverConnect pode ser usado para se conectar sem uma fonte de dados. Por exemplo, um aplicativo projetado para fazer uma conexão "sem DSN" para uma instância do SQL Server pode chamar o SQLDriverConnect com uma cadeia de conexão que define a ID de logon, senha, biblioteca de rede, nome do servidor ao qual se conectar e banco de dados padrão a ser usado.

Ao usar o SQLDriverConnect, há duas opções para solicitar ao usuário informações de conexão necessárias:

  • Caixa de diálogo aplicativo

    Você pode criar uma caixa de diálogo de aplicativo que solicita informações de conexão e, em seguida, chama SQLDriverConnect com um identificador de janela NULL e DriverCompletion definido como SQL_DRIVER_NOPROMPT. Essas configurações de parâmetro impedem que o driver ODBC abra sua própria caixa de diálogo. Esse método é usado quando é importante controlar a interface do usuário do aplicativo.

  • Caixa de diálogo Driver

    Você pode codificar o aplicativo para passar um identificador de janela válido para SQLDriverConnect e definir o parâmetro DriverCompletion como SQL_DRIVER_COMPLETE, SQL_DRIVER_PROMPT ou SQL_DRIVER_COMPLETE_REQUIRED. Em seguida, o driver gera uma caixa de diálogo para solicitar ao usuário informações de conexão. Esse método simplifica o código do aplicativo.

SQLBrowseConnect

SQLBrowseConnect, como SQLDriverConnect, usa uma cadeia de conexão. No entanto, usando SQLBrowseConnect, um aplicativo pode construir uma cadeia de conexão completa iterativamente com a fonte de dados em tempo de execução. Isso permite que o aplicativo faça duas coisas:

  • Crie suas próprias caixas de diálogo para solicitar essas informações, mantendo assim o controle sobre sua interface do usuário.

  • Navegue pelo sistema em busca de fontes de dados que possam ser usadas por um driver específico, possivelmente em várias etapas.

    Por exemplo, o usuário pode primeiro procurar servidores na rede e, depois de escolher um servidor, procurar o servidor para bancos de dados acessíveis pelo driver.

Quando o SQLBrowseConnect conclui uma conexão bem-sucedida, ele retorna uma cadeia de conexão que pode ser usada em chamadas subsequentes para SQLDriverConnect.

O driver ODBC do SQL Server Native Client sempre retorna SQL_SUCCESS_WITH_INFO em um SQLConnect, SQLDriverConnect ou SQLBrowseConnect bem-sucedido. Quando um aplicativo ODBC chama SQLGetDiagRec após obter SQL_SUCCESS_WITH_INFO, ele pode receber as seguintes mensagens:

5701
Indica que o SQL Server colocou o contexto do usuário no banco de dados padrão definido na fonte de dados ou no banco de dados padrão definido para a ID de logon usada na conexão se a fonte de dados não tiver um banco de dados padrão.

5703
Indica o idioma que está sendo usado no servidor.

O exemplo a seguir mostra a mensagem retornada em uma conexão bem-sucedida pelo administrador do sistema:

szSqlState = "01000", *pfNativeError = 5701,  
szErrorMsg="[Microsoft][SQL Server Native Client][SQL Server]  
       Changed database context to 'pubs'."  
szSqlState = "01000", *pfNativeError = 5703,  
szErrorMsg="[Microsoft][SQL Server Native Client][SQL Server]  
       Changed language setting to 'us_english'."

Você pode ignorar as mensagens 5701 e 5703; eles são apenas informativos. No entanto, você não deve ignorar um código de retorno SQL_SUCCESS_WITH_INFO porque mensagens diferentes de 5701 ou 5703 podem ser retornadas. Por exemplo, se um driver se conectar a um servidor executando uma instância do SQL Server com procedimentos armazenados de catálogo desatualizados, um dos erros retornados por meio do SQLGetDiagRec após um SQL_SUCCESS_WITH_INFO é:

SqlState:   01000  
pfNative:   0  
szErrorMsg: "[Microsoft][SQL Server Native Client]The ODBC  
            catalog stored procedures installed on server  
            my65server are version 06.50.0193; version 07.00.0205  
            or later is required to ensure proper operation.  
            Please contact your system administrator."

A função de tratamento de erros de um aplicativo para conexões do SQL Server deve chamar SQLGetDiagRec até que ele retorne SQL_NO_DATA. Em seguida, ele deve agir em qualquer mensagem diferente daquelas com um código pfNative de 5701 ou 5703.

Consulte Também

Comunicando-se com o SQL Server (ODBC)

  • Last updated on