Share via

  • Artigo

Usando palavras-chave da cadeia de conexão com o SQL Server Native Client

Algumas APIs do SQL Server Native Client usam cadeias de conexão para especificar atributos de conexão. Cadeias de conexão são listas de palavras-chave e valores associados; cada palavra-chave identifica um atributo de conexão específico.

ObservaçãoObservação

O SQL Server Native Client permite ambigüidade em cadeias de conexão a fim de manter a compatibilidade com versões anteriores (por exemplo, algumas palavras-chave podem ser especificadas mais de uma vez e outras, conflitantes, permitidas tendo a resolução baseada na posição ou na precedência). Futuras versões do SQL Server Native Client talvez não permitam ambigüidade em cadeias de conexão. Trata-se de uma boa prática, ao modificar aplicativos, usar o SQL Server Native Client para eliminar todas as dependências relacionadas à ambigüidade da cadeia de conexão.

As seguintes seções descrevem as palavras-chave que podem ser usadas com o provedor OLE DB do SQL Server Native Client, o driver ODBC do SQL Server Native Client e o ADO (ActiveX Data Objects) durante o uso do SQL Server Native Client como provedor de dados.

Palavras-chave da cadeia de conexão do provedor OLE DB

Os aplicativos OLE DB podem inicializar objetos de fonte de dados de duas formas:

  • IDBInitialize::Initialize

  • IDataInitialize::GetDataSource

No primeiro caso, uma cadeia de caracteres do provedor pode ser usada para inicializar as propriedades da conexão, definindo a propriedade DBPROP_INIT_PROVIDERSTRING no conjunto de propriedades DBPROPSET_DBINIT. No segundo, uma cadeia de caracteres de inicialização pode ser passada para o método IDataInitialize::GetDataSource a fim de inicializar as propriedades da conexão. Ambos os métodos inicializam as mesmas propriedades de conexão OLE DB, embora sejam usados conjuntos diferentes de palavras-chave. O conjunto de palavras-chave usado por IDataInitialize::GetDataSource é, no mínimo, a descrição das propriedades dentro do grupo de propriedades de inicialização.

As propriedades booleanas definidas nas cadeias de caracteres do provedor por meio dos valores DBPROP_INIT_PROVIDERSTRING são definidas usando os valores "sim" e "não". As propriedades booleanas definidas nas cadeias de caracteres de inicialização que usam IDataInitialize::GetDataSource são definidas usando os valores "verdadeiro" e "falso".

Os aplicativos que usam IDataInitialize::GetDataSource também podem usar as palavras-chave usadas por IDBInitialize::Initialize, mas só para propriedades que não tenham um valor padrão. Caso um aplicativo use ambas as palavras-chave IDataInitialize::GetDataSource e IDBInitialize::Initialize na cadeia de caracteres de inicialização, é usada a definição da palavra-chave IDataInitialize::GetDataSource. É altamente recomendável que os aplicativos não usem palavras-chave IDBInitialize::Initialize em cadeias de conexão IDataInitialize:GetDataSource, uma vez que esse comportamento talvez não seja mantido em versões futuras.

ObservaçãoObservação

Uma cadeia de conexão passada por meio de IDataInitialize::GetDataSource é convertida em propriedades e aplicada por meio de IDBProperties::SetProperties. Se os serviços de componente encontraram a descrição de propriedade em IDBProperties::GetPropertyInfo, a propriedade será aplicada como uma propriedade autônoma. Caso contrário, ela será aplicada por meio da propriedade DBPROP_PROVIDERSTRING. Por exemplo, se você especificar a cadeia de conexão Data Source=server1;Server=server2, Data Source será definido como uma propriedade, mas Server entrará na cadeia do provedor.

Se você especificar várias instâncias da mesma propriedade específica do provedor, o primeiro valor da primeira propriedade será usado.

As cadeias de conexão usadas por aplicativos OLE DB que usam DBPROP_INIT_PROVIDERSTRING com IDBInitialize::Initialize têm a seguinte sintaxe:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=[{]attribute-value[}]

attribute-value ::= character-string

attribute-keyword ::= identifier

Os valores de atributo podem ser colocados entre chaves, sendo uma boa prática fazer isso. Isso evita problemas quando os valores de atributo contêm caracteres não alfanuméricos. Como a primeira chave de fechamento no valor deve encerrá-lo, os valores não podem conter caracteres de chave de fechamento.

Um caractere de espaço após o sinal de igual (=) de uma palavra-chave da cadeia de conexão será interpretado como um literal, mesmo que o valor seja colocado entre aspas.

