关于服务端工具gs_dumpall的部分解读

最新推荐文章于 2024-08-09 21:25:57 发布

GGG47999

最新推荐文章于 2024-08-09 21:25:57 发布

阅读量322

点赞数

文章标签：数据库 java 开发语言开源

本文链接：https://blog.csdn.net/m0_62915426/article/details/127524915

版权

背景信息

gs_dumpall是openGauss用于导出所有数据库相关信息工具，它可以导出openGauss数据库的所有数据，包括默认数据库postgres的数据、自定义数据库的数据、以及openGauss所有数据库公共的全局对象。
gs_dumpall工具由操作系统用户omm执行。gs_dumpall工具在进行数据导出时，其他用户可以访问openGauss数据库（读或写）。gs_dumpall工具支持导出完整一致的数据。例如，T1时刻启动gs_dumpall导出openGauss数据库，那么导出数据结果将会是T1时刻该openGauss数据库的数据状态，T1时刻之后对openGauss的修改不会被导出。
gs_dumpall在导出openGauss所有数据库时分为两部分：

gs_dumpall自身对所有数据库公共的全局对象进行导出，包括有关数据库用户和
组，表空间以及属性（例如，适用于数据库整体的访问权限）信息。
gs_dumpall通过调用gs_dump来完成openGauss中各数据库的SQL脚本文件导
出，该脚本文件包含将数据库恢复为其保存时的状态所需要的全部SQL语句。

以上两部分导出的结果为纯文本格式的SQL脚本文件，使用gsql运行该脚本文件可以
恢复openGauss数据库。

注意事项

禁止修改导出的文件和内容，否则可能无法恢复成功。
为了保证数据一致性和完整性，gs_dumpall会对需要转储的表设置共享锁。如果某张表在别的事务中设置了共享锁，gs_dumpall会等待此表的锁释放后锁定此表。如果无法在指定时间内锁定某张表，转储会失败。用户可以通过指定–lock-wait-timeout选项，自定义等待锁超时时间。
由于gs_dumpall读取所有数据库中的表，因此必须以openGauss管理员身份进行连接，才能导出完整文件。在使用gsql执行脚本文件导入时，同样需要管理员权限，以便添加用户和组，以及创建数据库。

语法

gs_dumpall [OPTION]...

参数说明

通用参数：

-f, --file=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，编写一个任何用户都能存储的脚本，且该脚本会授予该用户拥有所有对象的权限。

连接参数：

-h, --host
指定主机的名称。如果取值是以斜线开头，它将用作Unix域套接字的目录。默认值取自PGHOST环境变量；如果没有设置，将启动某个Unix域套接字建立连接。该参数只针对openGauss外，对openGauss内本机只能用127.0.0.1。
环境变量：PGHOST
-l, --database
指定所连接的转储全局对象的数据库名称，并去寻找还有其他哪些数据库需要被转储。如果没有指定，会使用postgres数据库，如果postgres数据库不存在，会使用template1。
-p, --port
指定服务器所侦听的TCP端口或本地Unix域套接字后缀，以确保连接。默认值设置为PGPORT环境变量。
在开启线程池情况下，建议使用 pooler port，即侦听端口+1。
环境变量：PGPORT

说明

由于gs_dumpall内部调用gs_dump，所以一些诊断信息参见 gs_dump。
一旦恢复，最好在每个数据库上运行ANALYZE，优化程序提供有用的统计数据。
gs_dumpall恢复前需要所有必要的表空间目录才能退出；否则，对于处在非默认位置的数据库，数据库创建会失败。

示例

使用gs_dumpall一次导出openGauss的所有数据库。

gs_dumpall -f backup/bkp2.sql -p 37300
gs_dump[port='37300'][dbname='postgres'][2018-06-27 09:55:09]: The total objects number is 2371.
gs_dump[port='37300'][dbname='postgres'][2018-06-27 09:55:35]: [100.00%] 2371 objects have been 
dumped.
gs_dump[port='37300'][dbname='postgres'][2018-06-27 09:55:46]: dump database dbname='postgres' 
successfully
gs_dump[port='37300'][dbname='postgres'][2018-06-27 09:55:46]: total time: 55567 ms
gs_dumpall[port='37300'][2018-06-27 09:55:46]: dumpall operation successful
gs_dumpall[port='37300'][2018-06-27 09:55:46]: total time: 56088 ms