|
目录
11.1.?简介：
11.2.?命令行参数：
11.3.?参数说明：
11.4.?环境变量：
11.5.?错误信息诊断：
11.6.?示例：
11.7.?备注：
11.8.?参考：
11.1.?简介：
sys_dump — 把 KingbaseES 数据库抽取为一个脚本文件或其他归档文件
sys_dump 是一种用于备份 KingbaseES 数据库的工具。即使数据库正在并发使用，它也能创建一致的备份。sys_dump 不阻塞其他用户访问数据库（读取或写入）。
sys_dump 只转储单个数据库。要备份整个集群，或备份集群中所有数据库公共的全局对象（例如角色和表空间），请使用?sys_dumpall。
转储以脚本或归档文件格式输出。脚本转储是包含 SQL 命令的纯文本文件，可以使用该脚本文将数据库恢复到转储时的状态。要从这样的脚本恢复数据库，请将其提供给?ksql。 即使在其他机器和其他架构上，脚本文件也可用于恢复数据库；在经过一些修改后，甚至可以在其他 SQL 数据库产品上恢复数据库。
另一种可选的归档文件格式，须与?sys_restore?配合使用来恢复数据库。它们允许?sys_restore?选择要恢复的内容，甚至可以在恢复之前对条目重排序。归档文件格式旨在跨架构迁移。
当一种归档文件格式与?sys_restore?结合使用时，sys_dump 提供了一种灵活的归档和传输机制。sys_dump 可用于备份整个数据库，而?sys_restore?可用于检查归档并/或选择要恢复数据库的哪些部分。最灵活的输出文件格式是“自定义”格式（-Fc）和“目录”格式（-Fd）。它们允许选择和重排序所有已归档项，支持并行恢复，并且默认是压缩的。“目录”格式是唯一支持并行转储的格式。
当运行 sys_dump 时，请检查输出是否有任何警告（打印在标准错误上）。
11.2.?命令行参数：
sys_dump?[?connection-option?...] [?option?...] [?dbname?]
11.3.?参数说明：
下列命令选项控制输出的内容和格式。
dbname
指定要转储的数据库名。如果没有指定，将使用环境变量KINGBASE_DATABASE。如果环境变量也没有设置，则使用指定给该连接的用户名。
-a?--data-only
只转储数据，而不转储模式（数据定义）。表数据、大对象和序列值都会被转储。
这个选项类似于指定--section=data，但是由于历史原因又不完全相同。
-b?--blobs
在转储中包括大对象。这是默认行为，除非指定了--schema、--table或--schema-only。因此，只有在请求转储一个特定方案或者表的情况中，-b开关才对向转储中加入大对象有用。请注意，blobs是被视为数据，因此在使用--data-only时将包括在内，但在使用--schema-only时则不会包括。
-B?--no-blobs
排除转储中的大对象。
当同时给定-b和-B时，行为是输出大对象，当数据被转储时，请参考-b文档。
-c?--clean
在输出创建数据库对象的命令之前，输出清除（删除）它们的命令（除非还指定了--if-exists，否则如果目标数据库中不存在任何对象，恢复可能会产生一些无害的错误消息）。
这个选项只对纯文本格式有意义。对于归档格式，您可以在调用?sys_restore?时指定该选项。
-C?--create
该命令使得在输出的开始是创建数据库，并且重新连接到被创建的数据库（使用这种形式的脚本，在运行脚本之前连接的是目标安装中的哪个数据库都没有关系）。如果还指定了--clean，脚本会在重新连接之前删除并重建目标数据库。
使用--create时，输出还会包括数据库的注释（如果有）以及与这个数据库相关的配置变量的设置，也就是任何提到了这个数据库的ALTER?DATABASE?...?SET?...命令和ALTER?ROLE?...?IN?DATABASE?...?SET?...命令。除非指定有--no-acl，否则该数据库本身的访问特权也会被转储。
这个选项只对纯文本格式有意义。对于归档格式，您可以在调用?sys_restore?时指定这个选项。
-E?encoding?--encoding=encoding
以指定的字符集编码创建转储。默认情况下，转储会以数据库的编码创建（另一种得到相同结果的方式是将KCICLIENTENCODING环境变量设置成想要的转储编码）。
-f?file?--file=file
将输出发送到指定文件。对于基于输出格式的文件，这个参数可以被忽略，在这种情况下将使用标准输出。但是，对于目录输出格式必须给定这个参数，在目录输出格式中指定的是一个目录而不是一个文件。在这种情况中，该目录会由 sys_dump 创建，并且之前不能存在。
-F?format?--format=format
选择输出的格式。format可以是下列之一：
p?plain
输出一个纯文本形式的 SQL 脚本文件（默认值）。
c?custom
输出一个适合于作为?sys_restore?输入的自定义格式归档。和目录输出格式一起，这是最灵活的输出格式，它允许在恢复时手动选择和排序已归档的项。默认情况下，此格式也是压缩的。
d?directory
输出一个适合作为?sys_restore?输入的目录格式归档。这将创建一个目录，其中每个被转储的表和大对象都有一个文件，外加一个所谓的目录文件，该文件以一种?sys_restore?能读取的机器可读格式描述转储的对象。可以使用标准 Unix 工具操作目录格式归档，例如一个未压缩归档中的文件可以使用gzip工具压缩。这种格式默认是压缩的，也支持并行转储。
t?tar
输出一个适合于输入到?sys_restore?中的tar格式归档。tar格式可以兼容目录格式，抽取一个tar格式的归档会产生一个合法的目录格式归档。但是tar格式不支持压缩。此外，在使用tar格式时，表数据项的相对顺序不能在恢复过程中被更改。
-j?njobs?--jobs=njobs
通过同时归档njobs表来运行并行转储。这个选项缩减了转储的时间，但是它也增加了数据库服务器上的负载。您只能和目录输出格式一起使用这个选项，因为这是唯一一种让多个进程能在同一时间写其数据的输出格式。
sys_dump 将打开njobs?+ 1 个到该数据库的连接，因此请确保您的 max_connections 设置地足够高，可以容纳所有的连接。
在运行一次并行转储时请求数据库对象上的排他锁可能导致转储失败。其原因是， sys_dump 主控进程会在工作者进程将要稍后转储的对象上请求共享锁，以便确保在转储运行时不会有人删除它们并让它们出错。如果另一个客户端接着请求一个表上的排他锁，那个锁将不会被授予，但是会被排入队列等待主控进程的共享锁被释放。因此，任何其他对该表的访问将不会被授予，并且将在排他锁请求之后排队。这包括尝试转储该表的工作者进程。如果没有任何防范措施，这可能会是一种经典的死锁情况。要检测这种冲突， sys_dump 工作者进程使用NOWAIT选项请求另一个共享锁。 如果该工作者进程没有被授予这个共享锁，那么肯定是其他进程同时请求了一个排他锁，并且没有办法继续转储，因此 sys_dump 除了中止转储之外别无选择。
对于一致的备份，数据库服务器需要支持同步快照，这是在 KingbaseES V8.6 的主服务器和后备服务器中引入了一种特性。有了这种特性，即便数据库客户端使用不同的连接，也可以保证他们看到相同的数据集。sys_dump?-j使用多个数据库连接，它用主控进程连接到数据一次，并且为每一个工作者任务再一次连接数据库。如果没有同步快照特征，在每一个连接中不同的工作者任务将不能被保证看到相同的数据，这可能导致一个不一致的备份。
如果要运行 KingbaseES V8.6 之前的服务器的并行转储，您需要确保从主控进程连接到数据库一直到最后一个工作者任务连接到数据库之间，数据库内容不会发生改变。做这些最简单的方法是在开始备份之前停止任何访问数据库的数据修改进程（DDL和 DML）。当对 KingbaseES V8.6 之前版本的 KingbaseES 服务器运行sys_dump?-j时，还需要指定--no-synchronized-snapshots参数。
-K?--key=encryptkey
备份数据时候指定加密秘钥。1.秘钥长度不能超过16字节。2.不能和压缩同时使用。3.只能用于二进制格式输出。
-n?pattern?--schema=pattern
只转储匹配pattern的模式，这会选择模式本身以及它所包含的所有对象。当没有指定这个选项时，目标数据库中所有非系统模式都将被转储。多个模式可以通过书写多个-n开关来选择。另外，pattern参数可以被解释为一种根据ksql的?\d命令所用的相同规则编写的模式，这样多个模式也可以通过在该模式中书写通配字符来选择。在使用通配符时，如果需要，请小心引用该模式，防止 shell 扩展通配符；请详见下面的示例 。
注意
指定-n时，sys_dump 不会尝试转储所选模式可能依赖的任何其他数据库对象。因此，无法保证特定模式转储的结果可以自行成功地恢复到一个干净的数据库中。
注意
指定-n时，非模式对象（如二进制大对象）不会被转储。您可以使用--blobs开关将二进制大对象添加回该转储中。
-N?pattern?--exclude-schema=pattern
不转储匹配pattern的任何模式。 该模式根据与-n相同的规则进行解释。可以多次给定-N来排除与多个模式中的任何一个匹配的模式。
当-n和-N都被给定时，该行为是只转储匹配至少一个-n开关但是不匹配-N开关的模式。如果只有-N而没有-n，那么匹配-N的模式会被从一个正常转储中排除。
-O?--no-owner
不输出设置对象拥有关系来匹配原始数据库的命令。默认情况下，sys_dump 会发出ALTER?OWNER或SET?SESSION?AUTHORIZATION语句来设置被创建的数据库对象的拥有关系。除非该脚本是由超级用户（或是拥有脚本中所有对象的同一个用户）启动的，这些语句都将会失败。要使一个脚本能够被任意用户恢复，只有把所有对象的拥有关系都赋予这个用户，可指定-O。
这个选项只对纯文本格式有意义。对于归档格式，您可以在调用?sys_restore?时指定该选项。
-R?--no-reconnect
这个选项已经废弃，但是为了向后兼容仍然保留。
-s?--schema-only
只转储对象定义（模式），而非数据。这个选项与--data-only选项相反。它和指定--section=pre-data?--section=post-data相似，但是由于历史原因又不完全相同。（不要把这个选项和--schema选项混淆，后者在“schema”的使用上有不同的含义）。要为数据库中表的一个子集排除表数据，见--exclude-table-data。
-S?username?--superuser=username
指定要在禁用触发器时使用的超级用户的用户名。只有使用--disable-triggers时，这个选项才相关（通常，最好省去这个选项，而是以超级用户身份来启动生成的脚本）。
-t?pattern?--table=pattern
只转储名字匹配pattern的表，table可以是视图、物化视图、序列和外部表。通过写多个-t开关可以选择多个表。另外，pattern参数可以被解释为一种根据ksql的?\d命令所用的相同规则编写的模式，这样多个表也可以通过在该模式中书写通配符来选择。在使用通配符时，如果需要，请小心引用该模式，防止 shell 扩展通配符，请参加见下面示例。
使用-t时，-n和-N开关不会有效果，因为无论那些开关如何，都将转储-t选择的表，并且不会转储非表对象。
注意
指定-t时，sys_dump 不会尝试转储所选表可能依赖的任何其他数据库对象。因此，无法保证特定表转储的结果能够自行成功地恢复到一个干净的数据库中。
-T?pattern?--exclude-table=pattern
不转储匹配pattern模式的任何表。该模式根据与-t相同的规则被解释。-T可以多次给定来排除与多个模式中的任何一个模式匹配的表。
当同时给定-t和-T时，该行为是只转储匹配至少一个-t开关但是不匹配-T开关的表。如果只有-T而没有-t，那么匹配-T的表将从一个正常转储中排除。
-v?--verbose
指定冗长模式。这将导致 sys_dump 向标准错误输出详细的对象注释以及转储文件的开始/停止时间，还有进度消息。
-V?--version
打印 sys_dump 版本并退出。
-x?--no-privileges?--no-acl
防止转储访问特权（授予/收回命令）。
-Z?0..9?--compress=0..9
指定要使用的压缩级别。零意味着不压缩。对于自定义归档格式，这会指定个体表数据段的压缩，并且默认是进行中等级别的压缩。对于纯文本输出，设置一个非零压缩级别会导致整个输出文件被压缩，就好像它被 gzip 处理过一样，但是默认是不压缩。tar归档格式当前完全不支持压缩。
--binary-upgrade
这个选项用于就地升级功能。我们不推荐也不支持把它用于其他目的。这个选项在未来的发行中可能被改变而不做通知。
--column-inserts?--attribute-inserts
将数据转储为带有显式列名的INSERT命令（INSERT?INTO?table?(column, ...) VALUES ...）。这将使得恢复过程非常慢，这主要用于使转储能够被载入 到非KingbaseES数据库中。 在重新加载期间发生的任何错误只会导致有问题的INSERT的一部分的行丢失，而不是整个表的内容。
--disable-dollar-quoting
这个选项禁止在函数体中使用美元符号引用，并且强制它们使用 SQL 标准字符串语法进行引用。
--disable-triggers
只有在创建一个只转储数据的转储时，这个选项才相关。它指示 sys_dump 包括在数据被重新载入时能够临时禁用目标表上的触发器的命令。如果您在表上有引用完整性检查或其他触发器，并且您在数据重新载入期间不想调用它们，请使用这个选项。
当前，为--disable-triggers发出的命令必须作为超级用户来执行。因此，您还应当使用-S指定一个超级用户名，或者宁可作为一个超级用户启动生成的脚本。
这个选项只对纯文本格式有意义。对于归档格式，您可以在调用?sys_restore?时指定这个选项。
--enable-row-security
只有在转储具有行安全性的表的内容时，这个选项才相关。默认情况下，sys_dump 将把 row_security 设置为 off 来确保从该表中转储 出所有的数据。如果用户不具有足够能绕过行安全性的特权，那么会抛出 一个错误。这个参数指示 sys_dump 将 row_security 设置为 on，允许用户只转储该表中它们有权访问的部分内容。
注意如果当前您使用了这个选项，您可能还希望得到INSERT格式的转储，因为恢复期间的COPY?FROM不支持行安全性。
--exclude-table-data=pattern
不转储匹配pattern模式的任何表中的数据。 该模式根据-t的相同规则被解释。可以给定多次--exclude-table-data?来排除与多个模式中的任何一个模式匹配的表。当您需要一个特定表的定义但不想要其中的数据时， 这个选项就有用了。
要排除数据库中所有表的数据，见--schema-only。
--extra-float-digits=ndigits
在转储浮点数据时，使用extra_float_digits的指定值，而不是使用最大可用精度。用于备份目的的常规转储不应使用此选项。
--if-exists
时间条件性命令（即增加一个IF?EXISTS子句）来清除数据库和其他对象。 只有同时指定了--clean时，这个选项才可用。
--include-all-partitions
在单独备份一个分区表时，同时备份该分区表下所有分区的结构和数据。
--inserts
将数据转储为INSERT命令（而不是COPY）。 这将使恢复非常慢，这主要用于制作可以加载到非 KingbaseES 数据库的转储。 在重新加载期间发生的任何错误只会导致有问题的INSERT的一部分的行丢失，而不是整个表的内容。注意，如果重新安排了列顺序，则还原可能完全失败。--column-inserts选项对于列顺序的更改是安全的，但是更慢。
--load-via-partition-root
在为一个分区表转储数据时，使?COPY语句或者INSERT语句把包含它的分区层次的根作为目标，而不是分区自身。这会导致在装载数据时，为每一行重新确定合适的分区。如果在一台服务器上重新装载数据时，出现行并不是总是落入到和原始服务器上相同的分区中的情况，这个选项就会很有用。例如，如果分区列是文本类型，并且两个系统中用于排序分区列的排序规则有着不同的定义，就会发生这种情况。
从使用这个选项制作的归档恢复时，最好不要使用并行，因为?sys_restore?不会确切地知道一个给定的归档数据项将把数据装载到哪个分区中。这会导致效率不高，因为在并行任务见会有锁冲突，甚至可能由于在所有的相关数据被装载前建立了外键约束而导致重新装载失败。
--lock-wait-timeout=timeout
在转储的开始从不等待共享表锁的获得。如果在指定的timeout内不能锁定表时，则会失败。超时时长可以用SET?statement_timeout接受的任何格式指定（可以是一个整数表示的毫秒数）。
--no-comments
不转储注释。
--no-publications
不转储出版信息。
--no-security-labels
不转储安全标签。
--no-subscriptions
不转储订阅。
--no-sync
默认情况下，sys_dump 将等待所有文件安全地写入磁盘。
这个选项会让 sys_dump 不等待直接返回，这样会更快，但是也意味着后续的操作系统崩溃会让该转储损坏。通常这个选项对测试有用，但是不应该在从生产安装中转储数据时使用。
--no-tablespaces
不要输出选择表空间的命令。通过这个选项，在恢复期间所有的对象都会创建在默认的表空间中。
这个选项只对纯文本格式有意义。对于归档格式，您可以在调用?sys_restore?时指定该选项。
--no-unlogged-table-data
不转储非日志记录表的内容。这个选项对于表定义（模式）是否被转储没有影响，它只会限制转储表数据。当从备用服务器转储时，始终排除非日志记录表中的数据。
--on-conflict-do-nothing
向INSERT命令插入ON?CONFLICT?DO?NOTHING。 此选项无效，除非--inserts,?--column-inserts?或?--rows-per-insert也是指定的。
--quote-all-identifiers
强制引用所有标识符。当从 KingbaseES 主版本与 sys_dump 不同的服务器上转储一个数据库时，或者当输出准备载入到一个具有不同主版本的服务器时，推荐使用这个选项。默认情况下，sys_dump 仅引用在其自身的主要版本中作为保留字的标识符。在转储其他版本服务器时，这种默认行为有时会导致兼容性问题，因为那些版本可能具有些许不同的被保留词集合。使用--quote-all-identifiers能阻止这种问题，但代价是转储脚本更难阅读。
--rows-per-insert=nrows
使用INSERT命令转储数据(而非?COPY)。 控制INSERT每行的最大行数。指定的值必须是一个大于零的数字。在重新加载期间发生的任何错误只会导致有问题的INSERT的一部分的行丢失，而不是整个表的内容。
--section=sectionname
只转储命名的段。段的名称可以是pre-data、data或post-data。这个选项可以被指定多次来选择多个段。默认是转储所有段。
数据段包含真正的表数据、大对象内容和序列值。数据后项包括索引、触发器、规则和除了已验证检查约束之外的约束的定义。数据前项包括所有其他数据定义项。
--serializable-deferrable
为转储使用一个可序列化的事务，保证所使用的快照与后面的数据库状态是一致的。但是这样做是在事务流中等待一个点，在该点上不能存在异常，这样就不会有转储失败或者导致其他事务带着serialization_failure回滚的风险。
对于一个只为灾难恢复存在的转储，这个选项没什么益处。如果一个转储被用来在原始数据库持续更新期间载入一份用于报表或其他只读负载的数据库拷贝时，这个选项就有所帮助。如果没有这个选项，转储可能会反映一个与最终提交事务的任何执行序列都不一致的状态。例如，如果使用了批处理技术，一个批处理在转储中可以显示为关闭，而其中的所有项都不出现。
如果 sys_dump 被启动时没有读写事务在活动，则这个选项没有什么不同。如果有读写事务在活动，该转储的启动可能会被延迟一段不确定的时间。一旦开始运行，有没有这个开关的表现是相同的。
--snapshot=snapshotname
在做一个数据库的转储时指定一个同步的快照。
在需要把转储和一个逻辑复制槽或者一个并发会话同步时可以用上这个选项。
在并行转储的情况下，将使用这个选项指定的快照名而不是取一个新快照。
--strict-names
要求每一个模式（-n/--schema）和表（-t/--table）限定符至少匹配要转储的数据库中的一个模式/表。注意，如果没有找到有这样的模式/表限定符匹配，即便没有--strict-names，sys_dump 也将生成一个错误。
这个选项对-N/--exclude-schema、-T/--exclude-table或者--exclude-table-data没有效果。无法匹配任何对象的排除模式不会被当作错误。
--use-set-session-authorization
输出 SQL 标准的SET?SESSION?AUTHORIZATION命令取代ALTER?OWNER命令来确定对象的所有关系。这让该转储更加兼容标准，但是根据该转储中对象的历史记录，可能无法正常恢复。此外，使用SET?SESSION?AUTHORIZATION的转储肯定需要超级用户权限才能正确地恢复，而ALTER?OWNER需要较少的权限。
-??--help
显示有关 sys_dump 命令行参数的帮助并退出。
下列时命令行选项控制数据库连接参数。
-d?dbname?--dbname=dbname
指定要连接到的数据库名。这等效于指定dbname为命令行上的第一个非选项参数。
如果这个参数包含一个=符号或者以一个合法的URI前缀（kingbase://或kingbase://）开始，它将被视作一个conninfo字符串。
-h?host?--host=host
指定服务器正在运行的机器的主机名。如果该值开始于斜线，则将其用作 Unix 域套接字的目录。默认值取自KINGBASE_HOST环境变量（如果设置了），否则将尝次 Unix 域套接字连接。
-p?port?--port=port
指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展名。默认是放在KINGBASE_PORT环境变量中（如果设置了），否则使用编译在程序中的默认值。
-U?username?--username=username
要作为哪个用户连接。
-w?--no-password
不发出密码提示。如果服务器要求密码验证，并且密码不能通过其他方式获得（例如一个.kbpass文件），那么连接尝试将失败。这个选项对于在没有用户输入密码的批处理任务和脚本中有用。
-W?--password
强制 sys_dump 在连接到一个数据库之前提示输入密码。
这个选项从来不是必须的，因为如果服务器要求密码验证，sys_dump 会将自动提示输入密码。但是，sys_dump 将浪费一次连接尝试来发现服务器需要密码。在某些情况下，值得键入-W来避免额外的连接尝试。
--role=rolename
指定用来创建转储的角色名。这个选项导致 sys_dump 在连接到数据库后发出SET?ROLE?rolename命令。当经过身份验证的用户（由-U指定）缺少 sys_dump 所需的权限，但是能够切换到一个具有所需权限的角色时，这个选项很有用。一些安装有针对直接作为超级用户登录的策略，使用这个选项可以让转储在不违反该策略的前提下完成。
11.4.?环境变量：
KINGBASE_DATABASE
如果被设置，就是要创建的数据库名，默认和用户名相同，除非在命令行中覆盖。
KINGBASE_HOST
指定要连接的主机名，默认连接到localhost。
KINGBASE_PORT
指定要连接的服务器的端口号，默认为54321。需要根据数据库实际部署修订。
KINGBASE_USER
指定要使用哪个用户连接数据库。默认与使用数据库的操作系统用户名相同。
PGOPTIONS
指定要使用那些参数连接到数据库。
SYS_COLOR
指定是否在诊断消息中使用颜色。可能的值是always,?auto,?never.
和大部分其他 KingbaseES 工具相似，这个工具也使用 libkci 支持的环境变量。
11.5.?错误信息诊断：
sys_dump 在内部执行SELECT语句。如果您运行 sys_dump 时出现问题，确定您能够从正在使用的数据库中选择信息，例如?ksql?。此外，libkci 前端-后端库所使用的任何默认连接设置和环境变量都将适用。
sys_dump 的数据库活动由统计收集器正常地收集。如果不想这样，您可以通过KINGBASE_OPTIONS或ALTER?USER命令设置参数track_counts为假。
11.6.?示例：
要把一个数据库mydb转储到一个 SQL 脚本文件：
$ sys_dump mydb > db.sql
要把这样一个脚本重新载入到一个（新创建的）名为newdb的数据库中：
$ ksql -d newdb -f db.sql
要转储一个数据库到一个自定义格式归档文件：
$ sys_dump -Fc mydb > db.dump
要转储一个数据库到一个目录格式的归档：
$ sys_dump -Fd mydb -f dumpdir
要用 5 个并行的工作者任务转储一个数据库到一个目录格式的归档：
$ sys_dump -Fd mydb -j 5 -f dumpdir
要把一个归档文件重新载入到一个（新创建的）名为newdb的数据库：
$ sys_restore -d newdb db.dump
把一个归档文件重新装载到同一个数据库（该归档正是从这个数据库中转储得来）中，丢掉那个数据库中的当前内容：
$ sys_restore -d kingbase --clean --create db.dump
要转储一个名为mytab的表：
$ sys_dump -t mytab mydb > db.sql
要转储detroit模式中名称以emp开始的所有表，排除名为employee_log的表：
$ sys_dump -t 'detroit.emp*' -T detroit.employee_log mydb > db.sql
要转储名称以east或者west开始并且以gsm结束的所有模式，排除名称包含词test的任何模式：
$ sys_dump -n 'east*gsm' -n 'west*gsm' -N '*test*' mydb > db.sql
同样，用正则表达式记号法来合并开关：
$ sys_dump -n '(east|west)*gsm' -N '*test*' mydb > db.sql
要转储除了名称以ts_开头的表之外的所有数据库对象：
$ sys_dump -T 'ts_*' mydb > db.sql
在-t和相关开关中指定一个大写或混合大小写的名称，需要将名称用双引号引起来，否则会被折叠为小写。并且双引号对于 shell 是特殊的，所以必须依次引用。因此，要转储一个有混合大小写名称的表，您需要类似这样的东西：
$ sys_dump -t "\"MixedCaseName\"" mydb > mytab.sql
11.7.?备注：
如果您的数据库集群对于template1数据库有任何本地添加，请注意将 sys_dump 输出恢复到一个真正的空数据库。否则，由于增加对象的重复定义，您可能会遇到错误。要创建一个不带任何本地添加的空数据库，请从template0而不是template1复制它，例如：
CREATE DATABASE foo WITH TEMPLATE template0;
当仅选择数据转储并使用--disable-triggers时，sys_dump 在开始插入数据之前会发出命令禁用用户表上的触发器，并且接着在数据被插入之后发出命令重新启用它们。如果恢复中途被停止，系统目录可能会停留在一种错误状态。
sys_dump 产生的转储文件不包含优化器用来做出查询计划决定的统计信息。因此，在从一个转储文件恢复后运行ANALYZE来确保最优性能是明智的，详见?KingbaseES数据库维护指南?。
因为 sys_dump 用于传输数据到更新版本的 KingbaseES ，sys_dump 的输出被认为可以载入到比 sys_dump 版本更新的 KingbaseES 服务器中。 sys_dump 也能够从比其版本更旧的 KingbaseES 服务器中转储（当前支持回退到 KingbaseES V7 版本）。不过，sys_dump 无法从比起主版本号更新的 KingbaseES 服务器中转储，它甚至将拒绝冒着创建一个非法转储的风险尝试。还有，不保证 sys_dump 的输出能被载入到一个更旧主版本的服务器--即使该转储是从该版本的服务器中获取的也不行。将一个转储文件载入到一个更旧的服务器可能需要手工编辑该转储文件来移除旧服务器无法理解的语法。在跨版本的情况下，推荐使用--quote-all-identifiers选项，因为它可以避免因为不同 KingbaseES 版本间的保留字列表变化而发生问题。
在转储逻辑复制订阅时，sys_dump 将生成使用connect?=?false选项的CREATE?SUBSCRIPTION命令，这样恢复订阅时不会建立远程连接来创建复制槽或者进行初始的表拷贝。通过这种方式，可以无需到远程服务器的网络访问就能恢复该转储。然后就需要用户以一种合适的方式重新激活订阅。如果涉及到的主机已经改变，连接信息可能也必须被改变。在开启一次新的全表拷贝之前，截断目标表也可能是合适的。
11.8.?参考：
sys_dumpall,?sys_restore,?ksql
|