O que é uma string de conexão PostgreSQL?

Uma string de conexão PostgreSQL é um texto formatado que agrupa todas as informações necessárias para conectar a um banco de dados — hostname, porta, credenciais, nome do banco de dados e configurações SSL — em um único valor. Aplicações, ORMs e ferramentas de linha de comando usam strings de conexão para estabelecer sessões de banco de dados sem exigir que cada parâmetro seja configurado separadamente. Existem dois formatos comuns: o formato URI (postgresql://user:password@host:port/dbname) e o formato libpq key=value (host=localhost port=5432 dbname=mydb). Ambos os formatos são suportados em praticamente todas as bibliotecas de cliente PostgreSQL.

Descrição da ferramenta

Esta ferramenta gera strings de conexão PostgreSQL válidas a partir de parâmetros individuais. Preencha o host, porta, credenciais, nome do banco de dados e modo SSL, e ela produz instantaneamente três saídas prontas para uso: uma URL de conexão, um comando psql e uma string libpq key=value.

Exemplos

Entrada:

Campo Valor
Host db.example.com
Porta 5432
Usuário alice
Senha s3cr3t
Banco de dados production
Modo SSL require

URL de conexão:

postgresql://alice:s3cr3t@db.example.com/production?sslmode=require

Comando psql:

psql "postgresql://alice:s3cr3t@db.example.com/production?sslmode=require"

String libpq key=value:

host=db.example.com port=5432 dbname=production user=alice password=s3cr3t sslmode=require

Recursos

  • Três formatos de saída: Gera uma URL de conexão, comando shell psql e string libpq key=value simultaneamente
  • Seletor de modo SSL: Suporta todos os seis modos SSL do PostgreSQL — disable, allow, prefer, require, verify-ca e verify-full
  • Padrões inteligentes: Omite valores padrão (porta 5432, sslmode=prefer) para manter a saída limpa e mínima
  • Codificação de URL: Codifica automaticamente em percentual nomes de usuário, senhas e nomes de banco de dados contendo caracteres especiais
  • Validação de porta: Valida que a porta é um número entre 1 e 65535

Casos de uso

  • Configuração de aplicação: Gere uma variável de ambiente DATABASE_URL para frameworks como Django, Rails ou qualquer aplicação que use uma string de conexão
  • Acesso rápido via CLI: Produza um comando psql pronto para executar e conectar a um banco de dados remoto sem memorizar a sintaxe URI
  • Depuração de conexão: Construa uma string libpq para testar conexões com drivers de baixo nível ou ferramentas que não aceitam formato URI

Modos SSL explicados

Modo Descrição
disable Sem SSL. A conexão não é criptografada.
allow Usa SSL se o servidor exigir; caso contrário, conecta sem SSL.
prefer Tenta SSL primeiro; volta para não criptografado (padrão).
require Exige SSL mas não verifica o certificado do servidor.
verify-ca Exige SSL e verifica que o certificado do servidor é assinado por uma CA confiável.
verify-full Exige SSL, verifica a CA e também verifica se o hostname corresponde ao certificado.