PostgreSQL命令行客户端,用于通过命令行与PostgreSQL数据库交互,执行SQL命令及管理数据库。

5 次收藏下载次数: 0状态:社区镜像维护者:Alpine 工具与轻量镜像仓库类型:镜像最近更新:
下载命令
点击查看

psql — PostgreSQL命令行客户端

镜像概述与主要用途

alpine/psql 是一个基于Alpine Linux的轻量级Docker镜像,包含PostgreSQL官方命令行客户端psql。该镜像旨在提供便捷的PostgreSQL数据库连接与管理工具,无需在主机系统直接安装psql客户端,即可通过容器化方式快速与PostgreSQL数据库交互。

核心功能与特性

  • 官方兼容性:集成PostgreSQL官方psql客户端,支持与各版本PostgreSQL数据库的标准交互。
  • 轻量级设计:基于Alpine Linux构建,镜像体积小,资源占用低。
  • 完整交互能力:支持执行SQL命令、查询数据、管理数据库对象(如表、视图、索引等)。
  • 脚本执行支持:可直接运行外部SQL脚本文件,适用于批量操作或自动化任务。

使用场景与适用范围

  • 开发环境快速连接:开发人员无需在本地安装psql,通过容器快速连接远程或本地PostgreSQL数据库。
  • 自动化脚本与CI/CD流程:在自动化部署、数据库迁移或数据验证流程中,执行SQL命令或脚本。
  • 临时数据库管理:临时需要查询或修改数据库内容,避免主机环境依赖。
  • 多环境隔离:通过容器化方式,在不同项目或环境中使用特定版本的psql客户端,避免版本冲突。

镜像信息

Dockerfile源码

https://github.com/alpine-docker/multi-arch-libs/blob/master/psql/Dockerfile

镜像标签

https://hub.docker.com/repository/docker/alpine/psql/tags(可通过标签选择特定版本)

每日CI构建日志

暂无(N/A)

使用方法

快速开始

1. 设置命令别名(推荐)

通过alias将psql命令映射到容器运行,简化后续使用:

bash
alias psql="docker run -ti --rm alpine/psql"
  • --rm:容器退出后自动删除,避免残留容器。
  • -ti:分配交互式终端,支持命令行输入。

2. 直接连接数据库

使用psql参数指定数据库信息连接:

bash
psql -d <数据库名> -U <用户名> -W
  • -d:指定目标数据库名称。
  • -U:指定连接用户名。
  • -W:强制提示输入密码(避免明文密码暴露)。

3. 使用连接字符串连接

通过完整连接字符串连接(推荐用于复杂配置,如SSL、端口自定义等):

bash
# 示例连接字符串格式:postgres://用户名:密码@主机:端口/数据库名?参数
export PSQL_CONNECTION_STRING="postgres://psqladmin:Eha72NtzKe01@postgresql.example:5432/psql?sslmode=require"
psql $PSQL_CONNECTION_STRING
  • 连接字符串参数说明:
    • sslmode=require:强制使用SSL加密连接(根据数据库配置调整,可选值:disable、allow、prefer、require等)。

4. 运行SQL脚本文件

执行本地SQL脚本文件(需将脚本挂载到容器内,或通过标准输入传递):

bash
# 方法1:通过`-v`挂载本地脚本文件到容器/tmp目录
docker run -ti --rm -v $(pwd)/policy.sql:/tmp/policy.sql docker.xuanyuan.run/alpine/psql $PSQL_CONNECTION_STRING -f /tmp/policy.sql

# 方法2:使用管道传递脚本内容(适用于无需持久化的临时脚本)
cat policy.sql | psql $PSQL_CONNECTION_STRING
  • -f:指定要执行的SQL脚本文件路径(容器内路径)。

配置参数说明

psql客户端常用参数如下:

参数说明
-d, --dbname=DBNAME指定连接的数据库名称
-U, --username=USERNAME指定连接用户名
-h, --host=HOSTNAME指定数据库主机地址(默认:localhost)
-p, --port=PORT指定数据库端口(默认:5432)
-W, --password强制提示输入密码(即使未指定,若数据库要求密码也会提示)
-f, --file=FILENAME执行指定文件中的SQL命令
-c, --command=COMMAND执行单行SQL命令(如:psql -c "SELECT version();")
-t, --tuples-only仅输出查询结果数据,不包含表头和额外格式
-v, --set=VAR=VALUE设置psql变量(如:-v ON_ERROR_STOP=1 遇到错误时停止执行)

环境变量

变量名说明示例
PSQL_CONNECTION_STRING存储完整的PostgreSQL连接字符串,用于简化命令行输入postgres://user:pass@host:5432/db?sslmode=require

参考链接

  • Dockerfile源码:https://github.com/alpine-docker/multi-arch-libs/blob/master/psql/Dockerfile
  • 镜像标签列表:https://hub.docker.com/repository/docker/alpine/psql/tags(可选择特定版本,如`latest`、`14`等)

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 psql 镜像标签

docker pull docker.xuanyuan.run/alpine/psql:<标签>

DockerHub 原生拉取命令

docker pull alpine/psql:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告