Construtor de String de Conexão ao Banco de Dados
Crie uma URI de conexão ao banco de dados e configuração em estilo .env a partir de campos host, port e credenciais — PostgreSQL, MySQL, MariaDB, MongoDB, Redis, MSSQL e SQLite. Trata automaticamente de URL-encoding de caracteres especiais, hosts IPv6 e caminhos de Unix socket.
Entrada
Apenas PostgreSQL, MySQL e MariaDB suportam Unix domain sockets aqui.
Endereços IPv6 (por exemplo ::1) são automaticamente envolvidos em colchetes.
Deixe em branco para usar a porta padrão do banco de dados selecionado.
Para Redis este é o índice de banco de dados numérico (0-15). Opcional — omita para usar o padrão do driver.
URL-encoded automaticamente onde quer que apareça na URI — é seguro usar @, :, / ou # nela.
PostgreSQL: sslmode=require · MySQL/MariaDB: ssl=true · MongoDB: tls=true · Redis: rediss:// · MSSQL: encrypt=true
Opcional. Um par key=value por linha, anexado como parâmetros de string de query extras.
Saída
DATABASE_URL mais os mesmos valores decompostos em variáveis DB_* individuais.
Mais formas de usar esta ferramenta
API REST
curl -X POST https://api.iotools.cloud/v1/tool/database-connection-string-builder \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"dbType": "postgresql",
"connectionMode": "tcp",
"host": "db.example.com",
"socketPath": "",
"port": "",
"mongoSrv": "",
"database": "myapp",
"filePath": "",
"username": "app_user",
"password": "p@ss:w/ord#1",
"ssl": "true",
"extraParams": ""
}'Troque pela sua própria chave, da sua conta. Os campos da ferramenta viram o corpo da requisição — sem envelope.
Peça a um agente de IA
Use the IOTools `database-connection-string-builder` tool (Database Connection String Builder) on this input:
YOUR_INPUT_HERECole isto em qualquer agente conectado ao servidor MCP do IOTools e depois adicione sua entrada.
Widget para incorporar
<iframe
src="https://iotools.cloud/embed/database-connection-string-builder/"
width="100%" height="520" frameborder="0" scrolling="no" loading="lazy"
title="Construtor de String de Conexão ao Banco de Dados — iotools.cloud"
sandbox="allow-scripts allow-forms allow-same-origin allow-downloads allow-popups allow-popups-to-escape-sandbox"
allow="clipboard-write"
style="width:100%;border:1px solid #e5e7eb;border-radius:12px;overflow:hidden"></iframe>
<script src="https://iotools.cloud/embed.js" async></script>Coloque isso na sua própria página — grátis, sem chave, só um link de volta.
| Custo por chamada de API/MCP | A partir de 5 créditos |
|---|---|
| Precisa de mais créditos? | Ver preços |
Também disponível via
Guias
O Construtor de String de Conexão ao Banco de Dados transforma campos simples de host, port e credenciais em uma URI de conexão formatada corretamente — para PostgreSQL, MySQL, MariaDB, MongoDB, Redis, Microsoft SQL Server e SQLite. Também produz um bloco .env pronto para colar com DATABASE_URL e os valores individuais DB_HOST, DB_PORT, DB_NAME, DB_USER e DB_PASSWORD decompostos.
Cada driver de banco de dados tem seu próprio esquema URI, sua própria porta padrão e suas próprias regras sobre o que precisa de percent-encoding. Uma senha contendo @, :, / ou # silenciosamente quebra uma string de conexão digitada à mão, a menos que cada caractere reservado seja escapado — uma das causas mais comuns de um erro "connection refused" ou de autenticação que não tem nada a ver com as credenciais reais. Esta ferramenta codifica caracteres especiais automaticamente, então você nunca precisa se lembrar quais caracteres são seguros.
Como usar
- Escolha um tipo de banco de dados. O formulário se adapta — SQLite substitui host/port por um caminho de arquivo; MySQL e PostgreSQL oferecem uma opção de Unix socket.
- Preencha host, port (deixe em branco para usar o padrão do banco de dados), nome do banco de dados, usuário e senha.
- Ative Usar SSL/TLS se sua conexão exigir criptografia.
- Copie a URI de Conexão para sua configuração de ORM/driver, ou o bloco .env para colar diretamente em um arquivo
.env.
O que ela funciona
- URL-encoding — nomes de usuário, senhas e nomes de banco de dados são percent-encoded onde quer que apareçam na URI, portanto caracteres especiais como
@,:,/e#em uma senha nunca quebram a string. - Hosts IPv6 — um endereço como
::1ou2001:db8::1é automaticamente envolvido em colchetes ([::1]), conforme exigido pela especificação URI. - Unix domain sockets — PostgreSQL, MySQL e MariaDB suportam um modo de conexão de caminho de socket no lugar de host/port.
- MongoDB SRV records — um toggle "Usar conexão SRV" produz uma URI
mongodb+srv://(sem porta) para serviços como MongoDB Atlas. - Caminhos SQLite — caminhos de arquivo relativos e absolutos obtêm a convenção correta de contagem de barras (
sqlite:///relative/path.dbvssqlite:////absolute/path.db), o formato que SQLAlchemy e muitos outros parsers de URI SQLite esperam.
Por que o esquema URI diz mysql:// para MariaDB?
MariaDB é compatível por fio com MySQL, e cada driver e ORM mainstream (Prisma, Sequelize, Knex, node-mysql2) aceita o mesmo esquema mysql:// para ambos — não há um esquema mariadb:// amplamente adotado.
E quanto ao Microsoft SQL Server?
Muitos drivers Node.js e Python aceitam a URI mssql:// que esta ferramenta gera, mas o tooling SQL Server no Windows/.NET mais comumente usa sintaxe de palavra-chave ADO.NET em vez disso (Server=host,port;Database=db;User Id=user;Password=pass;). Use os valores host/port/username/password gerados para construir esse formato se seu driver esperar.
O formato de string de query do caminho do Unix socket é padronizado?
Não universalmente. A convenção PostgreSQL ?host=/socket/dir é documentada na especificação URI libpq oficial; drivers MySQL/MariaDB variam (alguns leem ?socket=, outros pegam uma opção de conexão separada completamente) — consulte a documentação do seu driver específico antes de confiar na URI de socket gerada literalmente.
Privacidade
Esta ferramenta é executada inteiramente em seu navegador — o host, as credenciais e as strings de conexão geradas nunca são enviadas para um servidor. Para analisar um arquivo .env existente em vez de construir um, use o Env File Parser. Para URL-codificar uma senha ou outro valor por conta própria, use o URL Encoder/Decoder.