Integrações — PostgreSQL
Visão geral
O chart tdp-postgresql disponibiliza um servidor PostgreSQL interno ao cluster. Charts como OpenMetadata, Airflow, Ranger, Superset, Hive Metastore e JupyterHub podem usá-lo como banco de metadados externo via TDP-Settings.externalDatabase. O CloudBeaver usa PostgreSQL como banco de metadados externo (via tdp-cloudbeaver.database.*). O Trino pode consultá-lo como fonte de dados via conector JDBC.
A integração com cada componente é descrita na página de integrações do respectivo chart:
- OpenMetadata: consulte Configuração do OpenMetadata — seção Banco de dados (PostgreSQL).
- Airflow: consulte Configuração do Airflow — seção Configuração do banco de dados.
- Ranger: consulte Configuração do Ranger — seção Banco de dados e auditoria.
- Superset: consulte Configuração do Superset — seção PostgreSQL de metadados.
- Hive Metastore: consulte Configuração do Hive Metastore — seção Banco de dados.
- JupyterHub: consulte Configuração do Jupyter — seção Banco de dados.
- CloudBeaver: consulte Configuração do CloudBeaver — seção Banco de dados.
- Trino: consulte Integrações — Trino — seção PostgreSQL.
Endereço do serviço interno
Depois de instalado, o PostgreSQL fica acessível dentro do cluster pelo nome DNS:
<RELEASE_NAME>.<NAMESPACE>.svc.cluster.local:5432
Substitua <RELEASE_NAME> pelo nome do release Helm e <NAMESPACE> pelo namespace onde o chart foi instalado.
Obter a senha do admin
A senha do usuário postgres é gerada automaticamente pelo chart e armazenada em um Kubernetes Secret:
export POSTGRES_PASSWORD=$(kubectl get secret --namespace <NAMESPACE> <RELEASE_NAME> \
-o jsonpath="{.data['postgres-password']}" | base64 -d)
O nome do Secret corresponde ao nome do release (ex.: tdp-postgresql), com a chave postgres-password.
Conectar a partir de dentro do cluster
Para testes ou diagnósticos a partir de um pod temporário no mesmo namespace:
kubectl run <RELEASE_NAME>-client --rm --tty -i --restart='Never' \
--namespace <NAMESPACE> \
--image docker.io/bitnamilegacy/postgresql:17.5.0-debian-12-r20 \
--env="PGPASSWORD=$POSTGRES_PASSWORD" \
--command -- psql -h <RELEASE_NAME> -p 5432 -U postgres -d postgres
Conectar a partir de fora do cluster (port-forward)
Para acesso temporário de fora do cluster — por exemplo, de uma estação de trabalho com o cliente psql:
kubectl port-forward --namespace <NAMESPACE> svc/<RELEASE_NAME> 5432:5432
psql -h 127.0.0.1 -p 5432 -U postgres -d postgres
O port-forward é adequado para testes e diagnóstico. Não é um método de acesso permanente.
Validação
kubectl -n <NAMESPACE> get pods
kubectl -n <NAMESPACE> get svc
kubectl -n <NAMESPACE> get pvc
kubectl -n <NAMESPACE> get events --sort-by=.lastTimestamp