// ferramenta gratuita

Construtor de string de conexão PostgreSQL

Construa um URI de conexão PostgreSQL, uma string de palavra-chave/valor do libpq, uma string Npgsql (ADO.NET), uma URL JDBC e mais a partir de um único formulário, ou cole qualquer uma delas para ver o que cada parâmetro faz e se o sslmode realmente protege você. 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 PostgreSQL

A maioria dos drivers PostgreSQL usa a libpq ou copia suas regras, então a URI postgresql://user:password@host:5432/db?sslmode=verify-full e a forma de palavra-chave/valor host=... dbname=... funcionam quase em todos os lugares: psql, psycopg, pgx, lib/pq, node-postgres. Npgsql (.NET) e pgJDBC (Java) têm suas próprias grafias.

O parâmetro que mais importa é sslmode. O padrão dele, prefer, usa TLS quando o servidor o oferece, mas nunca verifica o certificado e cai silenciosamente para texto sem criptografia. Apenas verify-full verifica tanto a cadeia de certificados quanto o nome do host.

URI libpq, psql, psycopg, pgx, node-postgres, Prisma

postgresql://app_user:[email protected]/sales?sslmode=verify-full

Palavra-chave/valor libpq conninfo, psycopg, pgx, lib/pq

host=db.example.com dbname=sales user=app_user password=your_password sslmode=verify-full

ADO.NET (Npgsql) Npgsql, Entity Framework Core

Host=db.example.com;Database=sales;Username=app_user;Password=your_password;SSL Mode=VerifyFull

JDBC Driver JDBC do PostgreSQL (pgJDBC)

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

ODBC psqlODBC

Driver={PostgreSQL Unicode};Server=db.example.com;Database=sales;Uid=app_user;Pwd=your_password;SSLmode=verify-full;

URL do SQLAlchemy Python SQLAlchemy com psycopg 3

postgresql+psycopg://app_user:[email protected]/sales?sslmode=verify-full

Vários hosts (failover) libpq 10+, pgx, Npgsql, pgJDBC

postgresql://[email protected]:5432,db2.example.com:5432/sales?target_session_attrs=read-write

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

Parâmetros do libpq (URI e palavra-chave/valor)

Formato URI: postgresql://[user[:password]@][host][:port][,...][/dbname][?param=value&...] (postgres:// também funciona); codifique caracteres especiais em percentual, incluindo as barras de um caminho de socket Unix usado como host. Forma palavra-chave/valor: key=value pares separados por espaços; coloque entre aspas simples um valor que esteja vazio ou contenha espaços, e escreva \' e \\ para uma aspa ou barra invertida dentro dele.

Palavra-chaveSinônimosPadrãoO que faz
host - Socket Unix em /tmp (localhost no Windows) Nome do host, IP, ou um diretório para um socket Unix. Uma lista separada por vírgulas é tentada em ordem.
hostaddr - - IP numérico, ignorando DNS (o host ainda é usado para verificações TLS).
port - 5432 (o padrão de compilação) Uma porta, ou uma por host.
dbname - o nome do usuário Banco de dados para conectar.
user - o usuário do sistema operacional Função com a qual se conectar.
password - - Melhor manter em ~/.pgpass (ou PGPASSWORD) do que na string.
passfile - ~/.pgpass (%APPDATA%\postgresql\pgpass.conf no Windows) Arquivo de senha.
connect_timeout - 0 (esperar para sempre) Segundos por host. PostgreSQL 16 e versões anteriores tratam 1 como 2.
sslmode - preferir disable, allow, prefer, require, verify-ca, verify-full. require verifica a CA apenas se um arquivo de certificado raiz existir; apenas verify-full verifica o nome do host.
sslrootcert - ~/.postgresql/root.crt Arquivo CA. system (16+) usa as CAs confiáveis do sistema operacional e torna verify-full o padrão.
sslcert / sslkey - ~/.postgresql/postgresql.crt / .key Certificado e chave do cliente.
sslnegotiation - postgres 17+. direct inicia TLS imediatamente (necessita sslmode require ou mais forte).
application_name - - Exibido em pg_stat_activity e no log do servidor.
options - - Configurações do servidor na inicialização, por exemplo. -c statement_timeout=30000 -c search_path=app.
target_session_attrs - qualquer any, read-write, read-only, primary, standby, prefer-standby.
load_balance_hosts - desativar 16+. random embaralha a lista de hosts.
keepalives - 1 Keepalives TCP lig./desl.; ajuste com keepalives_idle, keepalives_interval, keepalives_count.
channel_binding - preferir require recusa-se a autenticar sem channel binding SCRAM.

