Como o cliente encontra o banco
Uma connection string, ou string de conexão, é um texto que reúne os parâmetros usados por um cliente para abrir uma conexão. No acesso a um banco, ela pode indicar o servidor de destino e o nome da base. A biblioteca interpreta esse texto para iniciar a tentativa de conexão.
A libpq do PostgreSQL aceita parâmetros na forma chave=valor, separados por espaços, ou no formato de endereço. Este exemplo didático usa a primeira opção para acessar uma base local:
host=localhost port=5432 dbname=atendimento user=appO cliente procura o servidor na máquina onde ele é executado pela porta 5432 e tenta acessar a base atendimento como o usuário app. O texto não informa senha, então a autenticação depende dos demais mecanismos configurados. A presença dos parâmetros não confirma que o servidor aceitou a conexão.
Destino correto e credenciais preservadas
Uma conexão bem-sucedida ainda pode apontar para a base errada. Ao revisar a configuração, compare o servidor e o nome do banco com o ambiente pretendido. O acesso a uma base de testes, por exemplo, não confirma o acesso à base usada pela aplicação em produção.
O formato também pode conter uma senha. Ao registrar um erro de conexão, você precisa ocultar esse trecho para não expor a credencial no log. Confira a sintaxe na documentação do cliente utilizado, porque uma string aceita pela libpq pode exigir adaptações em outra biblioteca.
Dúvidas frequentes
Perguntas frequentes sobre Connection String
- Toda connection string tem o mesmo formato?
- Cada biblioteca define os formatos e parâmetros aceitos. A libpq do PostgreSQL aceita pares de chave e valor ou um endereço iniciado por postgresql:// ou postgres://.
- Uma string válida confirma o acesso ao banco?
- A sintaxe pode estar correta e a tentativa falhar por autenticação ou indisponibilidade do servidor. Você precisa conferir o resultado da conexão no cliente.
- A string de conexão precisa conter uma senha?
- A libpq permite informar a senha na string, mas também admite outras fontes de autenticação. Uma string com senha deve ter esse trecho ocultado em logs e relatórios.
Para continuar
Recursos relacionados
Documentação
PostgreSQL: formatos e parâmetros da conexão
Referência das sintaxes de conexão da libpq e do significado dos parâmetros de acesso ao PostgreSQL.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Orientação técnica ao vivo para investigar erros de conexão e revisar a configuração do acesso ao banco da aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A configuração do acesso ao banco exige conferir o destino da conexão e preservar as credenciais usadas pela aplicação.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.