Utilização de palavras-chave na cadeia de conexão com o driver OLE DB para SQL Server

Aplica-se a:SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Sistema de Plataforma de Análise (PDW)Base de dados SQL no Microsoft Fabric

Baixar driver OLE DB

Algumas APIs do OLE DB Driver for SQL Server usam cadeias de ligação para especificar atributos de ligação. As cadeias de ligação são uma lista de palavras-chave e valores associados; Cada palavra-chave identifica um atributo de ligação particular.

Observação

O OLE DB Driver para SQL Server permite ambiguidade nas cadeias de ligação para manter a compatibilidade retroativa (por exemplo, algumas palavras-chave podem ser especificadas mais do que uma vez, e palavras-chave conflitantes podem ser permitidas com resolução baseada na posição ou precedência). Futuras versões do OLE DB Driver para SQL Server podem não permitir ambiguidade nas strings de ligação. é uma boa prática, ao modificar aplicações, usar o OLE DB Driver para SQL Server para eliminar qualquer ambiguidade relacionada à dependência da string de conexão.

As secções seguintes descrevem as palavras-chave que podem ser usadas com o OLE DB Driver para SQL Server e ActiveX Data Objects (ADO) ao utilizar o OLE DB Driver para SQL Server como fornecedor de dados.

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

Existem duas formas de as aplicações OLE DB inicializarem objetos fonte de dados:

IDBInitialize::Initialize
IDataInitialize::GetDataSource

No primeiro caso, uma cadeia de fornecedores pode ser usada para inicializar propriedades de ligação ao definir a propriedade DBPROP_INIT_PROVIDERSTRING no DBPROPSET_DBINIT conjunto de propriedades. No segundo caso, pode passar uma cadeia de inicialização para o método IDataInitialize::GetDataSource para inicializar as propriedades da ligação. Ambos os métodos inicializam as mesmas propriedades de ligação do OLE DB, mas são usados conjuntos diferentes de palavras-chave. O conjunto de palavras-chave usadas por IDataInitialize::GetDataSource é, no mínimo, a descrição das propriedades dentro do grupo de propriedades de inicialização.

Qualquer configuração de cadeia do fornecedor que possua uma propriedade OLE DB correspondente que esteja definida para um valor padrão ou explicitamente definida para um valor, o valor da propriedade OLE DB substituirá o valor na cadeia do fornecedor.

Propriedades booleanas definidas em cadeias de caracteres de fornecedor via DBPROP_INIT_PROVIDERSTRING são definidas usando os valores yes e no. Propriedades booleanas definidas em cadeias de inicialização usando IDataInitialize::GetDataSource são definidas usando os valores true e false.

As aplicações que usam IDataInitialize::GetDataSource também podem usar as palavras-chave usadas por IDBInitialize::Initialize, mas apenas para propriedades que não têm valor predefinido. Se uma aplicação usar tanto a IDataInitialize::GetDataSource palavra-chave como a IDBInitialize::Initialize palavra-chave na cadeia de inicialização, a IDataInitialize::GetDataSource definição de palavra-chave é utilizada. Recomenda-se que as aplicações não usem IDBInitialize::Initialize palavras-chave nas IDataInitialize:GetDataSource cadeias de ligação, pois este comportamento pode não ser mantido em versões futuras.

Observação

Uma cadeia de ligação passada através IDataInitialize::GetDataSource é convertida em propriedades e aplicada via IDBProperties::SetProperties. Se os serviços componentes encontrarem a descrição da propriedade em IDBProperties::GetPropertyInfo, esta propriedade será aplicada como uma propriedade autónoma. Caso contrário, será aplicado através da DBPROP_PROVIDERSTRING propriedade. Por exemplo, se especificar a cadeia de ligação Data Source=server1;Server=server2, Data Source será definida como propriedade, mas Server irá para uma cadeia fornecida.

Se especificar múltiplas instâncias da mesma propriedade específica do fornecedor, será utilizado o primeiro valor da primeira propriedade.

Usando IDBInitialize::Inicialize

As cadeias de ligação usadas por aplicações 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 dos atributos podem opcionalmente ser incluídos em colchetes, e é boa prática fazê-lo. Esta prática evita problemas quando os valores dos atributos contêm caracteres não alfanuméricos. Assume-se que a primeira chave de fecho no valor termina o valor, pelo que os valores não podem conter caracteres de chave de fecho.

Um carácter de espaço após o = sinal de uma palavra-chave de cadeia de ligação será interpretado como literal, mesmo que o valor esteja entre aspas.

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