Parâmetros Npgsql (ADO.NET)

Npgsql usa ADO.NET Key=Value; sintaxe com seus próprios nomes de palavra-chave. Coloque entre aspas valores contendo ; entre aspas duplas.

Palavra-chaveSinônimosPadrãoO que faz
Host Servidor - (obrigatório) Nome do host, IP, uma lista separada por vírgulas ou um diretório de socket que comece com /.
Port - 5432 Porta TCP.
Database DB o nome do usuário Nome do banco de dados.
Username Nome de usuário, Id do usuário, UID PGUSER, senão o usuário do SO Nome da função.
Password PSW, PWD PGPASSWORD Senha.
SSL Mode SslMode Preferir Disable, Allow, Prefer, Require, VerifyCA, VerifyFull. Desde o Npgsql 6, Require não valida o certificado.
Trust Server Certificate - falso Ignorar validação. Npgsql 6 e 7 exigiam isso com Require; Npgsql 8 não exige.
Root Certificate - PGSSLROOTCERT Arquivo CA para VerifyCA / VerifyFull.
Timeout - 15 Segundos para aguardar por uma conexão.
Command Timeout - 30 Tempo limite padrão de comando em segundos; 0 espera para sempre.
Application Name - PGAPPNAME application_name.
Search Path - - Caminho de pesquisa do esquema.
Target Session Attributes - qualquer any, primary, standby, prefer-primary, prefer-standby, read-write, read-only.
Pooling - true Pool de conexões.
Maximum Pool Size - 100 Maior pool.
Minimum Pool Size - 0 Menor pool.
Keepalive - 0 (desligado) Segundos entre consultas de keepalive.
Include Error Detail - falso Coloca detalhes do erro do servidor, que podem conter dados de linha, nas mensagens de exceção.

Propriedades pgJDBC

Formato da URL: jdbc:postgresql://host:port/database?property=value&.... pgJDBC não lê user:password@ na URL: passe user e password como parâmetros ou propriedades de conexão.

Palavra-chaveSinônimosPadrãoO que faz
user / password - - Credenciais.
sslmode - preferir Os mesmos valores do libpq. require, allow e prefer não valida o certificado.
ssl - falso true sem sslmode significa verify-full.
sslrootcert - ~/.postgresql/root.crt Arquivo CA.
connectTimeout - 10 Segundos para esperar pelo socket; 0 desativa o limite.
socketTimeout - 0 Segundos que uma leitura pode ficar bloqueada; 0 espera para sempre.
loginTimeout - 0 Segundos para esperar pelo login completo.
ApplicationName - Driver JDBC do PostgreSQL application_name.
currentSchema - - search_path, separado por vírgulas.
targetServerType - qualquer any, primary, secondary, preferPrimary, preferSecondary.
options - - Opções de inicialização, por exemplo. -c statement_timeout=30000 (com codificação percentual na URL).

Erros comuns de conexão do PostgreSQL

FATAL: no pg_hba.conf entry for host "10.0.0.7", user "app_user", database "sales", no encryption

Por que: O servidor foi alcançado, mas nenhuma linha em pg_hba.conf permite este cliente, usuário e banco de dados, ou a linha correspondente está hostssl e você se conectou sem TLS ("sem criptografia").

Correção: Conectar com sslmode=require ou mais forte se o servidor esperar TLS, ou peça ao administrador para adicionar uma host/hostssl linha para o seu endereço e recarregar o servidor.

connection to server at "db.example.com" (10.0.0.5), port 5432 failed: Connection refused

Por que: Nada está escutando nesse endereço e porta: o servidor está fora do ar, listen_addresses cobre apenas localhost, a porta é diferente ou um firewall rejeita a conexão.

