华为云首页用户手册

数据仓库服务 GAUSSDB(DWS)-gs_dumpall:参数说明

时间：2024-10-26 11:41:19

数据仓库服务 GAUSSDB(DWS)

参数说明

通用参数：

-f, --filename=FILENAME
将输出发送至指定文件。如果这里省略，则使用标准输出。
-v, --verbose
指定verbose模式。该选项将导致gs_dumpall向转储文件输出详细的对象注解和启动/停止次数，向标准错误流输出处理信息。
-V, --version
打印gs_dumpall版本，然后退出。
--lock-wait-timeout=TIMEOUT
请勿在转储刚开始时一直等待以获取共享表锁。如果无法在指定时间内锁定某个表，就选择失败。可以以任何符合SET statement_timeout的格式指定超时时间。
-?, --help
显示gs_dumpall命令行参数帮助，然后退出。

转储参数：

-a, --data-only
只转储数据，不转储模式（数据定义）。
-c, --clean
在重新创建数据库之前，执行SQL语句清理（删除）这些数据库。针对角色和表空间的转储命令已添加。
-g, --globals-only
只转储全局对象（角色和表空间），无数据库。
-o, --oids
转储每个表的对象标识符（OIDs），作为表的一部分数据。该选项用于应用以某种方式（例如：外键约束方式）参照了OID列的情况。如果不是以上这种情况，请勿使用该选项。
-O, --no-owner
不输出设置对象的归属这样的命令，以匹配原始数据库。默认情况下，gs_dumpall会发出ALTER OWNER或SET SESSION AUTHORIZATION语句设置所创建的模式元素的所属。如果脚本正在运行，该语句不会执行成功，除非是由系统管理员触发（或是拥有脚本中所有对象的同一个用户）。通过指定-O，编写一个任何用户都能存储的脚本，且该脚本会授予该用户拥有所有对象的权限。
-r, --roles-only
只转储角色，不转储数据库或表空间。
-s, --schema-only
只转储对象定义（模式），而非数据。
-S, --sysadmin=NAME
在转储过程中使用的系统管理员名称。
-t, --tablespaces-only
只转储表空间，不转储数据库或角色。
-x, --no-privileges
防止转储访问权限（授权/撤销命令）。
--column-inserts|--attribute-inserts
以INSERT命令带列名（INSERT INTO表（列、…）值…）方式导出数据。这会导致恢复缓慢。但是由于该选项会针对每行生成一个独立分开的命令，所以在重新加载某行时出现的错误只会导致那行丢失，而非整个表内容。
--disable-dollar-quoting
该选项将禁止在函数体前使用美元符号$，并强制使用SQL标准字符串语法对其进行引用。
--disable-triggers
该参数为扩展预留接口，不建议使用。
--inserts
发出INSERT命令（而非COPY命令）时转储数据。这会导致恢复缓慢。注意如果重排列顺序，可能会导致恢复整个失败。--column-inserts选项更加安全，虽然可能更慢些。
--no-security-labels
该参数为扩展预留接口，不建议使用。
--no-tablespaces
该参数在8.2.0.100版本中已废弃，为兼容历史版本功能保留该函数。

请勿输出创建表空间的命令，也请勿针对对象选择表空间。使用该选项，无论默认表空间是哪个，在恢复过程中所有对象都会被创建。
--no-unlogged-table-data
该参数为扩展预留接口，不建议使用。
--quote-all-identifiers
强制对所有标识符加引号。为了向后续版本迁移，且其中可能涉及引入额外关键词，在转储相应数据库时该选项会有帮助。
--dont-overwrite-file
不重写当前文件。
--use-set-session-authorization
输出符合SQL标准的SET SESSION AUTHORIZATION命令而不是ALTER OWNER命令来确定对象所有权。这样令转储更加符合标准，但是如果转储文件中的对象的历史有些问题，那么可能不能正确恢复。并且，使用SET SESSION AUTHORIZATION的转储需要数据库系统管理员的权限才能转储成功，而ALTER OWNER需要的权限则低得多。
--with-encryption=AES128
指定转储数据需用AES128进行加密。
--with-key=KEY
AES128密钥长度必须是16字节。
--include-extensions
如果include-extensions参数被设置，将备份所有的CREATE EXTENSION语句。
--include-templatedb
转储过程中包含模板库。
--dump-nodes
转储过程中包含节点和Node Group。
--include-nodes
将TO NODE语句包含在已转储的CREATE TABLE命令中。
--include-buckets
该参数为扩展预留接口，不建议使用。
--dump-wrm
存储过程中包含负载资源管理器，具体包括资源池、负载组以及负载组映射。
--binary-upgrade
该参数为扩展预留接口，不建议使用。
--binary-upgrade-usermap="USER1=USER2"
该参数为扩展预留接口，不建议使用。
--tablespaces-postfix
该参数为扩展预留接口，不建议使用。
--parallel-jobs
指定备份进程并发数，取值范围为1~1000。