PostgreSQL命令行客户端,用于通过命令行与PostgreSQL数据库交互,执行SQL命令及管理数据库。
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命令映射到容器运行,简化后续使用:
bashalias psql="docker run -ti --rm alpine/psql"
--rm:容器退出后自动删除,避免残留容器。-ti:分配交互式终端,支持命令行输入。
2. 直接连接数据库
使用psql参数指定数据库信息连接:
bashpsql -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`等)
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull alpine/psql:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务