citizensadvice/postgres-client

citizensadvice/postgres-client 镜像说明

镜像概述

本镜像包含PostgreSQL数据库的核心客户端工具，可在无需安装完整PostgreSQL服务的环境中，便捷地完成数据库交互、备份及恢复操作。

核心功能

• psql：交互式SQL命令行工具，支持执行查询、管理数据库对象；
• pg_dump：数据库备份工具，可导出整个数据库或指定对象的结构与数据；
• pg_restore：备份恢复工具，用于将pg_dump生成的备份文件还原到数据库中。

使用场景

1. 临时连接远程PostgreSQL数据库执行SQL查询；
2. 批量备份生产环境数据库到本地或存储系统；
3. 将备份数据恢复到测试/开发环境；
4. 容器化环境中快速调用PostgreSQL客户端工具完成数据库操作。

配置说明

使用时需通过命令行参数传递数据库连接信息，关键参数包括：

• -h：数据库主机地址；
• -U：数据库用户名；
• -d：目标数据库名称；
• -p：数据库端口（默认5432）；
• -W：提示输入密码（或通过环境变量PGPASSWORD传递）。

部署示例

1. 执行SQL查询

bash
docker run --rm citizensadvice/postgres-client psql -h your-db-host -U your-username -d your-db-name -c "SELECT version();"

2. 备份数据库

bash
docker run --rm citizensadvice/postgres-client pg_dump -h your-db-host -U your-username -d your-db-name > backup.sql

3. 恢复数据库

bash
cat backup.sql | docker run --rm -i citizensadvice/postgres-client pg_restore -h your-db-host -U your-username -d your-db-name -