// ferramenta gratuita

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.

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-chaveSinônimosPadrãoO 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-chaveSinônimosPadrãoO 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-chaveSinônimosPadrãoO 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-chaveSinônimosPadrãoO 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.

// dispense as strings por completo

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.