// ferramenta gratuita

Construtor e decodificador de string de conexão

Preencha um formulário e obtenha a string de conexão em todos os formatos usados pelos seus drivers - ADO.NET, JDBC, ODBC, URLs, libpq, DSNs do Go e mais - lado a lado. Ou cole uma para ver o que cada 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 string de conexão e como escapá-los

A maioria dos bugs de string de conexão são bugs de escape: uma senha com um @, um ; ou uma aspa que o driver divide no lugar errado. Cada formato tem sua própria regra.

FormatoParece comCaracteres especiais
URL / URIpostgresql://user:pass@host:5432/db?sslmode=verify-fullAplique percent-encoding aos caracteres reservados no usuário, senha e banco de dados: @ → %40, : → %3A, / → %2F, ? → %3F, # → %23, % → %25, espaço → %20.
ADO.NETServer=host;Database=db;User ID=u;Password=p;Envolva um valor com ;, um espaço no começo ou no fim, ou uma aspa no início em "…" (ou '…'), e duplique o caractere de aspas dentro: Password="a;b""c".
ODBCDriver={ODBC Driver 18 for SQL Server};Server=host;Pwd={p;w};Coloque o valor entre chaves. Nomes de driver sempre são.
JDBCjdbc:sqlserver://host;databaseName=db, jdbc:postgresql://host/db?user=uEspecífico do fornecedor. Microsoft: chaves, com } duplicadas. PostgreSQL, MySQL, MariaDB: na query da URL, então use percent-encoding.
Palavra-chave/valor libpqhost=h dbname=db user=u password='a b'Coloque entre aspas simples valores que estão vazios ou contêm espaços; escreva \' e \\ para uma aspa ou barra invertida.
DSN do MySQL para Gouser:pass@tcp(host:3306)/db?tls=trueA senha não precisa de escape; valores de parâmetro são codificados em URL; nomes de parâmetro diferenciam maiúsculas de minúsculas.
StackExchange.Redishost:6380,password=p,ssl=trueVírgulas separam opções, portanto uma senha com vírgula precisa ser definida no código.
Oracle Easy Connecthost:1521/service_nameSem credenciais dentro; passe o usuário e a senha separadamente.

O que o decodificador verifica

  • Verificações de certificado desativadas. TrustServerCertificate=true, sslmode=require, tls=skip-verify, sslMode=trust e do pgJDBC NonValidatingFactory todos criptografam sem verificar quem respondeu.
  • Sem TLS, ou TLS que pode reverter. sslmode=disable ou prefer, Encrypt=False, ssl-mode=DISABLED, redis:// com uma senha, HTTP simples para ClickHouse.
  • Padrões que mudaram. Não Encrypt significa criptografado e validado no Microsoft.Data.SqlClient 4.0+, ODBC Driver 18 e JDBC 10.2+, mas não em drivers mais antigos ou go-mssqldb.
  • Segredos na string. Senhas em texto simples e tokens de autenticação, Persist Security Info=True, tokens Turso que expiraram.
  • Erros de digitação e palavras-chave emprestadas. Chaves desconhecidas para o driver detectado, host:port onde o SQL Server deseja host,port, parâmetros Go sensíveis a maiúsculas e minúsculas, sem escape @ em senhas de URL, um SID Oracle que deveria ser um nome de serviço.
  • Como o SQLly lê isso. O decodificador também executa as mesmas regras do próprio leitor de strings de conexão do aplicativo SQLly, para que você saiba o que o aplicativo irá preencher.

FAQ sobre string de conexão

Minha string de conexão é enviada para algum lugar?

Não. O construtor e o decodificador são JavaScript que rodam na aba do seu navegador. Nada que você digitar ou colar é enviado, registrado ou armazenado, nem mesmo no armazenamento do seu navegador, e a página continua funcionando com a rede desligada depois que ela é carregada.

Quais bancos de dados e drivers ele cobre?

SQL Server e Azure SQL, PostgreSQL, MySQL, MariaDB, SQLite, Oracle, Redis e Valkey, ClickHouse, DuckDB e libSQL / Turso. Para cada mecanismo, ele gera os formatos que de fato existem nele: URLs, ADO.NET, JDBC, ODBC, strings de palavra-chave/valor do libpq, DSNs do Go, URLs do SQLAlchemy, strings do StackExchange.Redis, Easy Connect e descritores TNS do Oracle, além de código pronto para colar em Python e Node.js.

Como coloco caracteres especiais em uma senha?

Depende do formato. Em uma URL, codifique-os com percent-encoding: @ se torna %40, : se torna %3A, / se torna %2F, % se torna %25. Em uma string ADO.NET, coloque entre aspas um valor que contenha ; ou uma aspa e duplique qualquer aspa dupla interna. No ODBC e no driver JDBC da Microsoft, coloque entre chaves {...} e duplique uma chave de fechamento. Em uma string de palavra-chave/valor do libpq, use aspas simples e escape com barra invertida ' e \. O construtor faz tudo isso para você.

O que o decodificador verifica?

Ele lê a string do jeito que o driver faria, lista cada chave com o que ela faz e sinaliza problemas: verificação de certificado desativada (TrustServerCertificate=true, sslmode=require, tls=skip-verify), TLS desativado ou opcional, senhas e tokens em texto puro, palavras-chave digitadas errado ou desconhecidas, host:port onde o SQL Server deseja host,port, caracteres sem escape em senhas de URL, confusões entre SID e nome de serviço no Oracle, e padrões que mudaram entre versões de driver, como Encrypt no Microsoft.Data.SqlClient 4.0.

Por que minha conexão falha com um erro de certificado após a atualização do driver?

Microsoft.Data.SqlClient 4.0, ODBC Driver 18 e o Microsoft JDBC Driver 10.2 passaram a criptografar por padrão e a validar o certificado do servidor. Um SQL Server que ainda usa seu certificado autoassinado então falha com «The certificate chain was issued by an authority that is not trusted». Instale um certificado de uma CA em que seus clientes confiem; defina TrustServerCertificate=true only for local development.

O que é «Abrir no SQLly»?

O SQLly é um cliente SQL desktop para macOS, Windows e Linux. O botão cria um sqlly://connection/new link que abre o editor de conexão do SQLly já preenchido com seu host, porta, banco de dados e usuário. A senha só é colocada no link se você marcar a caixa, e o SQLly nunca a escreve em seu arquivo de conexão. O link vai diretamente do seu navegador para o aplicativo no seu computador; ele não passa por nenhum servidor.

// 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 banco de dados e muito mais.