Conectar-se usando fontes de dados de arquivo
As informações de conexão para uma fonte de dados de arquivo são armazenadas em um arquivo .dsn. Como resultado, a cadeia de conexão pode ser usada repetidamente por um único usuário ou compartilhada entre vários usuários se eles tiverem o driver apropriado instalado. O arquivo contém um nome de driver (ou outro nome de fonte de dados no caso de uma fonte de dados de arquivo não compartilhável) e, opcionalmente, uma cadeia de conexão que pode ser usada pelo SQLDriverConnect. O Gerenciador de Driver cria a cadeia de conexão para a chamada para SQLDriverConnect a partir das palavras-chave no arquivo .dsn.
Uma fonte de dados de arquivo permite que um aplicativo especifique opções de conexão sem precisar criar uma cadeia de conexão para usar com SQLDriverConnect. A fonte de dados do arquivo geralmente é criada especificando a palavra-chave SAVEFILE, que faz com que o Gerenciador de Driver salve a cadeia de conexão de saída criada por uma chamada para SQLDriverConnect no arquivo .dsn. Essa cadeia de conexão pode ser usada repetidamente chamando SQLDriverConnect com a palavra-chave FILEDSN. Isso simplifica o processo de conexão e fornece uma fonte persistente da cadeia de conexão.
As fontes de dados de arquivo também podem ser criadas chamando SQLCreateDataSource na DLL do instalador. As informações podem ser gravadas no arquivo .dsn chamando SQLWriteFileDSN e lidas do arquivo .dsn chamando SQLReadFileDSN; ambas as funções também estão na DLL do instalador. Para obter informações sobre a DLL do instalador, consulte Configurando fontes de dados.
As palavras-chave usadas para informações de conexão estão na seção [ODBC] de um arquivo .dsn. As informações mínimas que um arquivo .dsn compartilhável teria na seção [ODBC] são a palavra-chave DRIVER:
DRIVER = SQL Server
O arquivo .dsn compartilhável geralmente contém uma cadeia de conexão, da seguinte maneira:
DRIVER = SQL Server
UID = Larry
DATABASE = MyDB
Quando a fonte de dados do arquivo não é compartilhável, o arquivo .dsn contém apenas uma palavra-chave DSN. Quando o Gerenciador de Driver recebe as informações em uma fonte de dados de arquivo não compartilhável, ele se conecta conforme necessário à fonte de dados indicada pela palavra-chave DSN. Um arquivo .dsn não compartilhável conteria a seguinte palavra-chave:
DSN = MyDataSource
A cadeia de conexão usada para uma fonte de dados de arquivo é a união das palavras-chave especificadas no arquivo .dsn e as palavras-chave especificadas na cadeia de conexão na chamada para SQLDriverConnect. Se qualquer uma das palavras-chave no arquivo .dsn entrar em conflito com palavras-chave na cadeia de conexão, o Gerenciador de Driver decide qual valor de palavra-chave deve ser usado. Para obter mais informações, consulte SQLDriverConnect.