Correção: Verificar listen_addresses e port em postgresql.conf, o firewall ou grupo de segurança da nuvem, e se você precisa de uma porta diferente (serviços gerenciados e poolers frequentemente usam 6432 ou uma porta personalizada).

FATAL: password authentication failed for user "app_user"

Por que: Senha incorreta, um papel sem senha, ou um caractere especial na senha que não foi codificado em porcentagem na URI, então o driver leu uma senha diferente.

Correção: Verifique a senha; em uma URI, codifique @ como %40, : como %3A, / como %2F e % como %25. Cole o URI no decodificador para ver exatamente qual senha o driver enviará.

server does not support SSL, but SSL was required

Por que: A string solicita sslmode=require (ou verify-ca / verify-full) e o servidor possui ssl = off.

Correção: Ative o TLS no servidor, ou conecte-se ao endpoint TLS documentado pelo seu provedor. Não desça para sslmode=disable em uma rede que você não controla.

root certificate file "/home/app/.postgresql/root.crt" does not exist

Por que: sslmode=verify-ca ou verify-full precisa de um certificado CA para validar, e o libpq não encontrou nenhum no caminho padrão.

Correção: Baixe o pacote de certificados CA do seu provedor e configure sslrootcert=/path/to/ca.pem, ou em clientes PostgreSQL 16+ use sslrootcert=system quando o certificado do servidor vier de uma CA pública.

FATAL: database "app_user" does not exist

Por que: Não dbname foi fornecido, então o libpq usou o nome de usuário como nome do banco de dados.

Correção: Adicione o banco de dados ao caminho URI (/sales) ou defina dbname=sales.

invalid connection option "sslmod"

Por que: libpq rejeita toda a string quando uma palavra-chave está escrita incorretamente ou pertence a outro driver (por exemplo ApplicationName do pgJDBC em vez de application_name).

Correção: Corrija a ortografia. O decodificador lista todos os parâmetros do libpq e marca os desconhecidos.

FAQ da string de conexão do PostgreSQL

Qual é o formato da string de conexão do PostgreSQL?

Duas formas funcionam com drivers baseados em libpq: o URI postgresql://user:password@host:5432/dbname?sslmode=verify-full e a string de palavra-chave/valor host=host port=5432 dbname=dbname user=user sslmode=verify-full. O Npgsql usa Host=...;Database=...;Username=... e Java usa jdbc:postgresql://host:5432/dbname.

Qual sslmode devo usar?

verify-full com sslrootcert apontando para seu CA (ou system no PostgreSQL 16+). require criptografa, mas não verifica quem respondeu, e prefer, o padrão, pode cair silenciosamente para texto sem criptografia. Use disable apenas para um socket ou localhost.

Como faço escape de caracteres especiais em um URI do PostgreSQL?

Codifique os caracteres com percent-encoding no nome do usuário, na senha e no banco de dados: @ é %40, : é %3A, / é %2F, # é %23, ? é %3F, % é %25 e um espaço é %20. A forma de palavra-chave/valor evita a maior parte disso: coloque o valor entre aspas simples e escape ' e \ com uma barra invertida.

Como definir um tempo limite de instrução na string de conexão?

Com drivers baseados em libpq, adicione options=-c statement_timeout=30000 (milissegundos; use codificação percentual em um URI como options=-c%20statement_timeout%3D30000). O Npgsql possui Command Timeout, um tempo limite do lado do cliente em segundos.

Posso listar vários hosts para failover?

Sim. Escreva postgresql://host1:5432,host2:5432/db ou host=host1,host2 port=5432,5432. O libpq tenta na ordem; adicione target_session_attrs=read-write para pular os standbys somente leitura, ou load_balance_hosts=random (PostgreSQL 16+) para distribuir conexões.

Por que o node-postgres verifica o certificado com sslmode=require?

o pg-connection-string atualmente trata sslmode=prefer, require e verify-ca como verify-full e imprime um aviso de que isso mudará para os significados do libpq em uma versão principal futura. Adicione uselibpqcompat=true para optar pelo comportamento do libpq agora, ou configure ssl e sim na configuração do cliente.

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