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.
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.
Escolha seu banco de dados
Cada página de mecanismo abre o construtor nesse mecanismo e adiciona uma referência completa de palavras-chave, seus erros comuns de conexão e suas soluções.
SQL Server
ADO.NET, ODBC, JDBC, URL do Go, URL do SQLAlchemy
PostgreSQL
URI, Palavra-chave/valor, ADO.NET (Npgsql), JDBC, ODBC
MySQL
URI, JDBC, ADO.NET, ODBC, Go DSN
MariaDB
JDBC, ADO.NET, Go DSN, URL do SQLAlchemy, URI
SQLite
Caminho de arquivo, nome de arquivo URI (somente leitura), ADO.NET, JDBC, URL do SQLAlchemy
Oracle
Easy Connect, Easy Connect sobre TLS, descritor de conexão, JDBC thin, ADO.NET (ODP.NET)
Redis
URI com TLS, URI com um usuário ACL (Redis 6+), StackExchange.Redis, redis-cli
ClickHouse
URL HTTP, DSN nativo, JDBC, ADO.NET
DuckDB
Caminho de arquivo, JDBC, URL do SQLAlchemy, CLI, somente leitura
libSQL
URL do banco de dados, URL com token de autenticação, sqld local
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.
| Formato | Parece com | Caracteres especiais |
|---|---|---|
| URL / URI | postgresql://user:pass@host:5432/db?sslmode=verify-full | Aplique percent-encoding aos caracteres reservados no usuário, senha e banco de dados: @ → %40, : → %3A, / → %2F, ? → %3F, # → %23, % → %25, espaço → %20. |
| ADO.NET | Server=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". |
| ODBC | Driver={ODBC Driver 18 for SQL Server};Server=host;Pwd={p;w}; | Coloque o valor entre chaves. Nomes de driver sempre são. |
| JDBC | jdbc:sqlserver://host;databaseName=db, jdbc:postgresql://host/db?user=u | Específico do fornecedor. Microsoft: chaves, com } duplicadas. PostgreSQL, MySQL, MariaDB: na query da URL, então use percent-encoding. |
| Palavra-chave/valor libpq | host=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 Go | user:pass@tcp(host:3306)/db?tls=true | A 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.Redis | host:6380,password=p,ssl=true | Vírgulas separam opções, portanto uma senha com vírgula precisa ser definida no código. |
| Oracle Easy Connect | host:1521/service_name | Sem 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=truste do pgJDBCNonValidatingFactorytodos criptografam sem verificar quem respondeu. - Sem TLS, ou TLS que pode reverter.
sslmode=disableouprefer,Encrypt=False,ssl-mode=DISABLED,redis://com uma senha, HTTP simples para ClickHouse. - Padrões que mudaram. Não
Encryptsignifica 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:portonde o SQL Server desejahost,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.
Guias de mecanismos
- Strings de conexão do SQL Server
- 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
- 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 banco de dados e muito mais.