Construtor de string de conexão MySQL
Construa um URI de conexão MySQL, URL JDBC, string ADO.NET, string ODBC ou DSN para Go a partir de um formulário, ou cole um para ver o que cada opção faz e identificar configurações inseguras como allowPublicKeyRetrieval. 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 string de conexão MySQL
O MySQL não possui um padrão único de string de conexão. O Connector/J usa uma URL JDBC com propriedades em camelCase (sslMode, connectTimeout em milissegundos), o MySqlConnector e o Connector/NET usam ADO.NET Server=...; strings, o Connector/ODBC usa palavras-chave ODBC, o driver do Go tem o seu próprio user:pass@tcp(host:3306)/db DSN, e o MySQL Shell aceita um URI com ssl-mode.
TLS padrão para PREFERRED quase em todos os lugares: criptografado quando o servidor o suporta, mas o certificado não é verificado. VERIFY_IDENTITY (MySqlConnector: VerifyFull) verifica a CA e o nome do host.
URI MySQL Shell, mysql2, Prisma
mysql://app_user:[email protected]/sales?ssl-mode=VERIFY_IDENTITY
JDBC MySQL Connector/J
jdbc:mysql://db.example.com/sales?user=app_user&password=your_password&sslMode=VERIFY_IDENTITY
ADO.NET MySqlConnector, MySql.Data
Server=db.example.com;Database=sales;User ID=app_user;Password=your_password;SslMode=VerifyFull;
ODBC MySQL Connector/ODBC
Driver={MySQL ODBC 8.0 Unicode Driver};Server=db.example.com;Database=sales;Uid=app_user;Pwd=your_password;SslMode=VERIFY_IDENTITY;
Go DSN github.com/go-sql-driver/mysql
app_user:your_password@tcp(db.example.com)/sales?tls=true
URL do SQLAlchemy Python SQLAlchemy com PyMySQL
mysql+pymysql://app_user:[email protected]/sales?charset=utf8mb4
Marcadores como your_password são exatamente isso: monte sua própria string no formulário acima. Mais sobre como conectar o SQLly ao MySQL: SQLly para MySQL.
Propriedades do MySQL Connector/J
Formato da URL: jdbc:mysql://[host][:port][/database][?property=value&...]. Codifique os caracteres reservados em percent-encoding (/ : @ ( ) [ ] & # = ? e espaço) em todos os lugares, incluindo o usuário e a senha.
| Palavra-chave | Sinônimos | Padrão | O que faz |
|---|---|---|---|
user / password |
- | - | Credenciais. |
sslMode |
- | PREFERIDO | DISABLED, PREFERRED, REQUIRED, VERIFY_CA, VERIFY_IDENTITY. |
useSSL / requireSSL / verifyServerCertificate |
- | - | Obsoleto; ainda traduzido (useSSL=false = DISABLED). sslMode vence. |
connectTimeout |
- | 0 (nenhum) | Milissegundos para esperar a conexão do socket. |
socketTimeout |
- | 0 (nenhum) | Milissegundos que uma leitura pode ficar bloqueada. |
allowPublicKeyRetrieval |
- | falso | Permitir que o cliente solicite a chave RSA do servidor para caching_sha2_password sem TLS. |
connectionTimeZone |
serverTimezone | LOCAL | LOCAL, SERVER ou um ID de zona. |
characterEncoding |
- | utf8mb4 (8.0.26+) | Conjunto de caracteres Java. |
trustCertificateKeyStoreUrl |
- | - | Armazenamento de confiança com a CA do servidor, para VERIFY_CA / VERIFY_IDENTITY. |
rewriteBatchedStatements |
- | falso | Reescreve INSERTs em lote em instruções de múltiplas linhas. |
Opções do MySqlConnector (ADO.NET)
O MySqlConnector e o Connector/NET da Oracle (MySql.Data) compartilham a maioria das palavras-chave. Valores com ; vão entre aspas duplas.
| Palavra-chave | Sinônimos | Padrão | O que faz |
|---|---|---|---|
Server |
Host, Fonte de Dados, Endereço | localhost | Host, lista separada por vírgulas ou caminho de socket Unix. |
Port |
- | 3306 | Porta TCP. |
User ID |
UID, Usuário, Nome de Usuário | - | Nome do usuário. |
Password |
PWD | - | Senha. |
Database |
Catálogo Inicial | - | Esquema padrão. |
SslMode |
Modo SSL | Preferido | None/Disabled, Preferred, Required, VerifyCA, VerifyFull. |
SslCa |
Arquivo de Certificado CA, Ssl-Ca | - | Arquivo CA para VerifyCA / VerifyFull. |
Connection Timeout |
Tempo limite de conexão | 15 | Segundos. |
Default Command Timeout |
Tempo limite do comando | 30 | Segundos; 0 espera para sempre. |
Application Name |
- | - | Define o program_name atributo de conexão. |
AllowPublicKeyRetrieval |
- | falso | Veja o aviso acima. |
AllowUserVariables |
- | falso | Permitir @variables no SQL. |
Pooling |
- | true | Pool de conexões. |
Maximum Pool Size |
Tamanho máximo do pool | 100 | Maior pool. |
Minimum Pool Size |
Tamanho mínimo do pool | 0 | Menor pool. |
go-sql-driver/mysql DSN
Formulário: [user[:password]@][protocol[(address)]]/dbname[?param=value&...]. A senha não precisa de escape; o nome do banco de dados é escapado no caminho (1.8+); os valores dos parâmetros são escapados na consulta; os nomes dos parâmetros diferenciam maiúsculas de minúsculas.
| Palavra-chave | Sinônimos | Padrão | O que faz |
|---|---|---|---|
tcp(host:port) |
unix(/caminho) | tcp(127.0.0.1:3306) | Endereço; a porta padrão é 3306. |
tls |
- | falso | true (verificar), false, skip-verify (criptografar, sem verificações), preferred, ou um nome de configuração registrado. |
timeout |
- | Padrão do SO | Tempo limite de conexão (dial) com unidade: 10s. |
readTimeout / writeTimeout |
- | 0 | Timeouts de E/S com unidade. |
parseTime |
- | falso | Converter DATE e DATETIME para time.Time. |
loc |
- | UTC | Fuso horário para time.Time valores (escape / como %2F). |
collation |
- | utf8mb4_general_ci | Collation da conexão. |
allowCleartextPasswords |
- | falso | Enviar a senha em claro (somente via TLS). |
multiStatements |
- | falso | Várias instruções por consulta; amplia o impacto de injeção SQL. |
Palavras-chave do MySQL Connector/ODBC
As palavras-chave não diferenciam maiúsculas de minúsculas. O nome do driver deve corresponder ao que seu gerenciador ODBC registrou, que inclui a versão.
| Palavra-chave | Sinônimos | Padrão | O que faz |
|---|---|---|---|
Driver |
- | - | por exemplo. {MySQL ODBC 8.0 Unicode Driver}. |
Server |
- | localhost | Host. |
Port |
- | 3306 | Porta TCP. |
Database |
- | - | Esquema padrão. |
User |
UID | - | Nome do usuário. |
Password |
PWD | - | Senha. |
SSLMODE |
ssl-mode (8.0.29+) | PREFERIDO | DISABLED, PREFERRED, REQUIRED, VERIFY_CA, VERIFY_IDENTITY. |
Erros comuns de conexão com o MySQL
Access denied for user 'app_user'@'10.0.0.7' (using password: YES)
Por que: Erro 1045: senha incorreta, ou a conta existe para outro padrão de host ('app_user'@'localhost' é uma conta diferente de 'app_user'@'%').
Correção: Verifique a senha e SELECT user, host FROM mysql.user; crie ou conceda a conta para o host de onde você conecta.
Public Key Retrieval is not allowed
Por que: Connector/J com MySQL 8 caching_sha2_password em uma conexão sem TLS: o driver precisa da chave RSA do servidor para enviar a senha e não tem permissão para solicitá-la.
Correção: Use TLS (sslMode=REQUIRED ou mais forte). allowPublicKeyRetrieval=true também funciona, mas fica exposto a um atacante intermediário em uma rede não confiável.
Can't connect to MySQL server on 'db.example.com:3306' (110)
Por que: Erro 2003: o servidor não está acessível: host ou porta incorretos, bind-address limitado a 127.0.0.1, ou um firewall. (111 significa conexão recusada, 110 um tempo limite.)
Correção: Verificar bind-address e port no my.cnf, o firewall e o grupo de segurança da nuvem, então teste com nc -vz db.example.com 3306.
Host '10.0.0.7' is not allowed to connect to this MySQL server
Por que: Erro 1130: nenhuma conta corresponde a esse nome de usuário a partir do host do seu cliente.
Correção: Crie a conta para seu host ou um padrão: CREATE USER 'app_user'@'10.0.0.%' ... e conceda a ele os privilégios de que necessita.
Unknown database 'sales'
Por que: Erro 1049: o esquema na string não existe, ou o nome difere em maiúsculas e minúsculas em um servidor com nomes de tabela que diferenciam maiúsculas de minúsculas.
Correção: Verificar SHOW DATABASES; e a grafia exata.
Communications link failure
Por que: O Connector/J não pôde terminar de se comunicar com o servidor: queda de rede, falha no handshake TLS, wait_timeout fechando uma conexão ociosa do pool ou um proxy no caminho.
Correção: Verifique a causa interna. Para problemas de TLS, confira sslMode e o trust store; para descartes de conexões ociosas, defina o tempo de vida máximo do pool abaixo do wait_timeout.
Authentication plugin 'caching_sha2_password' cannot be loaded
Por que: Uma biblioteca de cliente antiga, anterior ao plugin de autenticação padrão do MySQL 8.
Correção: Atualize o cliente ou o conector. Alterando a conta para mysql_native_password é uma solução temporária; esse plugin está obsoleto.
FAQ de string de conexão MySQL
Qual é o formato da string de conexão MySQL?
Depende do driver. JDBC: jdbc:mysql://host:3306/db?user=...&password=.... ADO.NET: Server=host;Port=3306;Database=db;User ID=user;Password=...;. Go: user:password@tcp(host:3306)/db. O MySQL Shell e muitas ferramentas Node e ORM aceitam mysql://user:password@host:3306/db.
Qual é a porta padrão do MySQL?
3306 para o protocolo clássico e 33060 para o Protocolo X (mysqlx://).
Devo usar useSSL=false?
Não. useSSL está obsoleto no Connector/J; use sslMode. sslMode=DISABLED (o que useSSL=false mapeia) envia consultas e resultados em texto simples. Use VERIFY_IDENTITY com o CA do servidor onde você puder, ou pelo menos REQUIRED.
É seguro allowPublicKeyRetrieval=true?
Apenas via TLS ou em uma rede confiável. O padrão do MySQL 8 caching_sha2_password precisa de TLS ou da chave pública RSA do servidor para enviar a senha. Se o cliente puder buscar essa chave sem autenticação, um atacante no meio pode apresentar a chave dele e ler a senha. Prefira TLS (sslMode=REQUIRED ou mais forte).
Preciso escapar a senha em um DSN MySQL no Go?
Não. A documentação do go-sql-driver/mysql indica que a senha pode conter qualquer caractere sem escape; o driver divide na última @. Os valores dos parâmetros de consulta devem ser escapados para URL, e os nomes dos parâmetros diferenciam maiúsculas de minúsculas (parseTime, não parsetime).
Por que o connectTimeout é tão grande no JDBC?
O Connector/J connectTimeout e socketTimeout são expressos em milissegundos, e ambos têm 0 como padrão, ou seja, sem limite. connectTimeout=10000 é dez segundos. O MySqlConnector Connection Timeout é em segundos (padrão 15).
Outros mecanismos
- Strings de conexão do SQL Server
- Strings de conexão do PostgreSQL
- 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 MySQL e muito mais.