Atributos e formato da cadeia de conexão
Importante
Esse recurso será removido em uma versão futura do Windows. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. 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. O cadeia de conexão é composto 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 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 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 a autenticação do Windows, especifique Trusted_Connection=yes em vez de informações de ID de usuário e senha no 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 para o 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. | "" |
| SERVER | A cadeia de conexão para o Oracle Server que você deseja acessar. | "" |
| 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( ) retornará apenas colunas para tabelas e exibições. O Driver ODBC para Oracle fornece acesso mais rápido quando esse valor não está definido. | 1 |
| COMENTÁRIOS | Quando esse valor é true (1), o driver retorna colunas Remarks para o conjunto de resultados SQLColumns . O Driver ODBC para Oracle fornece acesso mais rápido quando esse valor não está 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á escala definida pelo Oracle, como colunas numéricas computadas e colunas definidas como NUMBER 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, um 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}"
Um 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"