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

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.