Keyword	Propriedade de inicialização	Description
`Addr`	`SSPROP_INIT_NETWORKADDRESS`	Sinónimo de `Address`.
`Address`	`SSPROP_INIT_NETWORKADDRESS`	O endereço de rede do servidor que executa uma instância do SQL Server. `Address` é geralmente o nome da rede do servidor, mas pode ser outros nomes como um pipeline, um endereço IP ou um endereço TCP/IP port e socket. Se especificar um endereço IP, certifique-se de que os protocolos TCP/IP ou pipes nomeados estão ativados no SQL Server Configuration Manager. O valor de `Address` tem precedência sobre o valor passado para `Server` nas strings de ligação ao usar o Driver OLE DB para SQL Server. `Address=;` liga-se ao servidor especificado na `Server` palavra-chave, enquanto `Address= ;, Address=.;`, `Address=localhost;`, e `Address=(local);` todos causam uma ligação ao servidor local. A sintaxe completa da `Address` palavra-chave é a seguinte: [protocolo:]Endereço[,porta\|\pipe\nome pipe] de protocolo pode ser `tcp` (TCP/IP), `lpc` (memória partilhada) ou `np` (tubos nomeados). Para mais informações sobre protocolos, consulte Configurar protocolos cliente. Se nem o protocolo nem a `Network` palavra-chave forem especificados, o Driver OLE DB para SQL Server usará a ordem do protocolo especificada no Gestor de Configuração do SQL Server. A porta é a porta a que se deve ligar, no servidor especificado. Por defeito, o SQL Server utiliza a porta `1433`.
`APP`	`SSPROP_INIT_APPNAME`	A cadeia que identifica a aplicação.
`ApplicationIntent`	`SSPROP_INIT_APPLICATIONINTENT`	Declara o tipo de carga de trabalho do aplicativo ao se conectar a um servidor. Os valores possíveis são `ReadOnly` e `ReadWrite`. A predefinição é `ReadWrite`. Para mais informações sobre o suporte do OLE DB Driver for SQL Server para grupos de disponibilidade Always On, consulte OLE DB Driver for SQL Server Support for High Availability, Disaster Recovery.
`AttachDBFileName`	`SSPROP_INIT_FILENAME`	O nome do ficheiro primário (incluindo o nome completo do caminho) de uma base de dados anexável. Para usar `AttachDBFileName`, deve também especificar o nome da base de dados com a palavra-chave Database string do fornecedor. Se a base de dados já estava ligada, o SQL Server não a volta a ligar (usa a base de dados ligada como padrão para a ligação).
`Authentication` ¹	`SSPROP_AUTH_MODE`	Especifica a autenticação SQL ou Microsoft Entra utilizada. Os valores válidos são: `(not set)`: Modo de autenticação determinado por outras palavras-chave. `ActiveDirectoryPassword`: Autenticação de ID de utilizador e palavra-passe com uma identidade Microsoft Entra. `ActiveDirectoryIntegrated`: Autenticação integrada com Microsoft Entra ID. Nota: A `ActiveDirectoryIntegrated` palavra-chave também pode ser usada para autenticação do Windows no SQL Server. Substitui `Integrated Security` (ou `Trusted_Connection`) palavras-chave de autenticação. Aplicações que utilizam `Integrated Security` (ou `Trusted_Connection`) palavras-chave ou as suas propriedades correspondentes devem definir o valor da `Authentication` palavra-chave (ou da sua propriedade correspondente) para `ActiveDirectoryIntegrated` permitir novos comportamentos de encriptação e validação de certificados. `ActiveDirectoryInteractive`: Autenticação interativa com identidade Microsoft Entra. Este método suporta a autenticação multifator Microsoft Entra. `ActiveDirectoryMSI` : Autenticação de Managed Identity. Para uma identidade atribuída pelo utilizador, o ID do utilizador deve ser definido como o ID do objeto da identidade do utilizador. `ActiveDirectoryServicePrincipal`: Autenticação com entidade de serviço Microsoft Entra. O ID de utilizador deve ser definido para o ID da aplicação (cliente). A palavra-passe deve ser definida como o segredo da aplicação (cliente). `SqlPassword`: Autenticação usando ID de utilizador e palavra-passe. Nota: Aplicações que utilizam autenticação SQL Server devem definir o valor da `Authentication` palavra-chave (ou da sua propriedade correspondente) para `SqlPassword` permitir um novo comportamento de encriptação e validação de certificados.
`Auto Translate`	`SSPROP_INIT_AUTOTRANSLATE`	Sinónimo de `AutoTranslate`.
`AutoTranslate`	`SSPROP_INIT_AUTOTRANSLATE`	Configura a tradução de caracteres OEM/ANSI. Os valores reconhecidos são `yes` e `no`.
`ConnectRetryCount`	`SSPROP_INIT_CONNECT_RETRY_COUNT`	Controla o número de tentativas de reconexão se a ligação for perdida. Os valores válidos variam de `0` até `255`. O valor predefinido é `1`. Um valor de `0` não resultaria em qualquer tentativa de reconectar. Para mais informações, consulte resiliência da ligação inativa no Driver OLE DB.
`ConnectRetryInterval`	`SSPROP_INIT_CONNECT_RETRY_INTERVAL`	Especifica o número de segundos entre cada tentativa de retentativa de ligação se a ligação for perdida. Os valores válidos variam de `1` até `60`. O valor predefinido é `10`. Para mais informações, consulte resiliência da ligação inativa no Driver OLE DB.
`Database`	`DBPROP_INIT_CATALOG`	O nome do banco de dados.
`DataTypeCompatibility`	`SSPROP_INIT_DATATYPECOMPATIBILITY`	Especifica o modo de tratamento do tipo de dados a utilizar. Os valores reconhecidos são `0` para tipos de dados de fornecedores e `80` para tipos de dados SQL Server 2000 (8.x).
`Encrypt` ¹	`SSPROP_INIT_ENCRYPT`	Especifica se os dados devem ser encriptados antes de serem enviados pela rede. Os valores possíveis são `Optional`, `Mandatory`e `Strict`. O valor predefinido é `Mandatory`. Para as versões 18.x.x, veja MSOLEDBSQL principais diferenças de versão.
`FailoverPartner`	`SSPROP_INIT_FAILOVERPARTNER`	O nome do servidor de failover usado para espelhamento de bases de dados.
`FailoverPartnerSPN`	`SSPROP_INIT_FAILOVERPARTNERSPN`	O SPN para o parceiro de contingência. O valor padrão é uma cadeia de caracteres vazia. Uma string vazia faz com que o OLE DB Driver para SQL Server use o SPN predefinido, gerado pelo fornecedor.
`HostNameInCertificate`	`SSPROP_INIT_HOST_NAME_CERTIFICATE`	O nome do host a ser usado na validação do certificado TLS/SSL do SQL Server. Se a `HostNameInCertificate` palavra-chave não estiver definida, o driver usa o `Server` valor da palavra-chave na URL da ligação como nome do host para validar o certificado TLS/SSL do SQL Server. Nota: Esta propriedade é ignorada se o certificado do servidor for confiável. Se `Encrypt` for definido para `Strict`, o certificado será sempre validado.
`Language`	`SSPROP_INIT_CURRENTLANGUAGE`	A linguagem SQL Server.
`MarsConn`	`SSPROP_INIT_MARSCONNECTION`	Ativa ou desativa múltiplos conjuntos de resultados ativos (MARS) na ligação se o servidor for SQL Server 2005 (9.x) ou posterior. Os valores possíveis são `yes` e `no`. O valor predefinido é `no`.
`MultiSubnetFailover`	`SSPROP_INIT_MULTISUBNETFAILOVER`	Sempre especifique `MultiSubnetFailover=Yes` ao conectar-se ao listener do grupo de disponibilidade de um grupo de disponibilidade do SQL Server ou de uma Instância de Cluster de Failover do SQL Server. `MultiSubnetFailover=Yes` configura o OLE DB Driver para SQL Server para proporcionar uma deteção e ligação mais rápidas ao servidor (atualmente) ativo. Os valores possíveis são `Yes` e `No`. A predefinição é `No`. Por exemplo: `MultiSubnetFailover=Yes` Para mais informações sobre o suporte do OLE DB Driver for SQL Server para grupos de disponibilidade Always On, consulte OLE DB Driver for SQL Server Support for High Availability, Disaster Recovery.
`Net`	`SSPROP_INIT_NETWORKLIBRARY`	Sinónimo de `Network`.
`Network`	`SSPROP_INIT_NETWORKLIBRARY`	A biblioteca de rede servia para estabelecer uma ligação a uma instância do SQL Server na organização.
`Network Library`	`SSPROP_INIT_NETWORKLIBRARY`	Sinónimo de `Network`.
`PacketSize`	`SSPROP_INIT_PACKETSIZE`	Tamanho do pacote do Fluxo de Dados Tabulares (TDS). O valor padrão é `0` (o valor real será determinado pelo servidor).
`PersistSensitive`	`DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO`	Aceita as cadeias `yes` e `no` como valores. Quando `no` é utilizado, o objeto fonte de dados não pode persistir informação sensível de autenticação
`PWD`	`DBPROP_AUTH_PASSWORD`	A palavra-passe de login do SQL Server.
`Server`	`DBPROP_INIT_DATASOURCE`	O nome de uma instância SQL Server. O valor deve ser o nome de um servidor na rede, um endereço IP ou o nome de um alias SQL Server Configuration Manager. Quando não especificado, é feita uma ligação à instância padrão no computador local. A `Address` palavra-chave sobrepõe-se à `Server` palavra-chave. Pode ligar-se à instância padrão no servidor local especificando uma das seguintes opções: `Server=;` `Server=.;` `Server=(local);` `Server=(local);` `Server=(localhost);` `Server=(localdb)\<instancename>;` Para mais informações sobre o suporte ao LocalDB, consulte o OLE DB Driver for SQL Server Support for LocalDB. Para especificar uma instância nomeada do SQL Server, adicione `\<InstanceName>`. Quando nenhum servidor é especificado, é feita uma ligação à instância padrão no computador local. Se especificar um endereço IP, certifique-se de que os protocolos TCP/IP ou pipes nomeados estão ativados no SQL Server Configuration Manager. A sintaxe completa da `Server` palavra-chave é a seguinte: [protocolo:]Servidor[,porta] de protocolo pode ser `tcp` (TCP/IP), `lpc` (memória partilhada) ou `np` (tubos nomeados). O exemplo seguinte especifica um tubo nomeado: `np:\\.\pipe\MSSQL$MYINST01\sql\query` A linha acima especifica o protocolo de pipe nomeado (`np`), 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 um protocolo nem a `Network` palavra-chave forem especificados, o OLE DB Driver para SQL Server usará a ordem do protocolo especificada no SQL Server Configuration Manager. A porta é a porta a que se deve ligar, no servidor especificado. Por defeito, o SQL Server utiliza a porta `1433`. Os espaços são ignorados no início do valor passado para `Server` nas cadeias de conexão ao utilizar o OLE DB Driver para SQL Server.
`ServerCertificate`	`SSPROP_INIT_SERVER_CERTIFICATE`	Especifica o caminho para um ficheiro de certificado a comparar com o certificado TLS/SSL do SQL Server. Esta opção só pode ser usada quando `Strict` a encriptação está ativada. Os formatos de certificados aceites são PEM, DER e CER. Se especificado, o certificado do SQL Server é verificado ao verificar se o certificado fornecido é uma correspondência exata.
`ServerSPN`	`SSPROP_INIT_SERVERSPN`	O SPN para o servidor. O valor padrão é uma cadeia de caracteres vazia. Uma string vazia faz com que o OLE DB Driver para SQL Server use o SPN predefinido, gerado pelo fornecedor.
`Timeout`	`DBPROP_INIT_TIMEOUT`	O tempo (em segundos) para esperar que a inicialização da fonte de dados seja concluída.
`TransparentNetworkIPResolution`	`SSPROP_INIT_TNIR`	Afeta a sequência de ligação quando o primeiro IP resolvido do nome de anfitrião não responde e há múltiplos IPs associados ao nome de anfitrião. O TNIR interage com MultiSubnetFailover para fornecer diferentes sequências de ligação. Os valores possíveis são `Yes` e `No`. O valor predefinido é `Yes`. Para obter mais informações, consulte Usando resolução IP de rede transparente.
`Trusted_Connection`	`DBPROP_AUTH_INTEGRATED`	Quando `yes`, esta opção instrui o Driver OLE DB para SQL Server a usar a Autenticação do Windows para validação de login. Caso contrário, o Driver OLE DB para SQL Server usará um nome de utilizador e palavra-passe SQL Server para validação de login, e as palavras-chave UID e PWD devem ser especificadas.
`TrustServerCertificate` ¹	`SSPROP_INIT_TRUST_SERVER_CERTIFICATE`	Aceita as cadeias `yes` e `no` como valores. O valor padrão é `no`, o que significa que o certificado do servidor será validado.
`UID`	`DBPROP_AUTH_USERID`	O nome de login do SQL Server.
`UseFMTONLY`	`SSPROP_INIT_USEFMTONLY`	Controla como os metadados são recuperados ao ligar-se ao SQL Server 2012 (11.x) e versões posteriores. Os valores possíveis são `yes` e `no`. O valor predefinido é `no`. Por padrão, o OLE DB Driver para SQL Server utiliza sp_describe_first_result_set e sp_describe_undeclared_parameters para recuperar metadados com procedimentos armazenados. Estes procedimentos armazenados têm algumas limitações (por exemplo, falham ao operar em tabelas temporárias). Definir `UseFMTONLY` para `yes` instrui o driver a usar SET FMTONLY para recuperação de metadados em vez disso.
`UseProcForPrepare`	`SSPROP_INIT_USEPROCFORPREP`	Esta palavra-chave está obsoleta e a sua definição é ignorada pelo Driver OLE DB para SQL Server.
`WSID`	`SSPROP_INIT_WSID`	O identificador da estação de trabalho.

