exec 和 psql

pg exec 和 psql 指南

两种对实例运行 SQL 的方式：pg exec 用于一次性 SQL 或容器命令，pg psql 用于交互式会话。

pg exec

SQL 模式（默认）

没有 -- 的参数作为 SQL 通过 psql 执行，使用实例配置的用户和数据库。

pg exec "SELECT version()"
pg exec -i proj01 "SELECT count(*) FROM users"
pg exec "CREATE TABLE test (id serial PRIMARY KEY, msg text)"

容器命令模式（– 之后）

-- 之后的参数直接在容器内运行（以 root 身份）。

pg exec -- pg_isready
pg exec -- ls -la /var/lib/postgresql/data
pg exec -- bash -c "cat /var/lib/postgresql/data/postgresql.conf"
pg exec -- tail -f /var/log/postgresql/postgresql-*.log

远程数据库（–dsn）

通过连接字符串对任何可达数据库执行 SQL，使用临时容器。--dsn 仅支持 SQL 模式；容器命令需要本地实例。

pg exec --dsn postgres://user:pass@host:5432/db "SELECT count(*) FROM users"

pg psql

交互式会话

pg psql                          # 默认实例
pg psql -i proj01                # 特定实例

在 shell 内你获得完整的 psql 功能：带历史记录和 tab 补全的 SQL、元命令（\dt、\du、\l），以及 \q 退出。

非交互式（脚本）

echo "SELECT version();" | pg psql        # 来自 stdin 的 SQL
pg psql -- -c "SHOW work_mem"             # 单条命令
pg psql -- -d other_db                    # 连接到不同数据库
pg psql -- -U other_user                  # 以不同用户连接

切换到 postgres 超级用户

某些管理任务（例如创建某些扩展、修改系统级设置）需要 postgres 超级用户权限。使用 -- 传递 psql 参数并切换用户：

pg psql -i pg01 -- -U postgres -d postgres

推荐方法：日常操作使用实例默认用户（admin），仅在需要超级用户权限时切换到 postgres。这比修改配置文件或重启容器更安全更方便。

示例场景：

# 创建需要超级用户权限的扩展
pg psql -i pg01 -- -U postgres -d postgres -c "CREATE EXTENSION pg_cron"

# 配置 cron.database_name（pg_cron 特定参数）
pg psql -i pg01 -- -U postgres -d postgres -c "ALTER SYSTEM SET cron.database_name = 'pg01_db'"

# 查看系统级配置
pg psql -i pg01 -- -U postgres -d postgres -c "SHOW shared_preload_libraries"

远程数据库（–dsn）

pg psql --dsn postgres://user:pass@host:5432/db

规则

--dsn 和 --instance 互斥：连接字符串确定主机、端口和数据库，因此 -i 被拒绝以避免静默误用。
使用 --dsn 时，数据库是 URL 的路径部分：postgres://user:pass@host:5432/mydb 连接到 mydb。要使用另一个数据库，更改路径。
使用本地实例时，-- 传递原始 psql 参数（包括 -d/-U），覆盖实例默认值。