PostgreSQL Ping
Resumo
- Verifica disponibilidade de um servidor remoto PostgreSQL
Parâmetros
Parâmetro | Tipo | Escolhas | Valor padrão | Comentários |
|---|---|---|---|
db | string | | Nome de um banco de dados ao qual se conectar. aliases: login_db |
session_role | string | | Alterna para session_role após conectar. O session_role especificado deve ser uma função da qual o login_user atual é membro. A verificação de permissões para comandos SQL é realizada como se o session_role fosse aquele que havia se logado originalmente. |
trust_input | boolean | Escolhas:
| Caso use 'no', verifica se um valor de session_role é potencialmente perigoso. Faz sentido usar no apenas quando as injeções de SQL via session_role são possíveis. |
Extende fragmentos da documentação do módulo PostgreSQL Base
Notas
- A autenticação padrão assume que você está fazendo login ou sudo na conta do postgres no host.
- Para evitar o erro “Peer authentication failed for user postgres”, use o usuário postgres como um become_user.
- Se o host remoto for o servidor PostgreSQL (que é o caso padrão), o PostgreSQL também deve ser instalado no host remoto.
- O parâmetro ca_cert requer pelo menos Postgres versão 8.4.
Exemplos
# No exemplo abaixo, você precisa gerar certificados anteriormente.
# Consulte https://www.postgresql.org/docs/current/libpq-ssl.html para obter mais informações.
- name: Ping no servidor dbsrv PostgreSQL usando credenciais e SSL não padrão
postgresql_ping:
db: protected_db
login_host: dbsrv
login_user: secret
login_password: secret_pass
ca_cert: /root/root.crt
ssl_mode: verify-full
Valores retornados
Chave | Tipo | Retornado quando | Description |
|---|---|---|---|
is_available | boolean | sempre | Disponibilidade do servidor PostgreSQL. Exemplo: True |
server_version | dictionary | sempre | Versão do servidor PostgreSQL. Exemplo: {'full': '13.2', 'major': 13, 'minor': 2, 'raw': 'PostgreSQL 13.2 on x86_64-pc-linux-gnu'} |