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.
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 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-chave | Sinônimos | Padrão | O 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-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. |
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.
Outros 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 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 MariaDB e muito mais.