¹ Para melhorar a segurança, o comportamento de encriptação e validação de certificados é modificado ao utilizar propriedades de inicialização de Autenticação ou Token de Acesso ou as respetivas palavras-chave de cadeia de ligação. Para mais informações, consulte Encriptação e validação de certificados.

Use IDataInitialize::GetDataSource

As strings de ligação usadas por aplicações 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 da propriedade deve estar em conformidade com a sintaxe permitida no respetivo âmbito. Por exemplo, WSID usa caracteres de aspas curvadas ({}) e Application Name utiliza aspas simples (') ou aspas duplas ("). Apenas as propriedades de string podem ser citadas. Tentar citar uma propriedade inteira ou enumerada resultará num Connection String doesn't conform to OLE DB specification erro.

Os valores dos atributos podem opcionalmente ser incluídos entre aspas simples ou duplas, e é boa prática fazê-lo. Esta prática evita problemas quando os valores contêm caracteres não alfanuméricos. O carácter entre aspas usado também pode aparecer nos valores se estiver entre aspas duplas.

Um carácter de espaço após o sinal = de uma palavra-chave de cadeia de ligação será interpretado como literal, mesmo que o valor esteja entre aspas.

Se uma cadeia de ligação tiver mais do que uma das propriedades listadas na tabela seguinte, será utilizado o valor da última propriedade.

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

Keyword	Propriedade de inicialização	Description
`Access Token` ¹	`SSPROP_AUTH_ACCESS_TOKEN`	O token de acesso usado para autenticar no Microsoft Entra ID. Nota: É um erro especificar esta palavra-chave e também `UID`, `PWD`, `Trusted_Connection`, ou `Authentication` palavras-chave da cadeia de ligação ou as suas propriedades/palavras-chave correspondentes.
`Application Name`	`SSPROP_INIT_APPNAME`	A cadeia que identifica a aplicação.
`Application Intent`	`SSPROP_INIT_APPLICATIONINTENT`	Declara o tipo de carga de trabalho do aplicativo ao se conectar a um servidor. Os valores possíveis são `ReadOnly` e `ReadWrite`. A predefinição é `ReadWrite`. Para mais informações sobre o suporte do OLE DB Driver for SQL Server para grupos de disponibilidade Always On, consulte OLE DB Driver for SQL Server Support for High Availability, Disaster Recovery.
`Authentication` ¹	`SSPROP_AUTH_MODE`	Especifica a autenticação SQL ou Microsoft Entra utilizada. Os valores válidos são: `(not set)`: Modo de autenticação determinado por outras palavras-chave. `ActiveDirectoryPassword`: Autenticação de ID de utilizador e palavra-passe com uma identidade Microsoft Entra. `ActiveDirectoryIntegrated`: Autenticação integrada com Microsoft Entra ID. Nota: A `ActiveDirectoryIntegrated` palavra-chave também pode ser usada para autenticação do Windows no SQL Server. Substitui `Integrated Security` (ou `Trusted_Connection`) palavras-chave de autenticação. Aplicações que utilizam `Integrated Security` (ou `Trusted_Connection`) palavras-chave ou as suas propriedades correspondentes devem definir o valor da `Authentication` palavra-chave (ou da sua propriedade correspondente) para `ActiveDirectoryIntegrated` permitir novos comportamentos de encriptação e validação de certificados. `ActiveDirectoryInteractive`: Autenticação interativa com identidade Microsoft Entra. Este método suporta a autenticação multifator Microsoft Entra. `ActiveDirectoryMSI` : Autenticação de Managed Identity. Para uma identidade atribuída pelo utilizador, o ID do utilizador deve ser definido como o ID do objeto da identidade do utilizador. `ActiveDirectoryServicePrincipal`: Autenticação com entidade de serviço Microsoft Entra. O ID de utilizador deve ser definido para o ID da aplicação (cliente). A palavra-passe deve ser definida como o segredo da aplicação (cliente). `SqlPassword`: Autenticação usando ID de utilizador e palavra-passe. Nota: Aplicações que utilizam autenticação SQL Server devem definir o valor da `Authentication` palavra-chave (ou da sua propriedade correspondente) para `SqlPassword` permitir um novo comportamento de encriptação e validação de certificados.
`Auto Translate`	`SSPROP_INIT_AUTOTRANSLATE`	Configura a tradução de caracteres OEM/ANSI. Os valores reconhecidos são `true` e `false`.
`Connect Timeout`	`DBPROP_INIT_TIMEOUT`	O tempo (em segundos) para esperar que a inicialização da fonte de dados seja concluída.
`Connect Retry Count`	`SSPROP_INIT_CONNECT_RETRY_COUNT`	Controla o número de tentativas de reconexão se a ligação for perdida. Os valores válidos variam de `0` até `255`. O valor predefinido é `1`. Um valor de `0` não resultaria em qualquer tentativa de reconectar. Para mais informações, consulte resiliência da ligação inativa no Driver OLE DB.
`Connect Retry Interval`	`SSPROP_INIT_CONNECT_RETRY_INTERVAL`	Especifica o número de segundos entre cada tentativa de retentativa de ligação se a ligação for perdida. Os valores válidos variam de `1` até `60`. O valor predefinido é `10`. Para mais informações, consulte resiliência da ligação inativa no Driver OLE DB.
`Current Language`	`SSPROPT_INIT_CURRENTLANGUAGE`	O nome da linguagem SQL Server.
`Data Source`	`DBPROP_INIT_DATASOURCE`	O nome de uma instância do SQL Server na organização. Quando não especificado, é feita uma ligação à instância padrão no computador local. Para mais informações sobre a sintaxe válida de endereços, consulte a descrição da `Server` palavra-chave, neste artigo.
`DataTypeCompatibility`	`SSPROP_INIT_DATATYPECOMPATIBILITY`	Especifica o modo de tratamento do tipo de dados a utilizar. Os valores reconhecidos são `0` para tipos de dados de fornecedores e `80` para tipos de dados SQL Server 2000 (8.x).
`Failover Partner`	`SSPROP_INIT_FAILOVERPARTNER`	O nome do servidor de failover usado para espelhamento de bases de dados.
`Failover Partner SPN`	`SSPROP_INIT_FAILOVERPARTNERSPN`	O SPN para o parceiro de contingência. O valor padrão é uma cadeia de caracteres vazia. Uma string vazia faz com que o OLE DB Driver para SQL Server use o SPN predefinido, gerado pelo fornecedor.
`Host Name In Certificate`	`SSPROP_INIT_HOST_NAME_CERTIFICATE`	O nome do host a ser usado na validação do certificado TLS/SSL do SQL Server. Se a `Host Name In Certificate` palavra-chave não estiver definida, o driver usa o `Data Source` valor da palavra-chave na URL da ligação como nome do host para validar o certificado TLS/SSL do SQL Server. Nota: Esta propriedade é ignorada se o certificado do servidor for confiável. Se `Use Encryption for Data` for definido para `Strict`, o certificado será sempre validado.
`Initial Catalog`	`DBPROP_INIT_CATALOG`	O nome do banco de dados.
`Initial File Name`	`SSPROP_INIT_FILENAME`	O nome do ficheiro primário (incluindo o nome completo do caminho) de uma base de dados anexável. Para usar `AttachDBFileName`, deve também especificar o nome da base de dados com a cadeia de palavra-chave `DATABASE` do fornecedor. Se a base de dados já estava ligada, o SQL Server não a volta a ligar (usa a base de dados ligada como padrão para a ligação).
`Integrated Security`	`DBPROP_AUTH_INTEGRATED`	Aceita o valor `SSPI` para a Autenticação do Windows.
`MARS Connection`	`SSPROP_INIT_MARSCONNECTION`	Ativa ou desativa múltiplos conjuntos de resultados ativos (MARS) na ligação. Os valores reconhecidos são `true` e `false`. A predefinição é `false`.
`MultiSubnetFailover`	`SSPROP_INIT_MULTISUBNETFAILOVER`	Sempre especifique `MultiSubnetFailover=True` ao conectar-se ao listener do grupo de disponibilidade de um grupo de disponibilidade do SQL Server ou de uma Instância de Cluster de Failover do SQL Server. `MultiSubnetFailover=True` configura o OLE DB Driver para SQL Server para proporcionar uma deteção e ligação mais rápidas ao servidor (atualmente) ativo. Os valores possíveis são `True` e `False`. A predefinição é `False`. Por exemplo: `MultiSubnetFailover=True` Para mais informações sobre o suporte do OLE DB Driver for SQL Server para grupos de disponibilidade Always On, consulte OLE DB Driver for SQL Server Support for High Availability, Disaster Recovery.
`Network Address`	`SSPROP_INIT_NETWORKADDRESS`	O endereço de rede de uma instância do SQL Server na organização. Para mais informações sobre a sintaxe válida de endereços, consulte a descrição da `Address` palavra-chave, neste artigo.
`Network Library`	`SSPROP_INIT_NETWORKLIBRARY`	A biblioteca de rede servia para estabelecer uma ligação a uma instância do SQL Server na organização.
`Packet Size`	`SSPROP_INIT_PACKETSIZE`	Tamanho do pacote do Fluxo de Dados Tabulares (TDS). O valor padrão é `0` (o valor real será determinado pelo servidor).
`Password`	`DBPROP_AUTH_PASSWORD`	A palavra-passe de login do SQL Server.
`Persist Security Info`	`DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO`	Aceita as cadeias `true` e `false` como valores. Quando `false`, o objeto fonte de dados não pode persistir informação sensível de autenticação
`Provider`		Para o Driver OLE DB para SQL Server, o valor é `MSOLEDBSQL19` ou `MSOLEDBSQL`.
`Server Certificate`	`SSPROP_INIT_SERVER_CERTIFICATE`	Especifica o caminho para um ficheiro de certificado a comparar com o certificado TLS/SSL do SQL Server. Esta opção só pode ser usada quando `Strict` a encriptação está ativada. Os formatos de certificados aceites são PEM, DER e CER. Se especificado, o certificado do SQL Server é verificado ao verificar se o certificado fornecido é uma correspondência exata.
`Server SPN`	`SSPROP_INIT_SERVERSPN`	O SPN para o servidor. O valor padrão é uma cadeia de caracteres vazia. Uma string vazia faz com que o OLE DB Driver para SQL Server use o SPN predefinido, gerado pelo fornecedor.
`TransparentNetworkIPResolution`	`SSPROP_INIT_TNIR`	Afeta a sequência de ligação quando o primeiro IP resolvido do nome de anfitrião não responde e há múltiplos IPs associados ao nome de anfitrião. O TNIR interage com MultiSubnetFailover para fornecer diferentes sequências de ligação. Os valores possíveis são `True` e `False`. O valor predefinido é `True`. Para obter mais informações, consulte Usando resolução IP de rede transparente.
`Trust Server Certificate` ¹	`SSPROP_INIT_TRUST_SERVER_CERTIFICATE`	Aceita as cadeias `true` e `false` como valores. O valor padrão é `false`, o que significa que o certificado do servidor será validado.
`Use Encryption for Data` ¹	`SSPROP_INIT_ENCRYPT`	Especifica se os dados devem ser encriptados antes de serem enviados pela rede. Os valores possíveis são `Optional`, `Mandatory`e `Strict`. O valor predefinido é `Mandatory`. Para as versões 18.x.x, veja MSOLEDBSQL principais diferenças de versão.
`Use FMTONLY`	`SSPROP_INIT_USEFMTONLY`	Controla como os metadados são recuperados ao ligar-se ao SQL Server 2012 (11.x) e versões posteriores. Os valores possíveis são `true` e `false`. O valor predefinido é `false`. Por padrão, o OLE DB Driver para SQL Server utiliza sp_describe_first_result_set e sp_describe_undeclared_parameters para recuperar metadados com procedimentos armazenados. Estes procedimentos armazenados têm algumas limitações (por exemplo, falham ao operar em tabelas temporárias). Definir `Use FMTONLY` para `true` instrui o driver a usar SET FMTONLY para recuperação de metadados em vez disso.
`User ID`	`DBPROP_AUTH_USERID`	O nome de login do SQL Server.
`Workstation ID`	`SSPROP_INIT_WSID`	O identificador da estação de trabalho.

¹ Para melhorar a segurança, o comportamento de encriptação e validação de certificados é modificado ao utilizar propriedades de inicialização de Token de Autenticação/Acesso ou as suas correspondentes palavras-chave de cadeia de ligação. Para mais detalhes, consulte Encriptação e validação de certificados.

Observação

Na string de ligação, a Old Password propriedade define SSPROP_AUTH_OLD_PASSWORD, que é a palavra-passe atual (possivelmente expirada) que não pode ser obtida através de uma propriedade de string do provedor.

Palavras-chave da cadeia de ligação ActiveX Data Objects (ADO)

As aplicações ADO definem a ConnectionString propriedade dos ADODBConnection objetos ou fornecem uma cadeia de ligação como parâmetro ao Open método dos ADODBConnection objetos.

As aplicações ADO também podem usar as palavras-chave usadas pelo método OLE DB IDBInitialize::Initialize , mas apenas para propriedades que não têm valor predefinido. Se uma aplicação usar tanto as palavras-chave ADO como as IDBInitialize::Initialize palavras-chave na cadeia de inicialização, será usada a definição de palavra-chave ADO. recomenda-se que as aplicações utilizem apenas palavras-chave de string de ligação ADO.

As cadeias de ligaçã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 dos atributos podem opcionalmente ser incluídos entre aspas duplas, e é boa prática fazê-lo. Esta prática evita problemas quando os valores contêm caracteres não alfanuméricos. Os valores dos atributos não podem conter aspas duplas.

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

Keyword	Propriedade de inicialização	Description
`Access Token` ¹	`SSPROP_AUTH_ACCESS_TOKEN`	O token de acesso usado para autenticar no Microsoft Entra ID. Nota: É um erro especificar esta palavra-chave e também `UID`, `PWD`, `Trusted_Connection`, ou `Authentication` palavras-chave da cadeia de ligação ou as suas propriedades/palavras-chave correspondentes.
`Application Intent`	`SSPROP_INIT_APPLICATIONINTENT`	Declara o tipo de carga de trabalho do aplicativo ao se conectar a um servidor. Os valores possíveis são `ReadOnly` e `ReadWrite`. A predefinição é `ReadWrite`. Para mais informações sobre o suporte do OLE DB Driver for SQL Server para grupos de disponibilidade Always On, consulte OLE DB Driver for SQL Server Support for High Availability, Disaster Recovery.
`Application Name`	`SSPROP_INIT_APPNAME`	A cadeia que identifica a aplicação.
`Authentication` ¹	`SSPROP_AUTH_MODE`	Especifica a autenticação SQL ou Microsoft Entra utilizada. Os valores válidos são: `(not set)`: Modo de autenticação determinado por outras palavras-chave. `ActiveDirectoryPassword`: Autenticação de ID de utilizador e palavra-passe com uma identidade Microsoft Entra. `ActiveDirectoryIntegrated`: Autenticação integrada com Microsoft Entra ID. Nota: A `ActiveDirectoryIntegrated` palavra-chave também pode ser usada para autenticação do Windows no SQL Server. Substitui `Integrated Security` (ou `Trusted_Connection`) palavras-chave de autenticação. Aplicações que utilizam `Integrated Security` (ou `Trusted_Connection`) palavras-chave ou as suas propriedades correspondentes devem definir o valor da `Authentication` palavra-chave (ou da sua propriedade correspondente) para `ActiveDirectoryIntegrated` permitir novos comportamentos de encriptação e validação de certificados. `ActiveDirectoryInteractive`: Autenticação interativa com identidade Microsoft Entra. Este método suporta a autenticação multifator Microsoft Entra. `ActiveDirectoryMSI` : Autenticação de Managed Identity. Para uma identidade atribuída pelo utilizador, o ID do utilizador deve ser definido como o ID do objeto da identidade do utilizador. `ActiveDirectoryServicePrincipal`: Autenticação com entidade de serviço Microsoft Entra. O ID de utilizador deve ser definido para o ID da aplicação (cliente). A palavra-passe deve ser definida como o segredo da aplicação (cliente). `SqlPassword`: Autenticação usando ID de utilizador e palavra-passe. Nota: Aplicações que utilizam autenticação SQL Server devem definir o valor da `Authentication` palavra-chave (ou da sua propriedade correspondente) para `SqlPassword` permitir um novo comportamento de encriptação e validação de certificados.
`Auto Translate`	`SSPROP_INIT_AUTOTRANSLATE`	Configura a tradução de caracteres OEM/ANSI. Os valores reconhecidos são `true` e `false`.
`Connect Timeout`	`DBPROP_INIT_TIMEOUT`	O tempo (em segundos) para esperar que a inicialização da fonte de dados seja concluída.
`Connect Retry Count`	`SSPROP_INIT_CONNECT_RETRY_COUNT`	Controla o número de tentativas de reconexão se a ligação for perdida. Os valores válidos variam de `0` até `255`. O valor predefinido é `1`. Um valor de `0` não resultaria em qualquer tentativa de reconectar. Para mais informações, consulte resiliência da ligação inativa no Driver OLE DB.
`Connect Retry Interval`	`SSPROP_INIT_CONNECT_RETRY_INTERVAL`	Especifica o número de segundos entre cada tentativa de retentativa de ligação se a ligação for perdida. Os valores válidos variam de `1` até `60`. O valor predefinido é `10`. Para mais informações, consulte resiliência da ligação inativa no Driver OLE DB.
`Current Language`	`SSPROPT_INIT_CURRENTLANGUAGE`	O nome da linguagem SQL Server.
`Data Source`	`DBPROP_INIT_DATASOURCE`	O nome de uma instância do SQL Server na organização. Quando não especificado, é feita uma ligação à instância padrão no computador local. Para mais informações sobre a sintaxe válida de endereços, consulte a descrição da `Server` palavra-chave, neste artigo.
`DataTypeCompatibility`	`SSPROP_INIT_DATATYPECOMPATIBILITY`	Especifica o modo de tratamento dos tipos de dados que será utilizado. Os valores reconhecidos são `0` para tipos de dados de fornecedores e `80` para tipos de dados SQL Server 2000 (8.x).
`Failover Partner`	`SSPROP_INIT_FAILOVERPARTNER`	O nome do servidor de failover usado para espelhamento de bases de dados.
`Failover Partner SPN`	`SSPROP_INIT_FAILOVERPARTNERSPN`	O SPN para o parceiro de contingência. O valor padrão é uma cadeia de caracteres vazia. Uma string vazia faz com que o OLE DB Driver para SQL Server use o SPN predefinido, gerado pelo fornecedor.
`Host Name In Certificate`	`SSPROP_INIT_HOST_NAME_CERTIFICATE`	O nome do host a ser usado na validação do certificado TLS/SSL do SQL Server. Se a `Host Name In Certificate` palavra-chave não estiver definida, o driver usa o `Data Source` valor da palavra-chave na URL da ligação como nome do host para validar o certificado TLS/SSL do SQL Server. Nota: Esta propriedade é ignorada se o certificado do servidor for confiável. Se `Use Encryption for Data` for definido para `Strict`, o certificado será sempre validado.
`Initial Catalog`	`DBPROP_INIT_CATALOG`	O nome do banco de dados.
`Initial File Name`	`SSPROP_INIT_FILENAME`	O nome do ficheiro primário (incluindo o nome completo do caminho) de uma base de dados anexável. Para usar `AttachDBFileName`, deve também especificar o nome da base de dados com a palavra-chave da cadeia `DATABASE` de fornecedor. Se a base de dados já estava ligada, o SQL Server não a volta a ligar (usa a base de dados ligada como padrão para a ligação).
`Integrated Security`	`DBPROP_AUTH_INTEGRATED`	Aceita o valor `SSPI` para a Autenticação do Windows.
`MARS Connection`	`SSPROP_INIT_MARSCONNECTION`	Ativa ou desativa múltiplos conjuntos de resultados ativos (MARS) na ligação se o servidor for SQL Server 2005 (9.x) ou posterior. Os valores reconhecidos são `true` e `false`. A predefinição é `false`.
`MultiSubnetFailover`	`SSPROP_INIT_MULTISUBNETFAILOVER`	Sempre especifique `MultiSubnetFailover=True` ao conectar-se ao listener do grupo de disponibilidade de um grupo de disponibilidade do SQL Server ou de uma Instância de Cluster de Failover do SQL Server. `MultiSubnetFailover=True` configura o OLE DB Driver para SQL Server para proporcionar uma deteção e ligação mais rápidas ao servidor (atualmente) ativo. Os valores possíveis são `True` e `False`. A predefinição é `False`. Por exemplo: `MultiSubnetFailover=True` Para mais informações sobre o suporte do OLE DB Driver for SQL Server para grupos de disponibilidade Always On, consulte OLE DB Driver for SQL Server Support for High Availability, Disaster Recovery.
`Network Address`	`SSPROP_INIT_NETWORKADDRESS`	O endereço de rede de uma instância do SQL Server na organização. Para mais informações sobre a sintaxe válida de endereços, consulte a descrição da `Address` palavra-chave, neste artigo.
`Network Library`	`SSPROP_INIT_NETWORKLIBRARY`	A biblioteca de rede servia para estabelecer uma ligação a uma instância do SQL Server na organização.
`Packet Size`	`SSPROP_INIT_PACKETSIZE`	Tamanho do pacote do Fluxo de Dados Tabulares (TDS). O valor padrão é `0` (o valor real será determinado pelo servidor).
`Password`	`DBPROP_AUTH_PASSWORD`	A palavra-passe de login do SQL Server.
`Persist Security Info`	`DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO`	Aceita as cadeias `true` e `false` como valores. Quando `false`, o objeto fonte de dados não pode persistir informações sensíveis de autenticação.
`Provider`		Para o Driver OLE DB para SQL Server, o valor é `MSOLEDBSQL19` ou `MSOLEDBSQL`.
`Server Certificate`	`SSPROP_INIT_SERVER_CERTIFICATE`	Especifica o caminho para um ficheiro de certificado a comparar com o certificado TLS/SSL do SQL Server. Esta opção só pode ser usada quando `Strict` a encriptação está ativada. Os formatos de certificados aceites são PEM, DER e CER. Se especificado, o certificado do SQL Server é verificado ao verificar se o certificado fornecido é uma correspondência exata.
`Server SPN`	`SSPROP_INIT_SERVERSPN`	O SPN para o servidor. O valor padrão é uma cadeia de caracteres vazia. Uma string vazia faz com que o OLE DB Driver para SQL Server use o SPN predefinido, gerado pelo fornecedor.
`TransparentNetworkIPResolution`	`SSPROP_INIT_TNIR`	Afeta a sequência de ligação quando o primeiro IP resolvido do nome de anfitrião não responde e há múltiplos IPs associados ao nome de anfitrião. O TNIR interage com MultiSubnetFailover para fornecer diferentes sequências de ligação. Os valores possíveis são `True` e `False`. O valor predefinido é `True`. Para obter mais informações, consulte Usando resolução IP de rede transparente.
`Trust Server Certificate` ¹	`SSPROP_INIT_TRUST_SERVER_CERTIFICATE`	Aceita as cadeias `true` e `false` como valores. O valor padrão é `false`, o que significa que o certificado do servidor será validado.
`Use Encryption for Data` ¹	`SSPROP_INIT_ENCRYPT`	Especifica se os dados devem ser encriptados antes de serem enviados pela rede. Os valores possíveis são `Optional`, `Mandatory`e `Strict`. O valor predefinido é `Mandatory`. Para as versões 18.x.x, veja MSOLEDBSQL principais diferenças de versão.
`Use FMTONLY`	`SSPROP_INIT_USEFMTONLY`	Controla como os metadados são recuperados ao ligar-se ao SQL Server 2012 (11.x) e versões posteriores. Os valores possíveis são `true` e `false`. O valor predefinido é `false`. Por padrão, o OLE DB Driver para SQL Server utiliza sp_describe_first_result_set e sp_describe_undeclared_parameters para recuperar metadados com procedimentos armazenados. Estes procedimentos armazenados têm algumas limitações (por exemplo, falham ao operar em tabelas temporárias). Definir `Use FMTONLY` para `true` instrui o driver a usar SET FMTONLY para recuperação de metadados em vez disso.
`User ID`	`DBPROP_AUTH_USERID`	O nome de login do SQL Server.
`Workstation ID`	`SSPROP_INIT_WSID`	O identificador da estação de trabalho.

Observação

Na cadeia de ligação, a propriedade "Palavra-passe Antiga" define SSPROP_AUTH_OLD_PASSWORD, que é a palavra-passe atual (possivelmente expirada) que não está disponível através de uma propriedade de cadeia de fornecedor.

Criando aplicativos com o driver OLE DB para SQL Server

Comentários

Esta página foi útil?

Last updated on 2025-12-12

Partilhar via

Utilização de palavras-chave na cadeia de conexão com o driver OLE DB para SQL Server

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

Usando IDBInitialize::Inicialize

Use IDataInitialize::GetDataSource

Palavras-chave da cadeia de ligação ActiveX Data Objects (ADO)

Conteúdo relacionado

Comentários

Recursos adicionais