PostgreSQL 文档检索

pg_basebackup --target=target命令行工具PG18-t target--target=target 指示服务器将基础备份放到哪里。默认目标是client，表示备份应发送到运行pg_basebackup的那台机器。如果目标改为server:/some/path，则备份会存储在服务器运行所在机器的/some/path目录中。将备份存储在服务器上需要超级用户权限，或拥有pg_write_server_files角色的权限。如果目标设…pg_basebackup › 选项 pg_basebackup --username=username命令行工具PG18-U username--username=username 指定连接时使用的用户名。pg_basebackup › 选项 pg_basebackup --verbose命令行工具PG18-v--verbose 启用详细模式。它会在启动和关闭过程中输出一些额外步骤；如果同时启用了进度报告，还会显示当前正在处理的确切文件名。pg_basebackup › 选项 pg_basebackup --version命令行工具PG18-V--version 输出pg_basebackup的版本并退出。pg_basebackup › 选项 pg_basebackup --wal-method=method命令行工具PG18-X method--wal-method=method 在备份中包含所需的 WAL（预写式日志）文件。这将包括备份期间生成的所有预写式日志。除非指定方法none，否则就可以在目标目录中启动 postmaster，而无需查阅 WAL 归档，从而使输出成为一个完全独立的备份。 支持以下用于收集预写式日志的method值： nnone # 不在备份中包含预写式日志。 ffetch …pg_basebackup › 选项 pg_basebackup --waldir=waldir命令行工具PG18--waldir=waldir 设置写入 WAL（预写式日志）文件的目录。默认情况下，WAL 文件会放在目标目录的pg_wal子目录中，但此选项可用于将其放在其他位置。waldir必须是绝对路径。与主目标目录一样，waldir不必事先存在，但如果存在则必须为空。只有当备份采用普通文件格式时，才能指定此选项。pg_basebackup › 选项 pg_basebackup --write-recovery-conf命令行工具PG18-R--write-recovery-conf 创建standby.signal 文件，并将连接设置追加到目标目录中的postgresql.auto.conf文件中（如果使用 tar 格式，则追加到基础归档文件内）。这样可以更方便地利用备份结果搭建备库。 postgresql.auto.conf文件将记录连接设置，以及（如果指定）pg_basebackup正在使用的复制槽，以便…pg_basebackup › 选项 pg_checksums命令行工具本站词条pg_checksums — 在 PostgreSQL 数据库集簇中启用、禁用或检查数据校验和 服务端程序 pg_checksums [ option ...] [[ -D | --pgdata ] datadir ] 手册中的可执行程序 pg_checksums 程序版本 12.22 参考清单 服务端程序 选项定义组 10 手册中的选项 指定存储数据库集簇的目录。 -D d…命令行工具 · 服务端程序 pg_checksums --check命令行工具PG18-c--check 检查校验和。如果没有指定其他模式，这是默认模式。pg_checksums › 选项 pg_checksums --disable命令行工具PG18-d--disable 禁用校验和。pg_checksums › 选项 pg_checksums --enable命令行工具PG18-e--enable 启用校验和。pg_checksums › 选项 pg_checksums --filenode=filenode命令行工具PG18-f filenode--filenode=filenode 仅验证文件节点为filenode的关系中的校验和。pg_checksums › 选项 pg_checksums --help命令行工具PG18-?--help 显示关于pg_checksums命令行参数的帮助并退出。pg_checksums › 选项 pg_checksums --no-sync命令行工具PG18-N--no-sync 默认情况下，pg_checksums会等待所有文件被安全写入磁盘。该选项会使pg_checksums直接返回而不等待，这样速度更快，但也意味着如果随后操作系统崩溃，更新后的数据目录可能会损坏。通常，此选项适合测试，但不应在生产环境中使用。使用--check时，此选项不起作用。pg_checksums › 选项 pg_checksums --pgdata=directory命令行工具PG18-D directory--pgdata=directory 指定存储数据库集簇的目录。pg_checksums › 选项 pg_checksums --progress命令行工具PG18-P--progress 启用进度报告。启用此选项后，在检查或启用校验和时会输出进度报告。pg_checksums › 选项 pg_checksums --sync-method=method命令行工具PG18--sync-method=method 设为fsync（默认值）时，pg_checksums会递归打开并同步数据目录中的所有文件。查找文件时会跟随 WAL 目录和每个已配置表空间的符号链接。 在 Linux 上，也可以改用syncfs，请求操作系统同步包含数据目录、WAL 文件以及每个表空间的整个文件系统。使用syncfs时需注意的事项见recovery_init_sync_…pg_checksums › 选项 pg_checksums --verbose命令行工具PG18-v--verbose 启用详细输出，列出所有被检查的文件。pg_checksums › 选项 pg_checksums --version命令行工具PG18-V--version 打印pg_checksums版本并退出。pg_checksums › 选项 pg_combinebackup命令行工具本站词条pg_combinebackup — 从增量备份及其所依赖的备份重建完整备份 客户端程序 pg_combinebackup [ option ...] [ backup_directory ...] 手册中的可执行程序 pg_combinebackup 程序版本 17.11 参考清单 客户端程序 选项定义组 13 手册中的选项 在 stderr 上输出大量调试日志。 -d -…命令行工具 · 客户端程序 pg_combinebackup --clone命令行工具PG18--clone 使用高效的文件克隆（某些系统将其称为“reflink”），代替向新数据目录复制文件，这样可能实现几乎瞬时的数据文件复制。 如果备份清单不可用，或者其中不包含正确类型的校验和，仍会使用文件克隆来复制文件，但也会按块读取该文件以计算校验和。 文件克隆仅在某些操作系统和文件系统上受支持。如果选择了该选项，但系统并不支持，pg_combinebackup运行时将报错。目…pg_combinebackup › 选项 pg_combinebackup --copy命令行工具PG18--copy 执行常规文件复制。这是默认行为。（另见--copy-file-range、--clone 和-k/--link。）pg_combinebackup › 选项 pg_combinebackup --copy-file-range命令行工具PG18--copy-file-range 使用copy_file_range系统调用进行高效复制。在某些文件系统上，这会得到与--clone类似的结果，即共享物理磁盘块；而在其他文件系统上，它仍可能复制数据块，但会通过优化后的路径进行。目前支持 Linux 和 FreeBSD。 如果备份清单不可用，或者其中不包含正确类型的校验和，仍会使用copy_file_range复制文件，但也会…pg_combinebackup › 选项 pg_combinebackup --debug命令行工具PG18-d--debug 在stderr上输出大量调试日志。pg_combinebackup › 选项 pg_combinebackup --dry-run命令行工具PG18-n--dry-run -n/--dry-run会让 pg_combinebackup确定将要执行哪些操作，而不实际创建目标目录或任何输出文件。该选项与--debug组合时尤其有用。pg_combinebackup › 选项 pg_combinebackup --help命令行工具PG18-?--help 显示pg_combinebackup命令行参数帮助并退出。pg_combinebackup › 选项 pg_combinebackup --link命令行工具PG18-k--link 在合成备份中使用硬链接，而不是复制文件。这样重建合成备份可能更快（因为无需复制文件），并且占用更少磁盘空间；但在使用输出目录时必须格外小心，因为对该目录的任何修改（例如启动服务器）也可能影响输入目录。同样，对输入目录的更改（例如在完整备份上启动服务器）也可能影响输出目录。因此，此选项最适合输入目录只是副本、并且会在 pg_combinebackup完成后被删除…pg_combinebackup › 选项 pg_combinebackup --manifest-checksums=algorithm命令行工具PG18--manifest-checksums=algorithm 与pg_basebackup一样，pg_combinebackup会在输出目录中写入备份清单。此选项指定对清单中每个文件使用的校验和算法。当前可用算法为NONE、CRC32C、SHA224、SHA256、SHA384和SHA512。默认值为CRC32C。pg_combinebackup › 选项 pg_combinebackup --no-manifest命令行工具PG18--no-manifest 禁用备份清单的生成。若未指定该选项，则会将重建备份的清单写入输出目录。pg_combinebackup › 选项 pg_combinebackup --no-sync命令行工具PG18-N--no-sync 默认情况下，pg_combinebackup会等待所有文件都被安全写入磁盘。此选项会使pg_combinebackup不经等待就直接返回，因此速度更快，但这意味着如果随后操作系统崩溃，输出备份可能会损坏。通常，此选项适合测试，但不应用于创建生产环境安装。pg_combinebackup › 选项 pg_combinebackup --output=outputdir命令行工具PG18-o outputdir--output=outputdir 指定合成完整备份写入的输出目录。当前该参数是必需的。pg_combinebackup › 选项 pg_combinebackup --sync-method=method命令行工具PG18--sync-method=method 当设置为fsync（这是默认值）时，pg_combinebackup会递归打开并同步备份目录中的所有文件。使用普通文件格式时，搜索文件时会跟随 WAL 目录和每个已配置表空间的符号链接。 在 Linux 上，也可以改用syncfs，让操作系统同步包含备份目录的整个文件系统。使用普通文件格式时，pg_combinebackup 还会同步包…pg_combinebackup › 选项 pg_combinebackup --tablespace-mapping=olddir=newdir命令行工具PG18-T olddir=newdir--tablespace-mapping=olddir=newdir 在重建备份期间，将目录olddir中的表空间重定位到 newdir。olddir是命令行指定的最终备份中该表空间的绝对路径，newdir是重建备份中要使用的绝对路径。若路径中需要包含等号（=），请在其前加反斜杠。可多次指定此选项以映射多个表空间。pg_combinebackup › 选项 pg_combinebackup --version命令行工具PG18-V--version 打印pg_combinebackup版本并退出。pg_combinebackup › 选项 pg_config命令行工具本站词条pg_config — 获取已安装的 PostgreSQL 版本的信息 客户端程序 pg_config [ option ...] 手册中的可执行程序 pg_config 程序版本 10.23 参考清单 客户端程序 选项定义组 24 手册中的选项 打印用户可执行文件所在的位置。例如，可用它来查找 psql 程序。通常这也是 pg_config 程序所在的位置。 --bindi…命令行工具 · 客户端程序 pg_config --bindir命令行工具PG18--bindir 打印用户可执行文件所在的位置。例如，可用它来查找psql程序。通常这也是pg_config程序所在的位置。pg_config › 选项 pg_config --cc命令行工具PG18--cc 打印构建PostgreSQL时所用的CC变量值。这显示所使用的 C 编译器。pg_config › 选项 pg_config --cflags命令行工具PG18--cflags 打印构建PostgreSQL时所用的CFLAGS变量值。这显示 C 编译器开关。pg_config › 选项 pg_config --cflags_sl命令行工具PG18--cflags_sl 打印构建PostgreSQL时所用的CFLAGS_SL变量值。这显示构建共享库时使用的额外 C 编译器开关。pg_config › 选项 pg_config --configure命令行工具PG18--configure 打印为构建PostgreSQL而运行configure脚本时给定的选项。这可用于重现完全相同的配置，或者查明某个二进制软件包是用哪些选项构建的。（但请注意，二进制软件包通常包含供应商特定的自定义补丁。）另请参见下面的示例。pg_config › 选项