Partilhar via


Formato e atributos da cadeia de conexão

Importante

Esse recurso será removido em uma versão futura do Windows. Evite usar esse recurso em um novo trabalho de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Em vez disso, use o driver ODBC fornecido pela Oracle.

Em vez de usar uma caixa de diálogo, alguns aplicativos podem exigir uma cadeia de conexão que especifica informações de conexão da fonte de dados. A cadeia de conexão é composta por vários atributos que especificam como um driver se conecta a uma fonte de dados. Um atributo identifica uma informação específica que o driver precisa saber antes de fazer a conexão de fonte de dados apropriada. Cada driver pode ter um conjunto diferente de atributos, mas o formato de cadeia de conexão é sempre o mesmo. Uma cadeia de conexão tem o seguinte formato:

"DSN=data-source-name[;SERVER=value] [;PWD=value] [;UID=value] [;<Attribute>=<value>]"  

Observação

O Microsoft ODBC Driver for Oracle dá suporte ao formato de cadeia de conexão da primeira versão do driver, que usou CONNECTSTRING= em vez de SERVER=.

Se você estiver se conectando a um provedor de fonte de dados que dê suporte à autenticação do Windows, especifique Trusted_Connection=yes em vez de informações de ID de usuário e senha na cadeia de conexão.

Você deve especificar o nome da fonte de dados se não especificar os atributos UID, PWD, SERVER (ou CONNECTSTRING) e DRIVER. No entanto, todos os outros atributos são opcionais. Se você não especificar um atributo, esse atributo usará como padrão aquele especificado na guia DSN relevante da caixa de diálogo administrador da fonte de dados ODBC. O valor do atributo pode diferenciar maiúsculas de minúsculas.

Os atributos da cadeia de conexão são os seguintes:

Atributo Descrição Valor padrão
DSN O nome da fonte de dados listado na guia Drivers da caixa de diálogo Administrador da Fonte de Dados ODBC. ""
PWD A senha do Oracle Server que você deseja acessar. Esse driver dá suporte a limitações que o Oracle coloca em senhas. ""
SERVIDOR A cadeia de conexão para o Oracle Server que você deseja acessar. ""
Identificador Único (UID) O nome de usuário do Oracle Server. Dependendo do sistema, esse atributo pode não ser opcional, ou seja, determinados bancos de dados e tabelas podem exigir esse atributo para fins de segurança.

Use "/" para usar a autenticação do sistema operacional da Oracle.
""
BUFFERSIZE O tamanho ideal do buffer usado ao buscar colunas.

O driver otimiza a busca para que uma busca do Oracle Server retorne linhas suficientes para preencher um buffer desse tamanho. Valores maiores tendem a aumentar o desempenho se você buscar muitos dados.
65535
SYNONYMCOLUMNS Quando esse valor é true (1), uma chamada à API SQLColumn( ) retorna informações de coluna. Caso contrário, SQLColumn( ) retorna apenas colunas para tabelas e exibições. O Driver ODBC para Oracle fornece acesso mais rápido quando esse valor não é definido. 1
COMENTÁRIOS Quando esse valor for true (1), o driver retornará colunas de Comentários para o conjunto de resultados SQLColumns. O Driver ODBC para Oracle fornece acesso mais rápido quando esse valor não é definido. 0
StdDayOfWeek Impõe o padrão ODBC para o escalar DAYOFWEEK. Por padrão, isso é ativado, mas os usuários que precisam da versão localizada podem alterar o comportamento para usar o que o Oracle retornar. 1
GuessTheColDef Especifica se o driver deve ou não retornar um valor diferente de zero para o argumento cbColDef de SQLDescribeCol. Aplica-se somente a colunas em que não há nenhuma escala definida pelo Oracle, como colunas numéricas computadas e colunas definidas como NÚMERO sem precisão ou escala. Uma chamada SQLDescribeCol retorna 130 para a precisão quando o Oracle não fornece essas informações. 0

Por exemplo, uma cadeia de conexão que se conecta à fonte de dados MyDataSource usando o Servidor MyOracleServerOracle e o Usuário Oracle MyUserID seria:

"DSN={MyDataSource};UID={MyUserID};PWD={MyPassword};SERVER={MyOracleServer}"  

Uma cadeia de conexão que se conecta à fonte de dados MyOtherDataSource usando a autenticação do sistema operacional e o Servidor MyOtherOracleServerOracle seria:

"DSN=MyOtherDataSource;UID=/;PWD=;SERVER=MyOtherOracleServer"