A seguinte tabela descreve as palavras-chave que podem ser usadas com DBPROP_INIT_PROVIDERSTRING.

Palavra-chave

Propriedade de inicialização

Descrição

Addr

SSPROP_INIT_NETWORKADDRESS

Sinônimo de "Endereço".

Address

SSPROP_INIT_NETWORKADDRESS

O endereço de rede de uma instância do SQL Server na organização.

Para obter mais informações sobre a sintaxe de endereço válida, consulte a descrição da palavra-chave do ODBC Address posteriormente neste tópico.

APP

SSPROP_INIT_APPNAME

A cadeia de caracteres que identifica o aplicativo.

AttachDBFileName

SSPROP_INIT_FILENAME

O nome do arquivo primário (com o nome do caminho completo incluído) de um banco de dados anexável. Para usar AttachDBFileName, você também deve especificar o nome do banco de dados com a palavra-chave Database da cadeia de caracteres do provedor. Caso o banco de dados já tenha sido anexado, o SQL Server não o anexa novamente (ele usa o banco de dados anexado como sendo o padrão da conexão).

Auto Translate

SSPROP_INIT_AUTOTRANSLATE

Sinônimo de "Tradução automática".

AutoTranslate

SSPROP_INIT_AUTOTRANSLATE

Configura a conversão de caracteres OEM/ANSI. Os valores reconhecidos são "sim" e "não".

Database

DBPROP_INIT_CATALOG

O nome do banco de dados.

DataTypeCompatibility

SSPROP_INIT_DATATYPECOMPATIBILITY

Especifica o modo de manipulação do tipo de dados a ser usado. Os valores reconhecidos são "0" para tipos de dados do provedor e "80" para tipos de dados do SQL Server 2000.

Encrypt

SSPROP_INIT_ENCRYPT

Especifica se os dados devem ser criptografados antes de serem enviados pela rede. Os valores possíveis são "sim" e "não". O valor padrão é "não".

FailoverPartner

SSPROP_INIT_FAILOVERPARTNER

O nome do servidor de failover usado no espelhamento de banco de dados.

FailoverPartnerSPN

SSPROP_INIT_FAILOVERPARTNERSPN

O SPN do parceiro de failover. O valor padrão é uma cadeia de caracteres vazia. Uma cadeia de caracteres vazia faz com que o SQL Server Native Client use o SPN padrão, gerado pelo provedor.

Language

SSPROPT_INIT_CURRENTLANGUAGE

O idioma do SQL Server.

MarsConn

SSPROP_INIT_MARSCONNECTION

Habilita ou desabilita MARS (vários conjuntos de resultados ativos) na conexão caso o servidor seja o SQL Server 2005 ou posterior. Os valores possíveis são "sim" e "não". O valor padrão é "não".

Net

SSPROP_INIT_NETWORKLIBRARY

Sinônimo de "Rede".

Network

SSPROP_INIT_NETWORKLIBRARY

A biblioteca de rede usada para estabelecer uma conexão com uma instância do SQL Server na organização.

Network Library

SSPROP_INIT_NETWORKLIBRARY

Sinônimo de "Rede".

PacketSize

SSPROP_INIT_PACKETSIZE

Tamanho do pacote de rede. O padrão é 0, o que significa que o servidor configurará o tamanho do pacote com base na configuração de sp_configure 'network packet size'.

PersistSensitive

DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO

Aceita as cadeias de caracteres "sim" e "não" como valores. Em caso de "não", o objeto de fonte de dados não tem permissão para manter informações confidenciais de autenticação

PWD

DBPROP_AUTH_PASSWORD

A senha de logon do SQL Server.

Server

DBPROP_INIT_DATASOURCE

O nome de uma instância do SQL Server na organização.

Quando não especificado, uma conexão é estabelecida com a instância padrão no computador local.

Para obter mais informações sobre sintaxe de endereço válida, consulte a descrição da palavra-chave do ODBC Server neste tópico.

ServerSPN

SSPROP_INIT_SERVERSPN

O SPN do servidor. O valor padrão é uma cadeia de caracteres vazia. Uma cadeia de caracteres vazia faz com que o SQL Server Native Client use o SPN padrão, gerado pelo provedor.

Timeout

DBPROP_INIT_TIMEOUT

O tempo (em segundos) para aguardar a conclusão da inicialização da fonte de dados.

Trusted_Connection

DBPROP_AUTH_INTEGRATED

