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.
.gif "Observação") Observação |
|---|
O SQL Server Native Client permite ambiguidade 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 ambiguidade 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 à ambiguidade 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 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 é usada para encerrar o valor, 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 Configurar protocolos de cliente. 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. |
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). Se especificado, o valor é armazenado na coluna master.dbo.sysprocesses program_name, sendo retornado pelas funções sp_who e APP_NAME. |
ApplicationIntent |
Declara o tipo de carga de trabalho de aplicativo ao conectar-se a um servidor. Os valores possíveis são ReadOnly e ReadWrite. Por exemplo: O padrão é ReadWrite. Para obter mais informações sobre o suporte do SQL Server Native Client para Grupos de Disponibilidade AlwaysOn, consulte Suporte do SQL Server Native Client à alta disponibilidade e recuperação de desastre. |
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 Server char, 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 Server char, 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:
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 11.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 possa ser especificado nas palavras-chave Server, Network e 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). O 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 (Multiple Active Result Sets) na conexão. Os valores reconhecidos são "sim" e "não". O padrão é "não". |
MultiSubnetFailover |
Sempre especifique multiSubnetFailover=Yes quando for se conectar ao ouvinte de grupo de disponibilidade de um grupo de disponibilidade do SQL Server 2012 ou de uma instância de cluster de failover do SQL Server 2012. multiSubnetFailover=Yes configura o SQL Server Native Client para fornecer detecção mais rápida de e conexão para o servidor (atualmente) ativo. Os valores possíveis são Yes e No. Por exemplo: O padrão é No. Para obter mais informações sobre o suporte do SQL Server Native Client para Grupos de Disponibilidade AlwaysOn, consulte Suporte do SQL Server Native Client à alta disponibilidade e recuperação de desastre. |
Net |
Sinônimo de "Rede". |
Network |
Os valores válidos são dbnmpntw (pipes nomeados) e dbmssocn (TCP/IP). É um erro especificar um valor para a palavra-chave Network e um prefixo de protocolo na palavra-chave Server. |
PWD |
A senha para a conta de login para o SQL Server especificada no parâmetro UID. O PWD não precisa ser especificado se o logon tiver uma senha NULL ou ao usar 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. Quando não, QUOTED_IDENTIFIERS será definido como OFF para a conexão. O SQL Server segue as regras de Transact-SQL herdadas em relação 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:
Para obter mais informações sobre o suporte ao LocalDB, consulte Suporte do SQL Server Native Client para LocalDB. 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). O seguinte é um exemplo de como especificar um pipe nomeado: 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 autoassinado. |
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.sysprocesses hostname e retornado por sp_who e pela função HOST_NAME. |
| Observaçã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 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.
Qualquer configuração da cadeia de caracteres do provedor tem uma propriedade OLE DB correspondente definida com um valor padrão ou explicitamente definida com um valor; o valor de propriedade OLE DB substituirá a configuração na cadeia de caracteres do provedor.
As propriedades boolianas 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 boolianas 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çã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 da propriedade em IDBProperties::GetPropertyInfo, essa 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 de um 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 é usada para encerrar o valor, 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 de cadeia de conexão será interpretado como um literal, mesmo que o valor seja colocado entre aspas.
A tabela a seguir 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. |
ApplicationIntent |
SSPROP_INIT_APPLICATIONINTENT |
Declara o tipo de carga de trabalho de aplicativo ao conectar-se a um servidor. Os valores possíveis são ReadOnly e ReadWrite. O padrão é ReadWrite. Para obter mais informações sobre o suporte do SQL Server Native Client para Grupos de Disponibilidade AlwaysOn, consulte Suporte do SQL Server Native Client à alta disponibilidade e recuperação de desastre. |
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 na conexão caso o servidor seja 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 é 4096. |
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 caracteres de chaves ({}) e Application Name usa caracteres de aspas simples (') ou de aspas duplas ("). Apenas propriedades de cadeia de caracteres podem ser colocadas entre aspas. A tentativa de colocar um número inteiro ou propriedade enumerada entre aspas resultará no erro: "A Cadeia de Conexão não está de acordo com a especificação OLE DB".
Opcionalmente, os valores de atributos podem ser colocados entre aspas simples ou duplas, o que é uma boa prática. Isso evita problemas quando os valores contêm caracteres não alfanuméricos. O caractere de 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 de 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 listadas na tabela a seguir, o valor da última propriedade será usado.
A tabela a seguir 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. |
Application Intent |
SSPROP_INIT_APPLICATIONINTENT |
Declara o tipo de carga de trabalho de aplicativo ao conectar-se a um servidor. Os valores possíveis são ReadOnly e ReadWrite. O padrão é ReadWrite. Para obter mais informações sobre o suporte do SQL Server Native Client para Grupos de Disponibilidade AlwaysOn, consulte Suporte do SQL Server Native Client à alta disponibilidade e recuperação de desastre. |
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 (Multiple Active Result Sets) na conexão. 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 é 4096. |
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 "SQLNCLI11". |
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 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 Intent |
SSPROP_INIT_APPLICATIONINTENT |
Declara o tipo de carga de trabalho de aplicativo ao conectar-se a um servidor. Os valores possíveis são ReadOnly e ReadWrite. O padrão é ReadWrite. Para obter mais informações sobre o suporte do SQL Server Native Client para Grupos de Disponibilidade AlwaysOn, consulte Suporte do SQL Server Native Client à alta disponibilidade e recuperação de desastre. |
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 é 4096. |
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 "SQLNCLI11". |
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.