PostgreSQL 文档检索
PG 18 · 按类别浏览,或输入名称与关键词
分类索引819
pg_rewind --restore-target-wal-c--restore-target-wal
如果这些文件在 pg_wal 目录中已不可用,则使用目标集簇配置中定义的 restore_command 从 WAL 归档中取回 WAL 文件。pg_rewind › 选项
pg_rewind --source-pgdata=directory--source-pgdata=directory
指定源服务器数据目录的文件系统路径,以便将目标与之同步。此选项要求源服务器已正常关闭。pg_rewind › 选项
pg_rewind --source-server=connstr--source-server=connstr
指定一个 libpq 连接字符串,用于连接源 PostgreSQL 服务器,以便将目标与之同步。该连接必须是普通连接(非复制连接),所用角色要么拥有足够的权限以执行 pg_rewind 在源服务器上使用的函数(详见注解部分),要么是超级用户角色。此选项要求源服务器正在运行并接受连接。pg_rewind › 选项
pg_rewind --sync-method=method--sync-method=method
设为 fsync(默认值)时,pg_rewind 会递归打开并同步数据目录中的所有文件。搜索文件时会跟随 WAL 目录及每个已配置表空间的符号链接。 在 Linux 上,也可以改用 syncfs,请求操作系统同步包含数据目录、WAL 文件以及各个表空间的整个文件系统。关于使用 syncfs 时需要注意的限制,请参见 recovery_i…pg_rewind › 选项
pg_rewind --target-pgdata=directory-D directory--target-pgdata=directory
此选项指定要与源同步的目标数据目录。在运行 pg_rewind 之前,目标服务器必须已正常关闭。pg_rewind › 选项
pg_rewind --version-V--version
显示版本信息,然后退出。pg_rewind › 选项
pg_rewind --write-recovery-conf-R--write-recovery-conf
在输出目录中创建 standby.signal,并把连接设置追加到 postgresql.auto.conf 中。只有当连接字符串或环境变量中显式指定了 dbname 时,才会记录 dbname。使用此选项时,必须指定 --source-server。pg_rewind › 选项
pg_test_fsync描述 pg_test_fsync 旨在让你较为合理地了解,在你的具体系统上哪一种 wal_sync_method 最快,并且在识别出 I/O 问题时提供诊断信息。不过, pg_test_fsync 显示出的差异未必会对实际数据库吞吐量产生显著影响,特别是因为许多数据库服务器的速度瓶颈并不在其预写式日志上。 pg_test_fsync 会为每种 wal_sync_method 报…命令行工具 · 服务端程序
pg_test_timing描述 pg_test_timing 是一个用于测量系统上的计时开销并确认系统时间不会倒退的工具。它会在指定时长内以尽可能快的速度反复读取受支持的时钟源,然后打印相邻时钟读数之间观测到的差异统计,以及将使用哪个时钟源。 更小(但不为零)的差异更好,因为这意味着时钟硬件更精确,收集一次时钟读数的开销也更小。收集计时数据较慢的系统,可能会给出不够精确的 EXPLAIN ANALYZE…命令行工具 · 服务端程序
pg_upgrade描述 pg_upgrade (以前称为 pg_migrator )允许将存储在 PostgreSQL 数据文件中的数据升级到更新的 PostgreSQL 主版本,而无需执行主版本升级通常所需的数据转储/恢复,例如从 12.14 升级到 13.10,或从 14.9 升级到 15.5。次版本升级不需要使用它,例如从 12.7 升级到 12.8 或从 14.1 升级到 14.5。 P…命令行工具 · 服务端程序
pg_verify_checksums描述 pg_verify_checksums 验证 PostgreSQL 集簇中的数据校验和。在运行 pg_verify_checksums 之前,必须干净地关闭服务器。如果没有校验和错误,退出状态为零,否则为非零。 选项 可以使用以下命令行选项: -D directory --pgdata= directory 指定存储数据库集簇的目录。 -v --verbose 启用详细输…命令行工具 · 服务端程序
pg_verifybackup描述 pg_verifybackup 用于依据服务器在备份时生成的 backup_manifest ,检查使用 pg_basebackup 获取的数据库集簇备份的完整性。备份既可以采用“普通文件”格式,也可以采用“tar”格式;其中也包括使用 pg_basebackup 支持的任意算法压缩的 tar 格式备份。 需要注意, pg_verifybackup 执行的验证并未、也不可…命令行工具 · 客户端程序
pg_verifybackup --exit-on-error-e--exit-on-error
一旦检测到备份存在问题就立即退出。如果未指定此选项,pg_verifybackup 即使在发现问题之后也会继续检查备份,并将检测到的所有问题报告为错误。pg_verifybackup › 选项
pg_verifybackup --format=format-F format--format=format
指定备份格式。format 可以是下列值之一: pplain # 备份由普通文件组成,其布局与源服务器的数据目录和表空间相同。 ttar # 备份由 tar 文件组成,这些文件可以经过压缩。有效的备份包括存放在 base.tar 文件中的主数据目录、存放在 pg_wal.tar 中的 WAL 文件,以及每个表空间对应的单独 ta…pg_verifybackup › 选项
pg_verifybackup --help-?--help
显示有关 pg_verifybackup 命令行参数的帮助并退出。pg_verifybackup › 选项
pg_verifybackup --ignore=path-i path--ignore=path
在将备份中实际存在的数据文件列表与 backup_manifest 文件中列出的数据文件列表进行比较时,忽略指定的文件或目录;它们应以相对路径名表示。如果指定的是目录,则此选项会影响以该位置为根的整个子树。如果相对路径名与指定的路径名匹配,则关于额外文件、缺失文件、文件大小差异或校验和不匹配的报错将被抑制。此选项可指定多次。pg_verifybackup › 选项
pg_verifybackup --manifest-path=path-m path--manifest-path=path
使用指定路径上的备份清单文件,而不是位于备份目录根部的那份文件。pg_verifybackup › 选项
pg_verifybackup --no-parse-wal-n--no-parse-wal
不要尝试解析从此备份执行恢复所需的预写式日志数据。pg_verifybackup › 选项
pg_verifybackup --progress-P--progress
启用进度报告。启用此选项后,在验证校验和时会输出进度报告。 此选项不能与 --quiet 一起使用。pg_verifybackup › 选项
pg_verifybackup --quiet-q--quiet
当备份成功通过验证时不输出任何内容。pg_verifybackup › 选项
pg_verifybackup --skip-checksums-s--skip-checksums
不验证数据文件的校验和。仍会检查文件是否存在以及这些文件的大小。这样会快得多,因为不需要读取文件本身。pg_verifybackup › 选项
pg_verifybackup --version-V--version
打印 pg_verifybackup 版本并退出。pg_verifybackup › 选项
pg_verifybackup --wal-directory=path-w path--wal-directory=path
尝试解析存储在指定目录中的 WAL 文件,而不是 pg_wal 中的 WAL 文件。如果备份与 WAL 归档分开存放,这会很有用。pg_verifybackup › 选项
pg_waldump描述 pg_waldump 显示预写式日志(WAL),主要用于调试或教学。 该工具只能由安装服务器的用户运行,因为它要求对数据目录具有只读访问权限。 选项 以下命令行选项控制输出的位置和格式: startseg 从指定的 WAL 段文件开始读取。这会隐式决定搜索文件时所使用的路径以及要使用的时间线。 endseg 读取完指定的 WAL 段文件后停止。 -b --bkp-deta…命令行工具 · 服务端程序
pg_walsummary描述 pg_walsummary 用于打印 WAL 汇总文件的内容。这些二进制文件位于数据目录下的 pg_wal/summaries 子目录中,可使用本工具将其转换为文本。通常并无此必要,因为 WAL 汇总文件主要是为了支持 增量备份 而存在的,但在调试时可能会很有用。 WAL 汇总文件按表空间 OID、关系 OID 以及关系分支(fork)建立索引。对于每个关系分支,它都存储…命令行工具 · 服务端程序
pg_walsummary --help-?--help
显示 pg_walsummary 命令行参数的帮助并退出。pg_walsummary › 选项
pg_walsummary --individual-i--individual
默认情况下,pg_walsummary 会为每个由一个或多个连续已修改块构成的范围输出一行。这样可以使输出简洁得多,因为如果某个关系中从 0 到 999 的所有块都被修改了,则只会输出一行,而不是 1000 行单独的输出。该选项要求为每个已修改块分别输出一行。pg_walsummary › 选项
pg_walsummary --quiet-q--quiet
除错误之外不打印任何输出。当只想知道某个 WAL 汇总文件能否被成功解析,而并不关心其内容时,这会很有用。pg_walsummary › 选项
pg_walsummary --version-V--version
显示版本信息,然后退出。pg_walsummary › 选项
PGAPPNAMEPGAPPNAME 的行为与 application_name 连接参数相同。环境变量
pgbench描述 pgbench 是一个用于对 PostgreSQL 执行基准测试的简单程序。它会反复执行同一组 SQL 命令,也可在多个并发数据库会话中运行,然后计算平均事务速率(每秒事务数)。默认情况下, pgbench 测试的是一个大体上基于 TPC-B 的场景,每个事务包含五条 SELECT 、 UPDATE 和 INSERT 命令。不过,通过编写自己的事务脚本文件,也很容易测试其…命令行工具 · 客户端程序
PGCHANNELBINDINGPGCHANNELBINDING 的行为与 channel_binding 连接参数相同。环境变量
PGCLIENTENCODINGPGCLIENTENCODING 的行为与 client_encoding 连接参数相同。环境变量
PGCONNECT_TIMEOUTPGCONNECT_TIMEOUT 的行为与 connect_timeout 连接参数相同。环境变量
PGDATABASEPGDATABASE 的行为与 dbname 连接参数相同。环境变量
PGDATESTYLEPGDATESTYLE 设置日期/时间表示的默认风格(等同于 SET datestyle TO ...)。环境变量
PGGEQOPGGEQO 为遗传查询优化器设置默认模式(等同于 SET geqo TO ...)。环境变量
PGGSSDELEGATIONPGGSSDELEGATION 的行为与 gssdelegation 连接参数相同。环境变量
PGGSSENCMODEPGGSSENCMODE 的行为与 gssencmode 连接参数相同。环境变量
PGGSSLIBPGGSSLIB 的行为与 gsslib 连接参数相同。环境变量
更多结果
输入名称或关键词,从 PostgreSQL 手册与扩展目录中直接找到定义。
pg17: 限定版本 ex: 只搜扩展 ↑↓ 选择 ↵ 打开