Em caso de "sim", instrui o provedor OLE DB do SQL Server Native Client a usar o modo de Autenticação do Windows na validação do logon. Do contrário, instrui o provedor OLE DB do SQL Server Native Client a usar um nome de usuário e uma senha do SQL Server na validação do logon, e as palavras-chave UID e PWD devem ser especificadas.

TrustServerCertificate

SSPROP_INIT_TRUST_SERVER_CERTIFICATE

Aceita as cadeias de caracteres "sim" e "não" como valores. O valor padrão é "não", o que significa que o certificado do servidor será validado.

UID

DBPROP_AUTH_USERID

O nome de logon do SQL Server.

UseProcForPrepare

SSPROP_INIT_USEPROCFORPREP

A palavra-chave é preterida e a configuração, ignorada pelo provedor OLE DB do SQL Server Native Client.

WSID

SSPROP_INIT_WSID

O identificador da estação de trabalho.

As cadeias de conexão usadas por aplicativos OLE DB que usam IDataInitialize::GetDataSource têm a seguinte sintaxe:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=[quote]attribute-value[quote]

attribute-value ::= character-string

attribute-keyword ::= identifier

quote ::= " | '

O uso de propriedades deve estar em conformidade com a sintaxe permitida em seu escopo. Por exemplo, WSID usa chaves ({}) para caracteres de aspas e Application Name usa caracteres de aspas simples (') ou duplas ("). Somente propriedades de cadeia de caracteres podem ser colocadas entre aspas. A tentativa de colocar entre aspas um inteiro ou propriedade enumerada resultará em um erro.

Os valores de atributo podem ser colocados entre aspas simples ou duplas, sendo uma boa prática fazer isso. Isso evita problemas quando os valores contêm caracteres não alfanuméricos. O caractere aspas usado também pode ser exibido em valores, desde que seja dobrado.

Um caractere de espaço após o sinal de igual de uma palavra-chave da cadeia de conexão será interpretado como um literal, mesmo que o valor seja colocado entre aspas.

Se uma cadeia de conexão tiver mais de uma das propriedades a seguir, o valor da última propriedade será usado.

A seguinte tabela descreve as palavras-chave que podem ser usadas com IDataInitialize::GetDataSource:

Palavra-chave

Propriedade de inicialização

Descrição

Application Name

SSPROP_INIT_APPNAME

A cadeia de caracteres que identifica o aplicativo.

Auto Translate

SSPROP_INIT_AUTOTRANSLATE

Sinônimo de "Tradução automática".

AutoTranslate

SSPROP_INIT_AUTOTRANSLATE

Configura a conversão de caracteres OEM/ANSI. Os valores reconhecidos são "verdadeiro" e "falso".

Connect Timeout

DBPROP_INIT_TIMEOUT

O tempo (em segundos) para aguardar a conclusão da inicialização da fonte de dados.

Current Language

SSPROPT_INIT_CURRENTLANGUAGE

O nome do idioma do SQL Server.

Data Source

DBPROP_INIT_DATASOURCE

O nome de uma instância do SQL Server na organização.

Quando não especificado, uma conexão é estabelecida com a instância padrão no computador local.

Para obter mais informações sobre sintaxe de endereço válida, consulte a descrição da palavra-chave do ODBC Server posteriormente neste tópico.

DataTypeCompatibility

SSPROP_INIT_DATATYPECOMPATIBILITY

Especifica o modo de manipulação do tipo de dados a ser usado. Os valores reconhecidos são "0" para tipos de dados de provedor e "80" para tipos de dados do SQL Server 2000.

Failover Partner

SSPROP_INIT_FAILOVERPARTNER

O nome do servidor de failover usado no espelhamento de banco de dados.

Failover Partner SPN

SSPROP_INIT_FAILOVERPARTNERSPN

O SPN do parceiro de failover. O valor padrão é uma cadeia de caracteres vazia. Uma cadeia de caracteres vazia faz com que o SQL Server Native Client use o SPN padrão, gerado pelo provedor.

Initial Catalog

DBPROP_INIT_CATALOG

O nome do banco de dados.

Initial File Name

SSPROP_INIT_FILENAME

O nome do arquivo primário (com o nome do caminho completo incluído) de um banco de dados anexável. Para usar AttachDBFileName, você também deve especificar o nome do banco de dados com a palavra-chave DATABASE da cadeia de caracteres do provedor. Caso o banco de dados já tenha sido anexado, o SQL Server não o anexa novamente (ele usa o banco de dados anexado como sendo o padrão da conexão).

Integrated Security

DBPROP_AUTH_INTEGRATED

Aceita o valor o "SSPI" para a Autenticação do Windows.

MARS Connection

SSPROP_INIT_MARSCONNECTION

Habilita ou desabilita MARS na conexão caso o servidor seja o SQL Server 2005 ou o SQL Server 2008. Os valores reconhecidos são "verdadeiro" e "falso". O padrão é "falso".

Network Address

SSPROP_INIT_NETWORKADDRESS

O endereço de rede de uma instância do SQL Server na organização.

Para obter mais informações sobre sintaxe de endereço válida, consulte a descrição da palavra-chave do ODBC Address posteriormente neste tópico.

Network Library

SSPROP_INIT_NETWORKLIBRARY

A biblioteca de rede usada para estabelecer uma conexão com uma instância do SQL Server na organização.

Packet Size

SSPROP_INIT_PACKETSIZE

Tamanho do pacote de rede. O padrão é 0, o que significa que o servidor configurará o tamanho do pacote com base na configuração de sp_configure 'network packet size'.

Password

DBPROP_AUTH_PASSWORD

A senha de logon do SQL Server.

Persist Security Info

DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO

Aceita as cadeias de caracteres "verdadeiro" e "falso" como valores. Em caso de "falso", o objeto de fonte de dados não tem permissão para manter informações confidenciais de autenticação

Provider

 

No SQL Server Native Client, isso deve ser "SQLNCLI10".

Server SPN

SSPROP_INIT_SERVERSPN

O SPN do servidor. O valor padrão é uma cadeia de caracteres vazia. Uma cadeia de caracteres vazia faz com que o SQL Server Native Client use o SPN padrão, gerado pelo provedor.

Trust Server Certificate

SSPROP_INIT_TRUST_SERVER_CERTIFICATE

Aceita as cadeias de caracteres "verdadeiro" e "falso" como valores. O valor padrão é "falso", o que significa que o certificado do servidor será validado.

Use Encryption for Data

SSPROP_INIT_ENCRYPT

Especifica se os dados devem ser criptografados antes de serem enviados pela rede. Os valores possíveis são "verdadeiro" e "falso". O valor padrão é "falso".

User ID

DBPROP_AUTH_USERID

O nome de logon do SQL Server.

Workstation ID

SSPROP_INIT_WSID

O identificador da estação de trabalho.

Observação   Na cadeia de conexão, a propriedade "Old Password" define SSPROP_AUTH_OLD_PASSWORD, que é a senha atual (provavelmente expirada) que não está disponível por meio de uma propriedade de cadeia de caracteres do provedor.

Palavras-chave da cadeia de conexão do driver ODBC

Os aplicativos ODBC usam cadeias de conexão como parâmetros para as funções SQLDriverConnect e SQLBrowseConnect.

As cadeias de conexão usadas pelo ODBC têm a seguinte sintaxe:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=[{]attribute-value[}]

attribute-value ::= character-string

attribute-keyword ::= identifier

Os valores de atributo podem ser colocados entre chaves, sendo uma boa prática fazer isso. Isso evita problemas quando os valores de atributo contêm caracteres não alfanuméricos. Como a primeira chave de fechamento no valor deve encerrá-lo, os valores não podem conter caracteres de chave de fechamento.

A seguinte tabela descreve as palavras-chave que podem ser usadas com uma cadeia de conexão ODBC.

Palavra-chave

Descrição

Addr

Sinônimo de "Endereço".

Address

O endereço de rede do servidor executando uma instância do SQL Server. O Address é normalmente o nome da rede do servidor, mas pode ter outros nomes como, um pipe, um endereço IP ou uma porta TCP/IP e endereço de soquete.

Se você especificar um endereço IP, verifique se os protocolos de pipes nomeados ou TCP/IP estão habilitados no SQL Server Configuration Manager.

O valor de Address tem precedência sobre o valor transmitido para Server nas cadeias de conexão ODBC ao usar o SQL Server Native Client. Observe também que Address=; conecta-se com o servidor especificado na palavra-chave Server, enquanto que Address= ;, Address=.;, Address=localhost; e Address=(local); estabelecem uma conexão com o servidor local.

A sintaxe completa para a palavra-chave Address é a seguinte:

[protocol:]Address[,port |\pipe\pipename]

protocol pode ser tcp (TCP/IP), lpc (memória compartilhada) ou np (pipes nomeados). Para obter mais informações sobre protocolos, consulte Escolhendo um protocolo de rede.

Se o protocol nem a palavra-chave Network estiver especificada, o SQL Server Native Client usará a ordem de protocolo especificada no SQL Server Configuration Manager.

port é a porta para se conectar ao servidor especificado. Por padrão, o SQL Server usa a porta 1433.

Para obter mais informações sobre protocolos, consulte Escolhendo um protocolo de rede.

AnsiNPW

No caso de "sim", o driver usa comportamentos definidos por ANSI para tratar comparações NULL, preenchimento de dados de caractere, avisos e concatenação NULL. Em caso de "não", os comportamentos definidos por ANSI não são expostos. Para obter mais informações sobre comportamentos NPW ANSI, consulte Efeitos das opções ISO.

APP

Nome do aplicativo que chama SQLDriverConnect (opcional). Em caso de especificação, o valor é armazenado na coluna master.dbo.sysprocessesprogram_name, sendo retornado pelas funções sp_who e APP_NAME.

AttachDBFileName

Nome do arquivo primário de um banco de dados anexável. Inclua o caminho completo e remova todos os caracteres \ caso esteja usando uma variável da cadeia de caracteres C:

AttachDBFileName=c:\\MyFolder\\MyDB.mdf

Esse banco de dados é anexado e torna-se o banco de dados padrão da conexão. Para usar AttachDBFileName, você também deve especificar o nome do banco de dados no parâmetro DATABASE SQLDriverConnect ou no atributo de conexão SQL_COPT_CURRENT_CATALOG. Caso o banco de dados já tenha sido anexado, o SQL Server não o anexa novamente; ele usa o banco de dados anexado como sendo o padrão da conexão.

AutoTranslate

Em caso de "sim, as cadeias de caracteres ANSI enviadas entre o cliente e o servidor são traduzidas com a conversão por Unicode para minimizar problemas na correspondência de caracteres estendidos entre as páginas de código no cliente e no servidor.

Os dados SQL_C_CHAR do cliente enviados para uma variável SQL Serverchar, varchar ou text, parâmetro ou coluna são convertidos de caractere em Unicode usando a ACP (página de código ANSI) e, em seguida, convertidos de Unicode em caractere usando a ACP do servidor.

Os dados SQL Serverchar, varchar ou text enviados para uma variável SQL_C_CHAR do cliente são convertidos de caractere em Unicode usando a ACP do servidor e, em seguida, convertidos de Unicode em caractere usando a ACP do cliente.

As conversões são executadas no cliente pelo driver ODBC do SQL Server Native Client. Isso exige que a mesma ACP usada no servidor esteja disponível no cliente.

Estas configurações não têm nenhum efeito nas conversões que ocorrem para estas transferências:

  • Dados do cliente SQL_C_WCHAR de Unicode enviados para char, varchar ou text no servidor.

  • Dados do servidor char, varchar ou text enviados para uma variável SQL_C_WCHAR de Unicode no cliente.

  • Dados do cliente SQL_C_CHAR de ANSI enviados para nchar, nvarchar ou ntext de Unicode no servidor.

  • Dados do servidor nchar, nvarchar ou ntext de Unicode enviados para uma variável SQL_C_CHAR de ANSI no cliente.

Em caso de "não", a conversão de caracteres não é realizada.

O driver ODBC do SQL Server Native Client não converte dados SQL_C_CHAR de caractere ANSI do cliente enviados para variáveis char, varchar ou text, parâmetros ou colunas no servidor. Nenhuma conversão é realizada nos dados char, varchar ou text enviados do servidor para variáveis SQL_C_CHAR no cliente.

Caso o cliente e o SQL Server estejam usando ACPs diferentes, os caracteres estendidos podem ser mal interpretados.

Database

Nome do banco de dados do SQL Server padrão da conexão. Caso Database não seja especificada, é usado o banco de dados padrão do logon. O banco de dados padrão da fonte de dados ODBC substitui o banco de dados padrão definido para o logon. O banco de dados deve ser um banco de dados existente, a menos que AttachDBFileName também seja especificada. Caso AttachDBFileName também seja especificada, o arquivo primário para o qual aponta é anexado e recebe o nome do banco de dados especificado por Database.

Driver

Nome do driver como retornado por SQLDrivers. O valor de palavra-chave do driver ODBC do SQL Server Native Client é" {SQL Server Native Client 10.0}". A palavra-chave Server é obrigatória caso Driver seja especificada e DriverCompletion esteja definida como SQL_DRIVER_NOPROMPT.

Para obter mais informações sobre nomes de driver, consulte Usando os arquivos de biblioteca e de cabeçalho do SQL Server Native Client.

DSN

Nome de um usuário de ODBC existente ou fonte de dados do sistema. Esta palavra-chave substitui qualquer valor que pode ser especificado no Server, Networke palavras-chave Address.

Encrypt

Especifica se os dados devem ser criptografados antes de serem enviados pela rede. Os valores possíveis são "sim" e "não". O valor padrão é "não".

Fallback

A palavra-chave é preterida e a configuração, ignorada pelo driver ODBC do SQL Server Native Client.

Failover_Partner

Nome do servidor de parceiro de failover a ser usado caso não seja possível estabelecer uma conexão com o servidor primário.

FailoverPartnerSPN

O SPN do parceiro de failover. O valor padrão é uma cadeia de caracteres vazia. Uma cadeia de caracteres vazia faz com que o SQL Server Native Client use o SPN padrão, gerado pelo driver.

FileDSN

Nome de uma fonte de dados do arquivo ODBC existente.

Language

Nome do idioma do SQL Server (opcional). SQL Server pode armazenar mensagens em vários idiomas em sysmessages. Em caso de conexão com a um SQL Server com vários idiomas, Language especifica qual conjunto de mensagens é usado na conexão.

MARS_Connection

Habilita ou desabilita MARS na conexão caso o servidor seja o SQL Server 2005 ou o SQL Server 2008. Os valores reconhecidos são "sim" e "não". O padrão é "não".

Net

Sinônimo de "Rede".

Network

Os valores válidos são dbnmpntw (pipes nomeados) e dbmssocn (TCP/IP).

Para obter mais informações sobre protocolos de rede, consulte Escolhendo um protocolo de rede.

É um erro especificar um valor para a palavra-chave Network e um prefixo de protocolo na palavra-chave Server.

PWD

A senha da conta de logon do SQL Server especificada no parâmetro UID. PWD não precisará ser especificada, se o logon tiver uma senha NULL ou durante o uso da Autenticação do Windows (Trusted_Connection = yes).

QueryLog_On

Em caso de "sim", o registro em log de dados de consultas demoradas é habilitado na conexão. Em caso de "não", os dados de consultas demoradas não são registrados.

QueryLogFile

Caminho completo e nome de um arquivo a ser usado para registrar em log dados de consultas demoradas.

QueryLogTime

Cadeia de caracteres de dígito que especifica o limite (em milissegundos) para registrar em log consultas demoradas. Qualquer consulta que não receba uma resposta na hora especificada é gravada no arquivo de log de consultas demoradas.

QuotedId

Em caso de "sim", QUOTED_IDENTIFIERS é definido como ON para a conexão, o SQL Server usa as regras de ISO referentes ao uso de aspas em instruções SQL. Em caso de "não", QUOTED_IDENTIFIERS é definido como OFF para a conexão, o SQL Server segue as regras herdadas de Transact-SQL referentes ao uso de aspas em instruções SQL. Para obter mais informações, consulte Efeitos das opções ISO.

Regional

Em caso de "sim", o driver ODBC do SQL Server Native Client usa configurações do cliente ao converter dados de moeda, data e hora em dados de caractere. A conversão é apenas um meio; o driver não reconhece formatos padrão que não sejam ODBC para cadeias de caracteres de data ou valores de moeda contidos. Por exemplo, um parâmetro usado em uma instrução INSERT ou UPDATE. Em caso de "não", o driver usa as cadeias de caracteres padrão ODBC para representar dados de moeda, data e hora convertidos em dados de caractere.

SaveFile

Nome de um arquivo de fonte de dados ODBC no qual os atributos da conexão atual serão salvos em caso de êxito na conexão.

Server

O nome de uma instância do SQL Server. O valor deve ser o nome de um servidor na rede, um endereço IP ou o nome de um alias do SQL Server Configuration Manager.

A palavra-chave Address substitui a palavra-chave Server.

Não é possível se conectar à instância padrão no servidor local especificando uma das seguintes:

  • Server=;

  • Server=.;

  • Server=(local);

  • Server=(localhost);

Para especificar uma instância nomeada do SQL Server, anexe \InstanceName.

Quando nenhum servidor está especificado, uma conexão é estabelecida com a instância padrão no computador local.

Se você especificar um endereço IP, verifique se os protocolos de pipes nomeados ou TCP/IP estão habilitados no SQL Server Configuration Manager.

A sintaxe completa para a palavra-chave Server é a seguinte:

Server=[protocol:]Server[,port]

protocol pode ser tcp (TCP/IP), lpc (memória compartilhada) ou np (pipes nomeados). Para obter mais informações sobre protocolos, consulte Escolhendo um protocolo de rede.

O seguinte é um exemplo de como especificar um pipe nomeado:

np:\\.\pipe\MSSQL$MYINST01\sql\query

Esta linha especifica o protocolo de pipe nomeado, um pipe nomeado na máquina local (\\.\pipe), o nome da instância do SQL Server (MSSQL$MYINST01) e o nome padrão do pipe nomeado (sql/query).

Se nem o protocol nem a palavra-chave Network estiver especificada, o SQL Server Native Client usará a ordem de protocolo especificada no SQL Server Configuration Manager.

port é a porta para se conectar ao servidor especificado. Por padrão, o SQL Server usa a porta 1433.

Os espaços são ignorados no começo do valor transmitido para o Server em cadeias de conexão ODBC ao usar o SQL Server Native Client.

ServerSPN

O SPN do servidor. O valor padrão é uma cadeia de caracteres vazia. Uma cadeia de caracteres vazia faz com que o SQL Server Native Client use o SPN padrão, gerado pelo driver.

StatsLog_On

Em caso de "sim", habilita a captura dos dados de desempenho do driver ODBC do SQL Server Native Client. Em caso de "não", os dados de desempenho do driver ODBC do SQL Server Native Client não permanecem disponíveis na conexão.

StatsLogFile

Caminho completo e nome de um arquivo usado para registrar estatísticas de desempenho do driver ODBC SQL Server Native Client.

Trusted_Connection

Em caso de "sim", instrui o driver ODBC do SQL Server Native Client a usar o modo de Autenticação do Windows na validação do logon. Do contrário, instrui o driver ODBC do SQL Server Native Client a usar um nome de usuário e uma senha do SQL Server na validação do logon, e as palavras-chave UID e PWD devem ser especificadas.

TrustServerCertificate

Quando usado com Encrypt, habilita a criptografia que usa um certificado do servidor auto-assinado.

UID

Uma conta de logon do SQL Server válida. O UID não precisa ser especificado durante o uso da Autenticação do Windows.

UseProcForPrepare

A palavra-chave é preterida e a configuração, ignorada pelo driver ODBC do SQL Server Native Client.

WSID

A ID da estação de trabalho. Normalmente, trata-se do nome de rede do computador em que está o aplicativo (opcional). Caso especificado, o valor é armazenado na coluna master.dbo.sysprocesseshostname e retornado por sp_who e pela função HOST_NAME.
ObservaçãoObservação

As configurações regionais de conversão se aplicam a tipos de dados de moeda, numérico, data e hora. A configuração da conversão só se aplica à conversão de saída, sendo visível apenas quando valores de moeda, número, data ou hora são convertidos em cadeias de caracteres.

O driver ODBC do SQL Server Native Client usa as configurações do Registro de localidade do usuário atual. O driver não honra a localidade do thread atual caso o aplicativo a defina após a conexão, por exemplo, chamando SetThreadLocale.

A alteração do comportamento regional de uma fonte de dados pode fazer o aplicativo falhar. Um aplicativo que analisa cadeias de caracteres de data e espera que elas sejam exibidas conforme definição do ODBC poderia ser afetado negativamente pela alteração desse valor.

Palavras-chave da cadeia de conexão do ADO (ActiveX Data Objects)

Os aplicativos ADO definem a propriedade ConnectionString dos objetos ADODBConnection ou fornecem uma cadeia de conexão como um parâmetro ao método Open de objetos ADODBConnection.

Os aplicativos ADO também podem usar as palavras-chave usadas pelo método IDBInitialize::Initialize do OLE DB, mas só para propriedades que não tenham um valor padrão. Se um aplicativo usar as palavras-chave do ADO e IDBInitialize::Initialize na cadeia de caracteres de inicialização, a configuração da palavra-chave do ADO será usada. É altamente recomendável que os aplicativos só usem palavras-chave da cadeia de conexão do ADO.

As cadeias de conexão usadas pelo ADO têm a seguinte sintaxe:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=["]attribute-value["]

attribute-value ::= character-string

attribute-keyword ::= identifier

Os valores de atributo podem ser colocados entre aspas duplas, sendo uma boa prática fazer isso. Isso evita problemas quando os valores contêm caracteres não alfanuméricos. Os valores de atributo não podem conter aspas duplas.

A seguinte tabela descreve as palavras-chave que podem ser usadas com uma cadeia de conexão do ADO:

Palavra-chave

Propriedade de inicialização

Descrição

Application Name

SSPROP_INIT_APPNAME

A cadeia de caracteres que identifica o aplicativo.

Auto Translate

SSPROP_INIT_AUTOTRANSLATE

Sinônimo de "Tradução automática".

AutoTranslate

SSPROP_INIT_AUTOTRANSLATE

Configura a conversão de caracteres OEM/ANSI. Os valores reconhecidos são "verdadeiro" e "falso".

Connect Timeout

DBPROP_INIT_TIMEOUT

O tempo (em segundos) para aguardar a conclusão da inicialização da fonte de dados.

Current Language

SSPROPT_INIT_CURRENTLANGUAGE

O nome do idioma do SQL Server.

Data Source

DBPROP_INIT_DATASOURCE

O nome de uma instância do SQL Server na organização.

Quando não especificado, uma conexão é estabelecida com a instância padrão no computador local.

Para obter mais informações sobre sintaxe de endereço válida, consulte a descrição da palavra-chave do ODBC Server neste tópico.

DataTypeCompatibility

SSPROP_INIT_DATATYPECOMPATIBILITY

Especifica o modo de manuseio do tipo de dados a ser usado. Os valores reconhecidos são "0" para tipos de dados do provedor e "80" para tipos de dados do SQL Server 2000.

Failover Partner

SSPROP_INIT_FAILOVERPARTNER

O nome do servidor de failover usado no espelhamento de banco de dados.

Failover Partner SPN

SSPROP_INIT_FAILOVERPARTNERSPN

O SPN do parceiro de failover. O valor padrão é uma cadeia de caracteres vazia. Uma cadeia de caracteres vazia faz com que o SQL Server Native Client use o SPN padrão, gerado pelo provedor.

Initial Catalog

DBPROP_INIT_CATALOG

O nome do banco de dados.

Initial File Name

SSPROP_INIT_FILENAME

O nome do arquivo primário (com o nome do caminho completo incluído) de um banco de dados anexável. Para usar AttachDBFileName, você também deve especificar o nome do banco de dados com a palavra-chave DATABASE da cadeia de caracteres do provedor. Caso o banco de dados já tenha sido anexado, o SQL Server não o anexa novamente (ele usa o banco de dados anexado como sendo o padrão da conexão).

Integrated Security

DBPROP_AUTH_INTEGRATED

Aceita o valor o "SSPI" para a Autenticação do Windows.

MARS Connection

SSPROP_INIT_MARSCONNECTION

Habilita ou desabilita MARS na conexão caso o servidor seja SQL Server 2005 ou posterior. Os valores reconhecidos são "verdadeiro" e "falso".O padrão é "falso".

Network Address

SSPROP_INIT_NETWORKADDRESS

O endereço de rede de uma instância do SQL Server na organização.

Para obter mais informações sobre sintaxe de endereço válida, consulte a descrição da palavra-chave do ODBC Address neste tópico.

Network Library

SSPROP_INIT_NETWORKLIBRARY

A biblioteca de rede usada para estabelecer uma conexão com uma instância do SQL Server na organização.

Packet Size

SSPROP_INIT_PACKETSIZE

Tamanho do pacote de rede. O padrão é 0, o que significa que o servidor configurará o tamanho do pacote com base na configuração de sp_configure 'network packet size'.

Password

DBPROP_AUTH_PASSWORD

A senha de logon do SQL Server.

Persist Security Info

DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO

Aceita as cadeias de caracteres "verdadeiro" e "falso" como valores. Quando "falso", o objeto de fonte de dados não tem permissão para manter informações confidenciais de autenticação.

Provider

 

No SQL Server Native Client, isso deve ser "SQLNCLI10".

Server SPN

SSPROP_INIT_SERVERSPN

O SPN do servidor. O valor padrão é uma cadeia de caracteres vazia. Uma cadeia de caracteres vazia faz com que o SQL Server Native Client use o SPN padrão, gerado pelo provedor.

Trust Server Certificate

SSPROP_INIT_TRUST_SERVER_CERTIFICATE

Aceita as cadeias de caracteres "verdadeiro" e "falso" como valores. O valor padrão é "falso", o que significa que o certificado do servidor será validado.

Use Encryption for Data

SSPROP_INIT_ENCRYPT

Especifica se os dados devem ser criptografados antes de serem enviados pela rede. Os valores possíveis são "verdadeiro" e "falso". O valor padrão é "falso".

User ID

DBPROP_AUTH_USERID

O nome de logon do SQL Server.

Workstation ID

SSPROP_INIT_WSID

O identificador da estação de trabalho.

Observação   Na cadeia de conexão, a propriedade "Old Password" define SSPROP_AUTH_OLD_PASSWORD, que é a senha atual (provavelmente expirada) que não está disponível por meio de uma propriedade de cadeia de caracteres do provedor.

Histórico de alterações

Conteúdo atualizado

A descrição de SSPROP_INIT_PACKETSIZE foi atualizada.