PostgreSQL 文档检索
PG 18 · 按类别浏览,或输入名称与关键词
常用条目12316
pg_resetwal --multixact-offset=mxoff-O mxoff--multixact-offset=mxoff
手工设置下一个多事务偏移量。 安全值可以通过查看数据目录下 pg_multixact/members 目录中数值最大的文件名,先加一,再乘以 52352 (0xCC80) 来确定。文件名是十六进制。这里没有像其他选项那样通过追加零即可得到结果的简单方法。pg_resetwal › 选项
pg_resetwal --next-oid=oid-o oid--next-oid=oid
手工设置下一个 OID。 并没有同样简单的方法来确定一个超出数据库中最大 OID 的下一个 OID,不过幸运的是,下一个 OID 的设置是否精确并不关键。pg_resetwal › 选项
pg_resetwal --next-transaction-id=xid-x xid--next-transaction-id=xid
手工设置下一个事务 ID。 安全值可以通过查看数据目录下 pg_xact 目录中数值最大的文件名,先加一,再乘以 1048576 (0x100000) 来确定。请注意,文件名是十六进制。通常,选项值也用十六进制指定最为简单。例如,如果 0011 是 pg_xact 中最大的条目,那么 -x 0x1200000 就可…pg_resetwal › 选项
pg_resetwal --next-wal-file=walfile-l walfile--next-wal-file=walfile
通过指定下一个 WAL 段文件的名称,手工设置 WAL 起始位置。 下一个 WAL 段文件的名称应大于当前数据目录下 pg_wal 目录中现存的任意 WAL 段文件名。这些名称同样采用十六进制,并由三个部分组成。第一部分是“时间线 ID”,通常应保持不变。例如,如果 0000000100000032000000…pg_resetwal › 选项
pg_resetwal --oldest-transaction-id=xid-u xid--oldest-transaction-id=xid
手工设置最旧的未冻结事务 ID。 安全值可以通过查看数据目录下 pg_xact 目录中数值最小的文件名,再乘以 1048576 (0x100000) 来确定。请注意,文件名是十六进制。通常,选项值也用十六进制指定最为简单。例如,如果 0007 是 pg_xact 中最小的条目,那么 -u 0x700000 就可…pg_resetwal › 选项
pg_resetwal --pgdata=datadirdatadir-D datadir--pgdata=datadir
指定数据库目录的位置。出于安全原因,必须在命令行上指定数据目录。pg_resetwal 不使用环境变量 PGDATA。pg_resetwal › 选项
pg_resetwal --version-V--version
显示版本信息,然后退出。pg_resetwal › 选项
pg_resetwal --wal-segsize=wal_segment_size--wal-segsize=wal_segment_size
设置新的 WAL 段大小,单位为兆字节。该值必须是 1 到 1024(兆字节)之间的 2 的幂。更多信息请参见 initdb 中的同名选项。 该选项也可用于更改现有数据库集簇的 WAL 段大小,从而避免重新执行 initdb。 注意 虽然 pg_resetwal 会把 WAL 起始位置设置到超出现有最新 WAL 段文…pg_resetwal › 选项
pg_resetxlog 重命名为 pg_resetwalO.4. pg_resetxlog 重命名为 pg_resetwal
PostgreSQL 9.6 及以下版本提供了名为 pg_resetxlog 的命令,用于重置预写式日志(WAL)文件。该命令已重命名为 pg_resetwal;有关 pg_resetwal 的文档,请参见 pg_resetwal;有关这一变更的详情,请参见 PostgreSQL 10 的发布说明。pg_resetxlog 重命名为 pg_resetwal
pg_restorepg_restore — 从由 pg_dump 创建的归档文件恢复 PostgreSQL 数据库
客户端程序
pg_restore [ connection-option ...] [ option ...] [ filename ]
手册中的可执行程序 pg_restore
程序版本 10.23
参考清单 客户端程序
选项定义组 42
手册中的选项
仅恢复数据,不恢复模式(…命令行工具 · 客户端程序
pg_restorepg_restore pg_restore — 从由 pg_dump 创建的归档文件恢复 PostgreSQL 数据库大纲 pg_restore [connection-option...] [option...] [filename]pg_restore
pg_restore --clean-c--clean
在恢复数据库对象之前,发出 DROP 命令以删除将要恢复的所有对象。此选项适用于覆盖现有数据库。如果目标数据库中有任何对象不存在,则会报告可忽略的错误消息,除非同时指定了 --if-exists。pg_restore › 选项
pg_restore --create-C--create
在向其中恢复之前先创建数据库。如果同时指定了 --clean,则会在连接到目标数据库之前先删除并重新创建它。 使用 --create 时,pg_restore 还会恢复数据库的注释(如果有)以及该数据库专有的任何配置变量设置,也就是任何提到该数据库的 ALTER DATABASE ... SET ... 和 ALTER ROLE ... IN DATABA…pg_restore › 选项
pg_restore --data-only-a--data-only
仅恢复数据,不恢复模式(数据定义)或统计信息。如果归档中包含,则会恢复表数据、大对象和序列值。 此选项类似于指定 --section=data,但出于历史原因,两者并不完全相同。pg_restore › 选项
pg_restore --dbname=dbname-d dbname--dbname=dbname
连接到数据库 dbname,并直接恢复到该数据库中。dbname 可以是一个连接字符串。如果是这样,连接字符串参数会覆盖任何冲突的命令行选项。pg_restore › 选项
pg_restore --disable-triggers--disable-triggers
此选项仅在执行不包含模式的恢复时才相关。它会指示 pg_restore 在恢复数据期间发出命令,临时禁用目标表上的触发器。如果你不希望在恢复数据期间触发表上的引用完整性检查或其他触发器,请使用此选项。 目前,为 --disable-triggers 发出的命令必须以超级用户身份执行。因此,你还应通过 -S 指定超级用户用户名,或者更好的是,…pg_restore › 选项
pg_restore --enable-row-security--enable-row-security
此选项仅在恢复启用了行安全性的表内容时才相关。默认情况下,pg_restore 会将 row_security 设置为 off,以确保所有数据都能恢复到表中。如果用户没有足够的权限绕过行安全性,就会抛出错误。此参数会指示 pg_restore 改为将 row_security 设置为 on,从而允许用户尝试在启用行安全性的情况下恢复表…pg_restore › 选项
pg_restore --exclude-schema=schema-N schema--exclude-schema=schema
不恢复位于指定模式中的对象。可以通过多次指定 -N 来排除多个模式。 当对同一模式名同时给出 -n 和 -N 时,-N 优先,该模式会被排除。pg_restore › 选项
pg_restore --exit-on-error-e--exit-on-error
如果在向数据库发送 SQL 命令时遇到错误,则退出。默认行为是继续执行,并在恢复结束时显示错误计数。pg_restore › 选项
pg_restore --file=filename-f filename--file=filename
指定生成脚本的输出文件,或者在与 -l 一起使用时指定列表输出文件。使用 - 表示 stdout。pg_restore › 选项
pg_restore --filter=filename--filter=filename
指定一个文件名,从中读取恢复时要排除或包含的对象匹配模式。这些模式按照与下列选项相同的规则解释:-n/--schema 用于包含某个模式中的对象,-N/--exclude-schema 用于排除某个模式中的对象,-P/--function 用于恢复指定函数,-I/--index 用于恢复指定索引,-t/--table 用于恢复指定表,以及 -…pg_restore › 选项
pg_restore --format=format-F format--format=format
指定归档格式。不必指定格式,因为 pg_restore 会自动确定格式。如果指定,可以是以下格式之一: ccustom # 归档采用 pg_dump 的自定义格式。 ddirectory # 归档是目录格式归档。 ttar # 归档是 tar 归档。pg_restore › 选项
pg_restore --function=function-name(argtype [, ...])-P function-name(argtype [, ...])--function=function-name(argtype [, ...])
仅恢复指定函数。请务必按转储文件目录中显示的形式准确拼写函数名和参数。可以通过多次指定 -P 来恢复多个函数。pg_restore › 选项
pg_restore --help-?--help
显示关于 pg_restore 命令行参数的帮助信息,并退出。pg_restore › 选项
pg_restore --host=host-h host--host=host
指定服务器所在机器的主机名。如果值以斜杠开头,则被用作 Unix 域套接字的目录。默认值取自 PGHOST 环境变量(如果已设置),否则尝试使用 Unix 域套接字连接。pg_restore › 选项
pg_restore --if-exists--if-exists
使用 DROP ... IF EXISTS 命令在 --clean 模式下删除对象。这会抑制原本可能报告的“does not exist”错误信息。除非同时指定了 --clean,否则此选项无效。pg_restore › 选项
pg_restore --index=index-I index--index=index
仅恢复指定名称的索引的定义。可以通过多次指定 -I 来恢复多个索引。pg_restore › 选项
pg_restore --jobs=number-of-jobs-j number-of-jobs--jobs=number-of-jobs
将 pg_restore 中最耗时的步骤,也就是装载数据、创建索引或创建约束,最多使用 number-of-jobs 个并发会话并行执行。此选项可以显著缩短将大型数据库恢复到运行在多处理器机器上的服务器所需的时间。当生成脚本而不是直接连接到数据库服务器时,此选项会被忽略。 每个作业都是一个进程或一个线…pg_restore › 选项
pg_restore --list-l--list
列出归档的目录内容(table of contents)。此操作的输出可用作 -L 选项的输入。请注意,如果在 -l 中使用 -n 或 -t 等过滤开关,它们会限制被列出的项目。pg_restore › 选项
pg_restore --no-acl-x--no-privileges--no-acl
阻止恢复访问权限(GRANT/REVOKE 命令)。pg_restore › 选项
pg_restore --no-comments--no-comments
不输出用于恢复注释的命令,即使归档中包含注释。pg_restore › 选项
pg_restore --no-data--no-data
不输出用于恢复数据的命令,即使归档中包含数据。pg_restore › 选项
pg_restore --no-data-for-failed-tables--no-data-for-failed-tables
默认情况下,即使表的创建命令失败(例如因为表已经存在),表数据仍然会被恢复。使用此选项时,这类表的数据会被跳过。如果目标数据库已经包含所需的表内容,这种行为会很有用。例如,PostgreSQL 扩展(如 PostGIS)的辅助表可能已经装载到目标数据库中;指定此选项可以防止向这些表装载重复或过时的数据。 此选项仅在直接恢复…pg_restore › 选项
pg_restore --no-owner-O--no-owner
不输出用于设置对象所有权以匹配原始数据库的命令。默认情况下,pg_restore 会发出 ALTER OWNER 或 SET SESSION AUTHORIZATION 语句,为所创建的模式元素设置所有权。除非对数据库的初始连接由超级用户发起(或者由脚本中所有对象的同一所有者发起),否则这些语句会失败。使用 -O 时,初始连接可以使用任意用户名,并且该…pg_restore › 选项
pg_restore --no-password-w--no-password
绝不发出密码提示。如果服务器要求密码认证,而又无法通过 .pgpass 文件等其他方式获得密码,则连接尝试将失败。在没有用户在场输入密码的批处理作业和脚本中,此选项很有用。pg_restore › 选项
pg_restore --no-policies--no-policies
不输出用于恢复行安全性策略的命令,即使归档中包含它们。pg_restore › 选项
pg_restore --no-publications--no-publications
不输出用于恢复发布的命令,即使归档中包含它们。pg_restore › 选项
pg_restore --no-reconnect-R--no-reconnect
这个选项已经过时,但仍然被接受以保持向后兼容性。pg_restore › 选项
pg_restore --no-schema--no-schema
不输出用于恢复模式(数据定义)的命令,即使归档中包含它们。pg_restore › 选项
pg_restore --no-security-labels--no-security-labels
不输出用于恢复安全标签的命令,即使归档中包含它们。pg_restore › 选项
更多结果
输入名称或关键词,从 PostgreSQL 手册与扩展目录中直接找到定义。
pg17: 限定版本 ex: 只搜扩展 ↑↓ 选择 ↵ 打开