// ferramenta gratuita

Construtor de string de conexão MariaDB

Construa uma URL JDBC MariaDB, string ADO.NET ou DSN do Go a partir de um único formulário, ou cole uma para ver o que cada opção faz e se o TLS é realmente verificado. 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 MariaDB

O MariaDB fala o protocolo MySQL, então os drivers MySQL (MySqlConnector, go-sql-driver/mysql, mysql2) se conectam a ele com as mesmas strings. O Connector/J do próprio MariaDB usa jdbc:mariadb:// e diferentes sslMode palavras do que o MySQL: disable, trust, verify-ca, verify-full.

Atenção ao padrão do Connector/J: a versão 3.x conecta sem TLS quando sslMode não está definido, e a 4.0 mudou o padrão para verify-full, o que falha contra um servidor com certificado autoassinado.

JDBC MariaDB Connector/J

jdbc:mariadb://db.example.com/sales?user=app_user&password=your_password&sslMode=verify-full

ADO.NET MySqlConnector

Server=db.example.com;Database=sales;User ID=app_user;Password=your_password;SslMode=VerifyFull;

Go DSN github.com/go-sql-driver/mysql

app_user:your_password@tcp(db.example.com)/sales?tls=true

URL do SQLAlchemy MariaDB Connector/Python

mariadb+mariadbconnector://app_user:[email protected]/sales

URI SQLly e ferramentas estilo URI

mariadb://app_user:[email protected]/sales?ssl-mode=VERIFY_IDENTITY

Marcadores como your_password são exatamente isso: monte sua própria string no formulário acima. Mais sobre como conectar o SQLly ao MariaDB: SQLly para MariaDB.

Opções do MariaDB Connector/J

Formato da URL: jdbc:mariadb:[replication:|loadbalance:|sequential:]//host[:port][,...]/[database][?key=value&...]. O Connector/J 3.x só aceita jdbc:mysql: com permitMysqlScheme.

Palavra-chaveSinônimosPadrãoO que faz
user / password - - Credenciais.
sslMode - disable (3.x); verify-full (4.0+) disable, trust (criptografar, sem verificações), verify-ca, verify-full, e allow (3.5.11+).
serverSslCert - - Certificado CA ou do servidor (caminho ou PEM) para verify-ca / verify-full.
connectTimeout - 30000 Milissegundos para aguardar a conexão.
socketTimeout - 0 Milissegundos que uma leitura pode ficar bloqueada.
allowPublicKeyRetrieval - falso Solicitar a chave RSA do servidor sem TLS.

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.

Erros comuns de conexão do MariaDB

Access denied for user 'app_user'@'10.0.0.7' (using password: YES)

Por que: Senha incorreta, ou a conta está definida para outro padrão de host.

Correção: Verificar SELECT user, host FROM mysql.user e criar ou conceder a conta para o host de onde você se conecta.

Could not connect to address=(host=db.example.com)(port=3306)(type=primary) : ... certificate

Por que: O Connector/J 4.0+ usa por padrão sslMode=verify-full, e o servidor apresenta um certificado autoassinado ou um para outro nome.

Correção: Forneça ao driver a CA com serverSslCert=/path/ca.pem, ou use um certificado para o nome do host ao qual você se conecta. sslMode=trust criptografa sem verificar e é apenas para redes confiáveis.

Host '10.0.0.7' is not allowed to connect to this MariaDB server

Por que: Nenhuma conta corresponde ao seu nome de usuário e host do cliente.

Correção: Crie a conta para seu host ou um padrão como 'app_user'@'10.0.0.%'.

Unknown database 'sales'

Por que: O banco de dados na string não existe ou está escrito de forma diferente.

Correção: Verificar SHOW DATABASES;.

FAQ de string de conexão do MariaDB

Posso usar um driver MySQL com o MariaDB?

Sim, para os casos comuns. O MariaDB mantém o protocolo do cliente MySQL, então MySqlConnector, Connector/NET, go-sql-driver/mysql, mysql2 e PyMySQL conectam com as mesmas strings. Recursos específicos do MariaDB são melhor cobertos pelos próprios conectores do MariaDB.

O que significa sslMode=trust?

É o equivalente, no MariaDB Connector/J, ao REQUIRED: a conexão é criptografada, mas o certificado do servidor não é verificado. Use verify-full com serverSslCert para também verificar o servidor.

Qual é a porta padrão do MariaDB?

3306, a mesma do MySQL.

Por que minha conexão JDBC com MariaDB quebrou após atualizar o Connector/J?

O Connector/J 4.0 mudou o sslMode padrão de disable para verify-full. Um servidor sem TLS, ou com certificado autoassinado, agora falha. Configure o TLS direito, ou defina sslMode explicitamente.

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