PostgreSQL 文档检索

pg_backend_memory_contexts章节正文PG1853.5. pg_backend_memory_contexts 视图 pg_backend_memory_contexts 显示附属于当前会话的服务器进程中的全部内存上下文。pg_backend_memory_contexts 为每个内存上下文提供一行。表 53.5. pg_backend_memory_contexts 列 列类型 描述 name text 内存上下文的名称…pg_backend_memory_contexts pg_backend_pid函数与运算符本站词条返回附加到当前会话的服务器进程的进程ID。 Returns the process ID of the server process attached to the current session. pg_backend_pid () → integer 系统信息函数和操作符函数 · 系统信息函数和操作符 pg_background扩展与模块扩展目录在后台运行 SQL 查询 Run SQL queries in the background pg_background 时序与时态时序与时态 · 扩展目录 pg_background_queue扩展与模块扩展目录支持主题、并发限制与重试的后台 SQL 任务队列。 Topic-aware background SQL task queue with concurrency limits and retries. queue background-worker retry scheduler pg_background_queue 时序与时态时序与时态 · 扩展目录 pg_backtrace扩展与模块扩展目录pg_backtrace：用于在 PostgreSQL 错误和信号处理时输出调用栈回溯的扩展。 Show backtrace for errors and signals backtrace debugging error pg_backtrace 监控统计监控统计 · 扩展目录 pg_backup_compliance扩展与模块扩展目录监测备份相关会话并通过 SQL 视图查询捕获记录 Monitor backup-related sessions and expose captured operations as SQL views audit backup pg_backup_compliance 安全安全 · 扩展目录 pg_backup_start函数与运算符本站词条准备服务器开始在线备份。 Prepares the server to begin an on-line backup. pg_backup_start ( label text [, fast boolean] ) → pg_lsn 系统管理函数函数 · 系统管理函数 pg_backup_start_time函数与运算符本站词条如果正在进行在线排他备份，返回其开始时间，否则返回 NULL。 Returns the start time of the current on-line exclusive backup if one is in progress, otherwise NULL. pg_backup_start_time () → timestamp with time zone 系统管理函…函数 · 系统管理函数 pg_backup_stop函数与运算符本站词条结束在线备份。 Finishes performing an on-line backup. pg_backup_stop ( [wait_for_archive boolean] ) → record ( lsn pg_lsn, labelfile text, spcmapfile text ) 系统管理函数函数 · 系统管理函数 pg_base58扩展与模块扩展目录Base58 编码/解码函数 Base58 Encoder/Decoder Extension for PostgreSQL pgrx pg_base58 函数与聚合函数与聚合 · 扩展目录 pg_base62扩展与模块扩展目录将 UUID 编码为 URL 安全的 Base62 字符串，并支持反向解码。 Encode UUID values to URL-safe Base62 strings and decode them back. base62 pgrx postgresql rust uuidv7 pg_base62 实用工具实用工具 · 扩展目录 pg_basebackup命令行工具本站词条pg_basebackup — 获取 PostgreSQL 集簇的基础备份 客户端程序 pg_basebackup [ option ...] 手册中的可执行程序 pg_basebackup 程序版本 10.23 参考清单 客户端程序 选项定义组 26 手册中的选项 设置写入输出的目标目录。如果该目录不存在， pg_basebackup 会创建它（以及所有缺失的父目录）。如果…命令行工具 · 客户端程序 pg_basebackup章节正文PG18pg_basebackup pg_basebackup — 获取 PostgreSQL 集簇的基础备份大纲 pg_basebackup [option...]pg_basebackup pg_basebackup --checkpoint={fast|spread}命令行工具PG18-c {fast|spread}--checkpoint={fast|spread} 将检查点模式设置为 fast（立即）或 spread（默认）（见第 25.3.4 节）。pg_basebackup › 选项 pg_basebackup --compress=[{client|server}-]method[:detail]命令行工具PG18-Z level-Z [{client|server}-]method[:detail]--compress=level--compress=[{client|server}-]method[:detail] 请求对备份进行压缩。如果包含 client 或 server，则指定压缩执行的位置。在服务器端压缩会减少传输带宽占用，但会增加服务器 CPU 消耗。默认值是 client…pg_basebackup › 选项 pg_basebackup --create-slot命令行工具PG18-C--create-slot 指定在开始备份之前，应创建由 --slot 选项指定名称的复制槽。如果该槽已经存在，则会报错。pg_basebackup › 选项 pg_basebackup --dbname=connstr命令行工具PG18-d connstr--dbname=connstr 以连接字符串的形式指定用于连接服务器的参数；这些参数会覆盖任何相互冲突的命令行选项。 出于与其他客户端应用保持一致的考虑，此选项名为 --dbname；但由于 pg_basebackup 并不连接到集簇中的某个特定数据库，连接字符串中包含的数据库名会被服务器忽略。不过，以这种方式提供的数据库名会覆盖默认数据库名（replic…pg_basebackup › 选项 pg_basebackup --format=format命令行工具PG18-F format--format=format 选择输出格式。format 可以是以下值之一： pplain # 将输出写为普通文件，其布局与源服务器的数据目录和表空间相同。当集簇没有额外表空间时，整个数据库都会放在目标目录中。如果集簇包含额外表空间，则主数据目录会放在目标目录中，而其他所有表空间都会放在与源服务器上相同的绝对路径中。（如需改变这一点，见 --tablespa…pg_basebackup › 选项 pg_basebackup --gzip命令行工具PG18-z--gzip 启用 tar 文件输出的 gzip 压缩，使用默认压缩级别。压缩仅在使用 tar 格式时可用，并且所有 tar 文件名都会自动添加.gz 后缀。pg_basebackup › 选项 pg_basebackup --help命令行工具PG18-?--help 显示 pg_basebackup 命令行参数的帮助并退出。pg_basebackup › 选项 pg_basebackup --host=host命令行工具PG18-h host--host=host 指定服务器运行所在机器的主机名。如果该值以斜线开头，则它会被用作 Unix 域套接字的目录。默认值取自 PGHOST 环境变量（如果已设置）；否则会尝试使用 Unix 域套接字连接。pg_basebackup › 选项 pg_basebackup --incremental=old_manifest_file命令行工具PG18-i old_manifest_file--incremental=old_manifest_file 执行增量备份。必须提供参考备份的备份清单；该文件将被上传到服务器，随后服务器会返回所请求的增量备份。pg_basebackup › 选项 pg_basebackup --label=label命令行工具PG18-l label--label=label 设置备份标签。如果未指定，则使用默认值“pg_basebackup base backup”。pg_basebackup › 选项 pg_basebackup --manifest-checksums=algorithm命令行工具PG18--manifest-checksums=algorithm 指定应用到备份清单中每个文件的校验和算法。目前可用的算法有 NONE、CRC32C、SHA224、SHA256、SHA384 和 SHA512。默认值为 CRC32C。 如果选择 NONE，备份清单将不包含任何校验和。否则，它将包含使用指定算法为备份中每个文件计算的校验和。此外，清单始终会包含其自身内容的 SHA25…pg_basebackup › 选项 pg_basebackup --manifest-force-encode命令行工具PG18--manifest-force-encode 强制将备份清单中的所有文件名编码为十六进制。如果未指定此选项，则只对非 UTF8 文件名进行十六进制编码。此选项主要用于测试读取备份清单文件的工具是否能正确处理这种情况。pg_basebackup › 选项 pg_basebackup --max-rate=rate命令行工具PG18-r rate--max-rate=rate 设置从源服务器收集数据时允许的最大传输速率。这有助于限制 pg_basebackup 对服务器的影响。取值单位为每秒千字节。使用后缀 M 表示每秒兆字节。也接受后缀 k，但没有实际影响。有效取值范围为每秒 32 千字节到每秒 1024 兆字节。 此选项始终影响数据目录的传输。只有当收集方法为 fetch 时，WAL 文件的传输才会受…pg_basebackup › 选项 pg_basebackup --no-clean命令行工具PG18-n--no-clean 默认情况下，当 pg_basebackup 因错误中止时，它会删除在发现自己无法完成任务之前可能已创建的所有目录（例如目标目录和预写式日志目录）。此选项会禁止这种清理，因此对调试很有帮助。 请注意，无论是否使用此选项，表空间目录都不会被清理。pg_basebackup › 选项 pg_basebackup --no-estimate-size命令行工具PG18--no-estimate-size 阻止服务器估算将要流式传输的备份数据总量，因此 pg_stat_progress_basebackup 视图中的 backup_total 列将始终为 NULL。 如果不使用此选项，备份会先枚举整个数据库的大小，然后再回过头来发送实际内容。这可能会让备份耗时略长，特别是在发送第一批数据之前所需时间会更久。如果这种估算耗时过长，此选项就很有用…pg_basebackup › 选项 pg_basebackup --no-manifest命令行工具PG18--no-manifest 禁止生成备份清单。如果未指定此选项，服务器将生成并发送一个备份清单，可使用 pg_verifybackup 进行验证。该清单列出了备份中的每一个文件，但不包括可能包含在其中的任何 WAL 文件。它还会保存每个文件的大小、最后修改时间以及可选的校验和。pg_basebackup › 选项 pg_basebackup --no-password命令行工具PG18-w--no-password 禁止发出密码提示。如果服务器要求密码认证，而又无法通过其他方式（例如.pgpass 文件）获得密码，则连接尝试将失败。此选项对于批处理作业和脚本很有用，因为那种场景下通常没有用户在场输入密码。pg_basebackup › 选项 pg_basebackup --no-slot命令行工具PG18--no-slot 防止为备份创建临时复制槽。 默认情况下，如果选择了 WAL 流式传输，但没有使用 -S 选项给出槽名，那么会创建一个临时复制槽（如果源服务器支持）。 此选项的主要目的是在服务器没有空闲复制槽时，仍然允许执行基础备份。几乎总是首选使用复制槽，因为它能防止服务器在备份期间移除所需的 WAL。pg_basebackup › 选项 pg_basebackup --no-sync命令行工具PG18-N--no-sync 默认情况下，pg_basebackup 会等待所有文件都被安全写入磁盘。此选项会使 pg_basebackup 不经等待就直接返回，因此速度更快，但这意味着如果随后操作系统崩溃，基础备份可能会损坏。通常，此选项适合测试，但不应用于创建生产环境安装。pg_basebackup › 选项 pg_basebackup --no-verify-checksums命令行工具PG18--no-verify-checksums 如果获取基础备份的服务器启用了校验和，则禁用对这些校验和的验证。 默认情况下，会验证校验和；校验和验证失败将导致非零退出状态。不过，在这种情况下，基础备份不会被删除，就像使用了 --no-clean 一样。校验和验证失败也会在 pg_stat_database 视图中报告。pg_basebackup › 选项 pg_basebackup --password命令行工具PG18-W--password 强制 pg_basebackup 在连接源服务器之前提示输入密码。 此选项绝非必需，因为如果服务器要求密码认证，pg_basebackup 会自动提示输入密码。不过，pg_basebackup 会浪费一次连接尝试来发现服务器需要密码。在某些情况下，输入 -W 以避免额外的连接尝试是值得的。pg_basebackup › 选项 pg_basebackup --pgdata=directory命令行工具PG18-D directory--pgdata=directory 设置写入输出的目标目录。如果该目录不存在，pg_basebackup 会创建它（以及所有缺失的父目录）。如果该目录已经存在，则必须为空。 当备份采用 tar 格式时，目标目录可以指定为-（短横线），从而将 tar 文件写到 stdout。 此选项是必需的。pg_basebackup › 选项 pg_basebackup --port=port命令行工具PG18-p port--port=port 指定服务器监听连接所使用的 TCP 端口，或本地 Unix 域套接字文件扩展名。默认使用 PGPORT 环境变量中的值（如果已设置），否则使用编译时确定的默认值。pg_basebackup › 选项 pg_basebackup --progress命令行工具PG18-P--progress 启用进度报告。打开此选项后，会在备份过程中给出一个近似的进度报告。由于数据库在备份过程中可能发生变化，因此这只是近似值，最终未必恰好结束在 100%。特别是当备份中包含 WAL 时，总数据量无法预先估计；在这种情况下，一旦进度超过不含 WAL 时的总估计值，估计目标大小就会继续增加。pg_basebackup › 选项 pg_basebackup --slot=slotname命令行工具PG18-S slotname--slot=slotname 此选项只能与 -X stream 一起使用。它会使 WAL 流式传输使用指定的复制槽。如果此基础备份打算用作使用复制槽的流复制备库，那么该备库应将同一个复制槽名称用作 primary_slot_name 的值。这样可以确保主库在基础备份结束与新备库开始流复制之间的这段时间内，不会移除任何必需的 WAL 数据。 指定的复制槽必…pg_basebackup › 选项 pg_basebackup --status-interval=interval命令行工具PG18-s interval--status-interval=interval 指定发送回源服务器的状态包之间相隔的秒数。较小的值可以让服务器端对备份进度的监控更精确。值为零时会完全禁用周期性状态更新，不过当服务器请求时仍会发送更新，以避免因超时而断开连接。默认值是 10 秒。pg_basebackup › 选项 pg_basebackup --sync-method=method命令行工具PG18--sync-method=method 设置为 fsync（默认）时，pg_basebackup 会递归打开并同步备份目录中的所有文件。使用普通文件格式时，查找文件会跟随 WAL 目录和各已配置表空间的符号链接。 在 Linux 上，也可以使用 syncfs，让操作系统同步包含备份目录的整个文件系统。使用普通文件格式时，pg_basebackup 还会同步包含 WAL 文件和…pg_basebackup › 选项