Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Este tópico lista as opções permitidas no array associativo (quando se usa sqlsrv_connect no driver SQLSRV) ou as palavras-chave permitidas no nome da fonte de dados (dsn) (quando se usa PDO::__construct no driver PDO_SQLSRV).
Tabela de Opções de Ligação
| Key | Valor | Description | Predefinido |
|---|---|---|---|
| AccessToken | Corda | A cadeia de bytes do token de acesso Microsoft Entra extraída de uma resposta OAuth JSON. A cadeia de ligação não deve conter um ID de utilizador, palavra-passe ou a Authentication palavra-chave. Para mais informações, consulte Connect Using Microsoft Entra authentication |
Não está definido. |
| Aplicação | Corda | Especifica o nome da aplicação usado no rastreio. | Não está definido. |
| Intenção do aplicativo | Corda | Declara o tipo de carga de trabalho do aplicativo ao se conectar a um servidor. Os valores possíveis são ReadOnly e ReadWrite. Para mais informações sobre os Microsoft Drivers for PHP para suporte ao SQL Server para grupos de disponibilidade Always On, consulte Suporte para Alta Disponibilidade, Recuperação de Desastres. |
LerEscrever |
| AttachDBFileName | Corda | Especifica qual ficheiro de base de dados o servidor deve anexar. | Não está definido. |
| Authentication | Uma das seguintes cordas: SqlPassword ActiveDirectoryPassword ActiveDirectoryMsi ActiveDirectoryServicePrincipal |
Especifica o modo de autenticação. Para mais informações, consulte Conectar usando a autenticação do Microsoft Entra |
Não está definido. |
| Conjunto de caracteres (não suportado no driver PDO_SQLSRV) |
Corda | Especifica o conjunto de caracteres usado para enviar dados ao servidor. Os valores possíveis são SQLSRV_ENC_CHAR e UTF-8. Para mais informações, consulte Como Enviar e Recuperar Dados UTF-8 Usando Suporte UTF-8 Incorporado. |
SQLSRV_ENC_CHAR |
| Encriptação de Coluna | Uma das seguintes cadeias de caracteres: Ativado Disabled Uma cadeia que identifica o protocolo de atestação e o URL para atestar o enclave |
Especifica se a funcionalidade Sempre Encriptada está ativada ou não. Se forem especificados um protocolo de atestação e URL, o Always Encrypted com enclaves seguros está ativado, desde que os outros requisitos sejam cumpridos conforme descrito em Usar Sempre Encriptado com enclaves seguros com os drivers PHP para SQL Server. | Disabled |
| Pool de Conexões | 1 ou verdadeiro para pool de conexões. 0 ou falso para desativar o pooling de conexões. |
Especifica se a ligação é atribuída a partir de um pool de ligações (1 ou verdadeira) ou não (0 ou falsa). 1 | verdadeiro (1) |
| ConnectRetryCount | Inteiro entre 0 e 255 (inclusive) | O número máximo de tentativas para restabelecer uma ligação quebrada antes de desistir. Por padrão, uma única tentativa é feita para restabelecer uma ligação quando quebrada. Um valor 0 significa que nenhuma reconexão será tentada. | 1 |
| ConnectRetryInterval | Inteiro entre 1 e 60 (inclusive) | O tempo, em segundos, entre tentativas de restabelecer uma ligação. A aplicação tenta reconectar-se imediatamente assim que detetar uma ligação quebrada e espera ConnectRetryInterval segundos antes de tentar novamente. Esta palavra-chave é ignorada se ConnectRetryCount for igual a 0. |
10 |
| Base de dados | Corda | Especifica o nome da base de dados utilizada para a ligação a estabelecer2. | A base de dados padrão para o login que está a ser utilizado. |
| DecimalPlaces (não suportado no driver PDO_SQLSRV) |
Inteiro entre 0 e 4 (inclusive) | Especifica as casas decimais ao formatar valores monetários obtidos. Esta opção só funciona quando FormatDecimals é verdadeira. Qualquer valor negativo inteiro ou maior que 4 será ignorado. |
Precisão e escala padrão |
| Driver | Corda | Especifica o driver Microsoft ODBC usado para comunicar com o SQL Server. Os valores possíveis são: ODBC Driver 18 para SQL Server ODBC Driver 17 para SQL Server ODBC Driver 13 para SQL Server Driver ODBC 11 para SQL Server (apenas Windows). |
Quando a palavra-chave Driver não é especificada, os Microsoft Drivers for PHP para SQL Server tentam encontrar os drivers Microsoft ODBC suportados no sistema, começando pela versão mais recente do ODBC e assim sucessivamente. |
| Criptografar | 1 ou verdadeiro para encriptação ativada. 0 ou falso para encriptação desligada. |
Especifica se a comunicação com o SQL Server é encriptada (1 ou verdadeira) ou não encriptada (0 ou falsa)3. | false (0) |
| Parceiro_de_Failover | Corda | Especifica o servidor e a instância do espelho da base de dados (se ativado e configurado) a usar quando o servidor principal não estiver disponível. Existem restrições para usar Failover_Partner com MultiSubnetFailover. Para mais informações, consulte Suporte para Alta Disponibilidade, Recuperação em Desastres.Esta opção não é suportada no Linux ou macOS porque o espelhamento de bases de dados não é suportado pelo driver ODBC no Linux ou macOS. Em vez disso, utilize os grupos de disponibilidade Sempre Ligado e defina as opções MultiSubnetFailover e TransparentNetworkIPResolution. |
Não está definido. |
| FormatDecimals (não suportado no driver PDO_SQLSRV) |
1 ou true para formatar as sequências decimais obtidas. 0 ou falso devido ao comportamento padrão de formatação decimal. |
Especifica se deve adicionar zeros iniciais às cadeias decimais quando apropriado e permite a DecimalPlaces opção de formatar tipos de moeda. Se for deixado falso, utiliza-se o comportamento padrão de devolver precisão exata e omitir os zeros iniciais para valores inferiores a 1.Para mais informações, consulte Formatação de Cadeias Decimais e Valores de Dinheiro. |
false (0) |
| Autenticação do KeyStore |
KeyVaultPassword KeyVaultClientSecret |
Método de autenticação para aceder ao Azure Key Vault. Controla que tipo de credenciais são usadas com KeyStorePrincipalId e KeyStoreSecret. Para mais informações, consulte Utilização do Azure Key Vault. |
Não está definido. |
| KeyStorePrincipalId | Corda | Identificador da conta que procura aceder ao Azure Key Vault. Se KeyStoreAuthentication é KeyVaultPassword, este valor deve ser um nome de utilizador do Microsoft Entra. Se KeyStoreAuthentication é KeyVaultClientSecret, então este valor deve ser um ID de cliente da aplicação. |
Não está definido. |
| Segredo do KeyStore | Corda | Segredo credencial para a conta que procura aceder ao Azure Key Vault. Se KeyStoreAuthentication for KeyVaultPassword, este valor deve ser uma palavra-passe do Microsoft Entra. Se KeyStoreAuthentication for KeyVaultClientSecret, este valor deve ser um segredo de cliente de aplicação. |
Não está definido. |
| Linguagem | Corda | Especifica a linguagem das mensagens devolvidas pelo servidor. As línguas disponíveis estão listadas na sys.syslanguages tabela. Esta opção não afeta a língua usada pelos próprios drivers, pois atualmente estão disponíveis apenas em inglês, e não afeta a língua do driver ODBC subjacente, cujo idioma é determinado pela versão localizada instalada no sistema cliente. Portanto, alterar esta definição pode resultar em mensagens retornadas em línguas diferentes, dependendo se provêm do driver PHP, do driver ODBC ou do SQL Server. |
O idioma padrão é o definido no SQL Server. |
| Tempo de Espera de Login | Integer (SQLSRV driver) String (driver PDO_SQLSRV) |
Especifica o número de segundos a esperar antes de falhar a tentativa de ligação. | Sem tempo limite. |
| MultipleActiveResultSets | 1 ou true para usar vários conjuntos de resultados ativos. 0 ou false para desativar múltiplos conjuntos de resultados ativos. |
Desativa ou permite explicitamente o suporte para múltiplos conjuntos de resultados ativos (MARS). Para mais informações, veja Como: Desabilitar Múltiplos Conjuntos de Resultados Ativos (MARS). |
verdadeiro (1) |
| MultiSubnetFailover | Corda | Especifique multiSubnetFailover=yes sempre ao ligar-se ao ouvinte do grupo de disponibilidade de um grupo de disponibilidade do SQL Server 2012 (11.x) ou de uma Instância de Cluster de Failover do SQL Server 2012 (11.x).
multiSubnetFailover=yes configura os Microsoft Drivers para PHP para SQL Server para proporcionar uma deteção e ligação mais rápidas ao servidor (atualmente) ativo. Os valores possíveis são Sim e Não.Para mais informações sobre os Microsoft Drivers for PHP para suporte ao SQL Server para grupos de disponibilidade Always On, consulte Suporte para Alta Disponibilidade, Recuperação de Desastres. |
Não |
| PWD (não suportado no driver PDO_SQLSRV) |
Corda | Especifica a palavra-passe associada ao ID de Utilizador a ser usado ao ligar com a Autenticação SQL Server4. | Não está definido. |
| QuotedId | 1 ou true para usar regras SQL-92. 0 ou falso para usar regras herdadas. |
Especifica se deve usar regras SQL-92 para identificadores entre aspas (1 ou verdadeiro) ou usar regras Transact-SQL legadas (0 ou falso). | verdadeiro (1) |
| RetornarDatasComoStrings (não suportado no driver PDO_SQLSRV) |
1 ou verdadeiro para retornar tipos de data e hora como cadeias de caracteres. 0 ou falso para devolver tipos de data e hora como tipos DateTime do PHP. |
Obtém tipos de data e hora (datetime, smalldatetime, date, time, datetime2 e datetimeoffset) como strings ou como tipos PHP. Para mais informações, veja Como: Recuperar Tipos de Data e Hora como Strings usando o driver SQLSRV. Ao usar o driver PDO_SQLSRV, as datas são devolvidas como strings, salvo indicação em contrário. Para mais informações, veja Como: Recuperar Tipos de Data e Hora como Objetos PHP DateTime usando o PDO_SQLSRV Driver. |
falso |
| Rolável | Corda | "buffered" indica que queres um cursor do lado do cliente (bufferizado), que permite armazenar em cache um conjunto de resultados inteiro na memória. Para mais informações, consulte Tipos de Cursor (Driver SQLSRV). | Cursor apenas para a frente |
| Server (não suportado no driver SQLSRV) |
Corda | Instância do SQL Server para conectar. Também pode especificar um nome de rede virtual para se ligar a um grupo de disponibilidade Always On. Para mais informações sobre os Microsoft Drivers for PHP para suporte ao SQL Server para grupos de disponibilidade Always On, consulte Suporte para Alta Disponibilidade, Recuperação de Desastres. |
Server é uma palavra-chave obrigatória (embora não tenha de ser a primeira palavra-chave na cadeia de ligação). Se o nome do servidor não for passado para a palavra-chave, faz-se uma tentativa de ligação à instância local. O valor passado ao servidor pode ser o nome de uma instância SQL Server ou o endereço IP da instância. Pode, opcionalmente, especificar um número de porta (por exemplo, sqlsrv:server=(local),1033).A partir da versão 3.0 dos Microsoft Drivers for PHP para SQL Server, também pode especificar uma instância de LocalDB com server=(localdb)\instancename. Para mais informações, consulte Suporte ao LocalDB. |
| Ficheiro de Traço | Corda | Especifica o caminho do ficheiro usado para dados de rastreamento. | Não está definido. |
| TraceOn | 1 ou true para ativar o rastreio. 0 ou falso para desativar o rastreio. |
Especifica se o rastreamento ODBC está ativado (1 ou verdadeiro) ou desativado (0 ou falso) para a ligação a ser estabelecida. | false (0) |
| Isolamento da Transação | O driver SQLSRV utiliza os seguintes valores: SQLSRV_TXN_READ_UNCOMMITTED SQLSRV_TXN_READ_COMMITTED SQLSRV_TXN_REPEATABLE_READ SQLSRV_TXN_SNAPSHOT SQLSRV_TXN_SERIALIZABLE O driver PDO_SQLSRV utiliza os seguintes valores: PDO::SQLSRV_TXN_READ_UNCOMMITTED PDO::SQLSRV_TXN_READ_COMMITTED PDO::SQLSRV_TXN_REPEATABLE_READ PDO::SQLSRV_TXN_SNAPSHOT PDO::SQLSRV_TXN_SERIALIZABLE |
Especifica o nível de isolamento da transação. Para mais informações sobre isolamento de transações, consulte SET TRANSACTION ISOLATION LEVEL na documentação do SQL Server. |
SQLSRV_TXN_READ_COMMITTED ou PDO::SQLSRV_TXN_READ_COMMITTED |
| Resolução de IP de Rede Transparente | Ativado ou Desativado | Afeta a sequência de ligação quando o primeiro IP resolvido do nome de host não responde e há múltiplos IPs associados ao nome de host. Interage com MultiSubnetFailover para fornecer diferentes sequências de ligação. Para mais informações, consulte Resolução IP de Rede Transparente ou Utilização de Resolução IP de Rede Transparente. |
Ativado(a) |
| TrustServerCertificate | 1 ou true para confiar no certificado. 0 ou falso para não confiar no certificado. |
Especifica se o cliente deve confiar (1 ou verdadeiro) ou rejeitar (0 ou falso) um certificado de servidor auto-assinado. | false (0) |
| Identificador Único (não suportado no driver PDO_SQLSRV) |
Corda | Especifica o ID de Utilizador a usar ao ligar com a Autenticação SQL Server4. | Não está definido. |
| WSID | Corda | Especifica o nome do computador para o rastreamento. | Não está definido. |
O atributo
ConnectionPoolingnão pode ser usado para ativar/desativar o pool de ligações no Linux e macOS. Veja Pool de Ligações (Microsoft Drivers para PHP para SQL Server).Todas as consultas executadas na ligação estabelecida são feitas à base de dados especificada pelo
Databaseatributo. No entanto, se o utilizador tiver as permissões adequadas, os dados noutras bases de dados podem ser acedidos usando um nome totalmente qualificado. Por exemplo, se a base de dados mestre estiver definida com oDatabaseatributo de conexão, ainda é possível executar uma consulta Transact-SQL que acede à tabela AdventureWorks.HumanResources.Employee usando o nome totalmente qualificado.A ativação
Encryptionpode afetar o desempenho de algumas aplicações devido à sobrecarga computacional necessária para encriptar dados.Os atributos
UIDePWDdevem ser definidos ao conectar-se à Autenticação SQL Server.
Muitas das chaves suportadas são atributos de string de ligação ODBC. Para informações sobre cadeias de ligação ODBC, consulte Utilizando Palavras-chave de Cadeias de Conexão com SQL Native Client.