// ferramenta gratuita

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.

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

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).

// 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 MySQL e muito mais.