Construtor de string de conexão do SQL Server
Construa uma string de conexão do SQL Server ou Azure SQL para ADO.NET (Microsoft.Data.SqlClient), ODBC Driver 18, JDBC, Go e SQLAlchemy a partir de um formulário, ou cole uma para ver o que cada palavra-chave faz e o que é arriscado. Tudo roda no seu navegador: nada do que você digita é enviado para lugar nenhum.
Abrir esta conexão no SQLly
Abre o editor de conexão do SQLly preenchido.
Abrir esta conexão no SQLly
Privado por design. O construtor e o decodificador são JavaScript puro rodando nesta aba. A página não envia nenhuma solicitação com o que você digita, não armazena nada (nem mesmo no seu navegador) e continua funcionando offline após carregada. O link Abrir no SQLly vai do seu navegador direto para o aplicativo no seu computador.
Formatos de strings de conexão do SQL Server
Os drivers do SQL Server compartilham um estilo de palavra-chave=valor, mas não as palavras-chave: ADO.NET diz User ID e Connect Timeout, ODBC diz Uid e ConnectTimeout, JDBC diz user e loginTimeout, e Go usa uma URL. Eles também compartilham uma armadilha: a porta vem depois de uma vírgula (host,1433), não dois-pontos, em todos os lugares, exceto JDBC e Go.
A outra coisa que pega as pessoas é a criptografia. Microsoft.Data.SqlClient 4.0, ODBC Driver 18 e JDBC Driver 10.2 criptografam por padrão e validam o certificado do servidor, então strings que funcionavam há anos começaram a falhar depois de uma atualização. O construtor indica Encrypt explicitamente, e o decodificador informa o que significa um Encrypt significa para cada driver.
ADO.NET Microsoft.Data.SqlClient, System.Data.SqlClient, Entity Framework, Dapper
Server=sql01.example.com;Database=Sales;User ID=app_user;Password=your_password;Encrypt=True;
ODBC ODBC Driver 18 para SQL Server, pyodbc
Driver={ODBC Driver 18 for SQL Server};Server=sql01.example.com;Database=Sales;Uid=app_user;Pwd=your_password;Encrypt=yes;
JDBC Microsoft JDBC Driver para SQL Server
jdbc:sqlserver://sql01.example.com;databaseName=Sales;user=app_user;password=your_password;encrypt=true;
URL do Go github.com/microsoft/go-mssqldb
sqlserver://app_user:[email protected]?database=Sales&encrypt=true
URL do SQLAlchemy Python SQLAlchemy com pyodbc
mssql+pyodbc://app_user:[email protected]/Sales?driver=ODBC+Driver+18+for+SQL+Server&Encrypt=yes
Autenticação do Windows (ADO.NET) Segurança Integrada
Server=sql01.example.com;Database=Sales;Integrated Security=True;Encrypt=True;
Azure SQL com Microsoft Entra ID (ADO.NET) Identidade gerenciada, Azure CLI ou login no Visual Studio
Server=myserver.database.windows.net;Database=Sales;Authentication=Active Directory Default;Encrypt=True;
Marcadores como your_password são exatamente isso: monte sua própria string no formulário acima. Mais sobre como conectar o SQLly ao SQL Server: SQLly para SQL Server.
Palavras-chave do Microsoft.Data.SqlClient (ADO.NET)
Palavras-chave não diferenciam maiúsculas de minúsculas, espaços ao redor delas são ignorados e, quando uma palavra-chave (ou um de seus sinônimos) aparece duas vezes, o último valor prevalece. Uma palavra-chave desconhecida lança Keyword not supported. Coloque um valor entre aspas em " ou ' quando contém ;, ou começar ou terminar com um espaço ou uma aspa; dentro das aspas, dobre o caractere de aspa.
| Palavra-chave | Sinônimos | Padrão | O que faz |
|---|---|---|---|
Server |
Data Source, Address, Addr, Network Address | - | host, host\instance, host,port, ou tcp:host,port. . e (local) significa esta máquina; (localdb)\MSSQLLocalDB é LocalDB. Uma instância nomeada é encontrada através do SQL Server Browser na UDP 1434. |
Database |
Catálogo Inicial | o banco de dados padrão do login | Banco de dados a usar depois de conectar. |
User ID |
UID, Usuário | - | Login do SQL, ou o nome de usuário Entra para Active Directory Password / Interactive. |
Password |
PWD | - | Ignorado quando Integrated Security está ativado. |
Integrated Security |
Trusted_Connection | falso | true, yes ou sspi entra como a conta Windows que está executando o processo (Kerberos ou NTLM). |
Authentication |
- | não definido | Sql Password, Active Directory Integrated, Active Directory Interactive, Active Directory Default, Active Directory Managed Identity (alias Active Directory MSI), Active Directory Service Principal, Active Directory Device Code Flow, Active Directory Workload Identity (5.2+), Active Directory Password (obsoleto). A partir da versão 7.0, os métodos Entra precisam do Microsoft.Data.SqlClient.Extensions.Azure pacote. |
Encrypt |
- | true (Obrigatório) no 4.0+; false no 3.x e anteriores |
true/yes/Mandatory, false/no/Optional, ou Strict (5.x+, TDS 8.0: SQL Server 2022+ e Azure SQL). Com Optional o pacote de login ainda é criptografado, o resto não. |
TrustServerCertificate |
Confiar no Certificado do Servidor | falso | true ignora a validação do certificado. É ignorado (tratado como falso) com Encrypt=Strict. |
HostNameInCertificate |
Nome do host no certificado | - | 5.0+. O nome esperado no certificado do servidor quando difere de Server, por exemplo, ao conectar-se através de um alias ou endereço IP. |
ServerCertificate |
Certificado do servidor | - | 5.1+. Caminho para um arquivo de certificado que deve coincidir exatamente com o certificado do servidor. |
Connect Timeout |
Tempo limite de conexão, Timeout | 15 | Segundos para aguardar uma conexão antes de falhar. |
Command Timeout |
- | 30 | 2.1+. Padrão SqlCommand.CommandTimeout em segundos; 0 aguarda para sempre. |
Application Name |
App | Core Microsoft SqlClient Data Provider (.NET) |
Aparece como program_name em sys.dm_exec_sessions e no Profiler / Eventos Estendidos. |
ApplicationIntent |
Intenção do aplicativo | ReadWrite | ReadOnly encaminha para um secundário legível de um grupo de disponibilidade ou uma réplica de leitura no Azure SQL. |
MultiSubnetFailover |
Failover de múltiplas sub-redes | falso | Defina como true ao se conectar a um listener de grupo de disponibilidade que abrange sub-redes, para failover mais rápido. |
MultipleActiveResultSets |
Múltiplos conjuntos de resultados ativos | falso | MARS: vários leitores abertos em uma conexão. |
Pooling |
- | true | Pool de conexões. |
Max Pool Size |
- | 100 | Maior número de conexões no pool por string de conexão distinta. |
Min Pool Size |
- | 0 | Conexões mantidas abertas no pool. |
ConnectRetryCount |
Número de tentativas de conexão | 1 | 0 a 255 tentativas de reconexão após uma conexão ociosa ser interrompida. |
ConnectRetryInterval |
Intervalo entre tentativas de conexão | 10 | 1 a 60 segundos entre essas tentativas. |
Persist Security Info |
PersistSecurityInfo | falso | true deixa a senha legível em ConnectionString depois de abrir. Mantenha desativado. |
Palavras-chave do ODBC Driver 18 para SQL Server
Usado por pyodbc, R, PHP, Excel e qualquer outra coisa que use ODBC. Coloque valores que contenham caracteres especiais ([]{}(),;?*=!@) entre chaves. Diferente do ADO.NET, quando uma palavra-chave se repete, a primeira ocorrência vence.
| Palavra-chave | Sinônimos | Padrão | O que faz |
|---|---|---|---|
Driver |
- | - | {ODBC Driver 18 for SQL Server} (ou 17). Deve corresponder ao nome listado pelo gerenciador de drivers. |
Server |
Endereço, Addr | - | [tcp:]host[\instance][,port]. |
Database |
- | login padrão | Nome do banco de dados. |
UID / PWD |
- | - | Login e senha SQL. |
Trusted_Connection |
- | não | yes usa autenticação do Windows. |
Authentication |
- | - | SqlPassword, ActiveDirectoryIntegrated, ActiveDirectoryInteractive (Windows), ActiveDirectoryMsi, ActiveDirectoryServicePrincipal, ActiveDirectoryPassword (obsoleto). Não há ActiveDirectoryDefault em ODBC. |
Encrypt |
- | sim (Driver 18), não (17 e anteriores) | yes/mandatory, no/optional, strict (18.1.2.1+). |
TrustServerCertificate |
- | não | yes ignora a validação do certificado; é ignorado com Encrypt=strict. |
HostnameInCertificate |
- | - | 18.0+. Nome de host esperado no certificado. |
ServerCertificate |
- | - | 18.1+. Arquivo de certificado contra o qual o certificado do servidor é conferido. |
ConnectTimeout |
- | 15 | 18.7+. Tempo limite de login em segundos; 0 significa sem limite. Drivers mais antigos só aceitam SQL_ATTR_LOGIN_TIMEOUT do código. |
APP |
- | - | Nome do aplicativo. |
ApplicationIntent |
- | ReadWrite | ReadOnly para secundários legíveis. |
MultiSubnetFailover |
- | Não | Yes para grupos de disponibilidade com múltiplas sub-redes. |
Propriedades do Microsoft JDBC Driver para SQL Server
Formato da URL: jdbc:sqlserver://[serverName[\instanceName][:portNumber]][;property=value...]. Nomes de propriedades não diferenciam maiúsculas de minúsculas. Um valor contendo ; vai entre chaves, e a partir do driver 8.4 uma chave de fechamento dentro das chaves é duplicada: password={pass;}}word}.
| Palavra-chave | Sinônimos | Padrão | O que faz |
|---|---|---|---|
databaseName |
banco de dados | - | Nome do banco de dados. |
user |
userName | - | Nome de login. |
password |
- | - | Senha. |
integratedSecurity |
- | falso | Autenticação Windows. No Windows é necessário mssql-jdbc_auth-<version>.dll; em outros lugares adicione authenticationScheme=JavaKerberos. |
authentication |
- | NãoEspecificado | SqlPassword, ActiveDirectoryPassword, ActiveDirectoryIntegrated, ActiveDirectoryInteractive (9.2+), ActiveDirectoryServicePrincipal (9.2+), ActiveDirectoryManagedIdentity (12.2+; ActiveDirectoryMSI antes). |
encrypt |
- | true (10.2+); false (9.4 e versões anteriores) | true, false, ou strict (11.2+). |
trustServerCertificate |
- | falso | true ignora a validação do certificado. |
hostNameInCertificate |
- | - | Nome do host esperado no certificado. |
serverCertificate |
- | - | 11.2+. Arquivo de certificado para conferência, usado com strict. |
loginTimeout |
- | 30 (11.2+), 15 (mais antigos) | Segundos para aguardar o login. |
queryTimeout |
- | -1 (sem limite) | Tempo limite padrão da consulta em segundos. |
applicationName |
- | Microsoft JDBC Driver para SQL Server | Nome do aplicativo. |
applicationIntent |
- | ReadWrite | ReadOnly para secundários legíveis. |
multiSubnetFailover |
- | falso | Grupos de disponibilidade multi-sub-rede. |
instanceName |
- | - | Instância nomeada, como uma alternativa para host\instance na URL. |
Parâmetros de URL do go-mssqldb
Formato da URL: sqlserver://user:password@host:port?database=... ou sqlserver://user:password@host/instance?.... O caminho é o nome da instância, nunca o banco de dados. Use percent-encoding nos caracteres especiais do usuário e da senha. Os nomes dos parâmetros não diferenciam maiúsculas de minúsculas.
| Palavra-chave | Sinônimos | Padrão | O que faz |
|---|---|---|---|
database |
- | - | Nome do banco de dados. |
encrypt |
- | false (apenas pacote de login) | strict, disable (sem TLS algum), false, true. Note que o padrão difere dos drivers da própria Microsoft. |
TrustServerCertificate |
- | false quando encrypt está definido, true quando não está | true ignora a validação do certificado. |
app name |
- | go-mssqldb | Nome do aplicativo (escreva-o app+name ou app%20name na URL). |
connection timeout |
- | 0 (nenhum) | Segundos para toda a conexão. |
dial timeout |
- | 15 por protocolo registrado | Segundos para a discagem TCP. |
fedauth |
- | - | Métodos Entra (ActiveDirectoryDefault, ActiveDirectoryManagedIdentity, ActiveDirectoryPassword, ...) com o azuread pacote e o azuresql nome do driver. |
Erros comuns de conexão do SQL Server
The certificate chain was issued by an authority that is not trusted.
Por que: Microsoft.Data.SqlClient 4.0+, ODBC Driver 18 e JDBC 10.2+ criptografam por padrão e validam o certificado do servidor. O servidor está usando seu certificado autoassinado gerado automaticamente ou um certificado de uma CA privada que sua máquina não confia.
Correção: Instale um certificado de uma CA confiável no servidor (ou confie na sua CA interna no cliente). Se o certificado for válido, mas para outro nome, defina HostNameInCertificate. Apenas para um servidor de desenvolvimento local, TrustServerCertificate=True faz você começar.
Login failed for user 'app_user'. (Error 18456)
Por que: Senha incorreta, um login SQL em um servidor que permite apenas autenticação do Windows, um login desativado ou um banco de dados padrão que o login não pode abrir. O log do servidor registra o motivo real como um número de estado.
Correção: Verifique a senha, habilite o modo de autenticação SQL Server e Windows se você usar logins SQL, e defina Database para um que o login possa abrir. O estado no log de erros do servidor (por exemplo, Estado 8 = senha incorreta, Estado 38 = banco de dados indisponível) aponta a causa exata.
Keyword not supported: 'host'.
Por que: Microsoft.Data.SqlClient aceita apenas suas próprias palavras-chave. Host, Username e Port são palavras-chave do Npgsql/MySQL; Provider= pertence a strings de conexão OLE DB; um erro de digitação como Databse falha da mesma forma.
Correção: Use Server, User ID, e host,port. Cole a string no decodificador acima: toda palavra-chave desconhecida é sinalizada.
Format of the initialization string does not conform to specification starting at index 42.
Por que: Um valor contém ; ou uma aspa e não foi colocado entre aspas, então o parser divide a string no lugar errado. Senhas são o culpado habitual.
Correção: Coloque o valor entre aspas duplas e duplique qualquer aspa dupla dentro: Password="p;a""ss". O construtor escapa os valores para você.
The target principal name is incorrect. Cannot generate SSPI context.
Por que: A segurança integrada usa Kerberos, e o nome principal do serviço (SPN) do serviço SQL Server está ausente, duplicado ou registrado para outra conta, ou você se conectou por endereço IP ou alias.
Correção: Conecte-se com o nome totalmente qualificado do servidor e peça a um administrador para registrar o SPN (setspn -L <service account> as lista). Com uma incompatibilidade no nome do certificado, também verifique HostNameInCertificate.
FAQ de string de conexão do SQL Server
Qual é a porta padrão do SQL Server?
1433 para a instância padrão. Instâncias nomeadas geralmente usam uma porta dinâmica que o SQL Server Browser (UDP 1434) informa ao cliente, que é por isso host\instance funciona sem uma porta. No ADO.NET e ODBC, a porta vai depois de uma vírgula: Server=host,1433.
Devo usar Encrypt=True ou TrustServerCertificate=True?
Use Encrypt=True (ou Strict no SQL Server 2022 e no Azure SQL) com um certificado no qual seus clientes confiam. TrustServerCertificate=True mantém o tráfego criptografado, mas impede que o cliente verifique com quem está falando, então qualquer pessoa que consiga interceptar a conexão pode se passar pelo servidor. Mantenha isso para desenvolvimento local.
O que mudou com Encrypt no Microsoft.Data.SqlClient 4.0?
O padrão para Encrypt mudou de false para true, e o driver valida o certificado do servidor por padrão. O ODBC Driver 18 e o JDBC Driver 10.2 fizeram a mesma mudança. Strings sem uma Encrypt palavra-chave que antes se conectavam sem TLS agora precisam de um certificado confiável no servidor.
Como faço para me conectar ao Azure SQL Database com o Microsoft Entra ID?
Adicionar Authentication=Active Directory Default (pega uma identidade gerenciada, credenciais de ambiente ou seu login no Azure CLI / Visual Studio) e deixe de fora a senha. Use Active Directory Managed Identity em aplicativos hospedados no Azure e Active Directory Interactive para login via navegador. O Azure SQL não aceita Integrated Security=SSPI.
Qual é a diferença entre Data Source e Server, ou Initial Catalog e Database?
Nenhum. Eles são sinônimos no Microsoft.Data.SqlClient, assim como User ID / UID / User e Password / PWD. Se as duas grafias aparecerem, a última vale.
O System.Data.SqlClient usa a mesma string de conexão?
Em grande parte. Aceita as palavras-chave clássicas, mas não as mais recentes, como Command Timeout, Encrypt=Strict, HostNameInCertificate ou a maioria dos valores de Authentication valores, e o padrão é Encrypt=False. A Microsoft recomenda migrar para o Microsoft.Data.SqlClient.
Outros mecanismos
- Strings de conexão do PostgreSQL
- Strings de conexão do MySQL
- Strings de conexão do MariaDB
- Strings de conexão do SQLite
- Strings de conexão do Oracle
- Strings de conexão do Redis
- Strings de conexão do ClickHouse
- Strings de conexão do DuckDB
- Strings de conexão do libSQL
- Todos os mecanismos e formatos
- Formatador SQL
- Todas as ferramentas gratuitas
Conecte-se uma vez. Depois é só escrever SQL.
O SQLly é um ambiente de trabalho SQL nativo para macOS, Windows e Linux. Cole uma string de conexão no editor de conexões, mantenha as senhas no chaveiro do sistema e tenha IntelliSense baseado no esquema no SQL Server e muito mais.