ux_basebackup — 获得UXDB集群的基础备份
ux_basebackup
[option
...]
ux_basebackup被用于获得一个正在运行的UXDB数据库集群的基础备份。获得这些备份不会影响连接到该数据库的其他客户端,并且可以被用于时间点恢复以及用作一个日志传送或流复制后备服务器的开始点。
ux_basebackup建立数据库集群文件的一份二进制副本,同时保证系统进入和退出备份模式。备份总是从整个数据库集群获得,不可能备份单个数据库或数据库对象。关于个体数据库备份,必须使用如ux_dump的工具。
备份通过一个常规UXDB连接制作,并且使用复制协议。该连接必须由一个超级用户或者一个具有REPLICATION
权限的用户建立,并且ux_hba.conf
必须显式地允许该复制连接。该服务器还必须被配置,使max_wal_senders
设置得足够高以留出至少一个会话用于备份以及一个用于WAL流(如果使用流)。
在同一时间可以有多个ux_basebackup
运行,但是从性能的角度来说最好只做一个备份并且复制结果。
ux_basebackup不仅能从主控机也能从后备机创建一个基础备份。要从后备机获得一个备份,设置后备机让它能接受复制连接(也就是,设置max_wal_senders
和hot_standby
,并且配置host-based authentication
),还需要在主机上启用full_page_writes
。
注意在来自后备机的在线备份中有一些限制:
不会在被备份的数据库集群中创建备份历史文件。
如果正在使用-X none
,不保证备份所需的所有 WAL 文件在备份结束时被归档。
如果在在线备份期间后备机被提升为主控机,备份会失败。
备份所需的所有WAL记录必须包含足够的全页写,这要求你在主控机上启用full_page_writes
并且不使用一个类似ux_compresslog的工具以archive_command
从WAL文件中移除full_page_writes
。
下列命令行选项控制输出的位置和格式。
-D directory
--uxdata=directory
将输出写到哪个目录。如果必要,ux_basebackup将创建该目录及任何父目录。该目录可能已经存在,但是如果该目录已经存在并且非空就是一个错误。
当备份处于tar模式中并且目录被指定为-
(破折号)时,tar文件将被写到stdout
。
这个选项是必需的。
-F format
--format=format
为输出选择格式。format
可以是下列之一:
p
plain
把输出写成平面文件,使用和当前数据目录和表空间相同的布局。当集群没有额外表空间时,整个数据库将被放在目标目录中。如果集群包含额外的表空间,主数据目录将被放置在目标目录中,但是所有其他表空间将被放在它们位于服务器上的相同的绝对路径中。
这是默认格式。
t
tar
将输出写成目标目录中的tar文件。主数据目录将被写入到一个名为base.tar
的文件中,并且其他表空间将被以其OID命名。
如果值-
(破折号)被指定为目标目录,tar内容将被写到标准输出,适合于管道输出到其他程序,例如gzip。只有当集簇没有额外表空间并且没有使用WAL流时这才是可能的。
-r rate
--max-rate=rate
从该服务器传输数据的最大传输率。值的单位是千字节每秒。加上一个后缀M
表示兆字节每秒。也接受后缀k
,但是没有效果。合法的值在32千字节每秒到1024兆字节每秒之间。
其目标是限制在运行服务器上的ux_basebackup产生的影响。
这个选项会影响数据目录的传输。如果收集方法是fetch
时,只有WAL文件受到影响。
-R
--write-recovery-conf
在输出目录中(或者当使用tar格式时再基础归档文件中)写一个最小的recovery.conf
来简化设置一个后备服务器。recovery.conf
文件将记录连接设置(如果有)以及ux_basebackup所使用的复制槽,这样流复制后面就会使用相同的设置。
-S slotname
--slot=slotname
指定WAL流使用的复制槽。这个选项只能和-
X
stream
一起使用。如果该基础备份准备用作一个使用复制槽的流复制后备服务器,它应该使用recovery.conf
中相同的复制槽名称。那样就可以确保服务器不会移除基础备份结束和流复制开始之前必要的WAL数据。
如果未指定此选项并且服务器支持临时复制槽,则自动使用临时复制槽进行WAL流式传输。
--no-slot
此选项禁止在备份过程中创建临时复制槽,即使受到服务器支持。
如果在使用日志流时未使用选项-S给出插槽名称,则会默认创建临时复制槽。
此选项的主要目的是在服务器没有空闲复制槽时允许进行基本备份。通常情况下,使用复制槽是首选,因为它可以防止备份期间服务器删除所需的WAL。
-T olddir
=newdir
--tablespace-mapping=olddir
=newdir
在备份期间将目录olddir
中的表空间重定位到newdir
中。为使之有效,olddir
必须正好匹配表空间所在的路径(但如果备份中没有包含olddir
中的表空间也不是错误)。olddir
和newdir
必须是绝对路径。如果路径中包含了一个=
符号,可用反斜线对它转义。对于多个表空间可以多次使用这个选项。
如果以这种方法重定位一个表空间,主数据目录中的符号链接会被更新成指向新位置。因此新数据目录已经可以被一个所有表空间位于更新后位置的新服务器实例使用。
-X method
--wal-method=method
指定收集预写日志的方法,在备份中包括所需的预写式日志文件(WAL文件)。这包括所有在备份期间产生的预写日志。除非指定了方法none
,可以在收集的目录中直接启动一个uxtmaster,而不需要参考日志归档,因此得到一个完全独立的备份。
澳门游戏平台注册网站支持下列收集预写式日志的方法:
n
none
不要在备份中包括预写式日志。
f
fetch
在备份末尾收集预写式日志文件。因此,有必要把wal
-
keep
-
segments
参数设置得足够高,这样在备份末尾之前日志不会被移除。如果在要传输日志时它已经被轮转,备份将失败并且是不可用的。
预写式日志文件将被写入到base.tar
文件。
s
stream
在备份被创建时流传送预写式日志。这将开启一个到服务器的第二连接并且在运行备份时并行开始流传输预写式日志。因此,它将使用最多两个由max
-
wal
-
senders
参数配置的连接。只要客户端能保持接收预写式日志,使用这种模式不需要在主控机上保存额外的预写式日志。
预写式日志文件被写入到一个名为ux_wal.tar
的单独文件。
这个值是默认值。
--waldir=waldir
指定用于预写式日志目录的位置。waldir
必须是绝对路径。只有当备份是平面文件模式时才能指定事务日志目录。
-z
--gzip
启用对tar文件输出的gzip压缩,使用默认的压缩级别。只有使用tar格式时压缩才可用,并且会在所有tar文件名后面自动加上后缀.gz
后缀。
-Z level
--compress=level
启用对tar文件输出的gzip压缩,并且制定压缩机别(0 到 9,0 是不压缩,9 是最佳压缩)。只有使用tar格式时压缩才可用,并且会在所有tar文件名后面自动加上后缀.gz
后缀。
下列命令行选项控制备份的生成和程序的运行。
-c fast|spread
--checkpoint=fast|spread
将检查点模式设置为fast(立刻)或spread(默认值)。
-l label
--label=label
为备份设置标签。如果没有指定,将使用一个默认值“ux_basebackup
”。
-n
--no-clean
默认情况下,当ux_basebackup
中止并出现错误时,它会在发现它无法完成任务之前删除它可能创建的所有目录(例如数据目录和预写日志目录)。该选项禁止更改,因为对于调试非常有用。
请注意,表空间目录不会以任何方式清理。
-N
--no-sync
默认情况下,ux_basebackup
将等待所有文件被安全地写到磁盘上。这个选项导致ux_basebackup
无需等待而返回,节省时间但意味着后续的操作系统崩溃可能会导致基础备份损坏。通常,此选项对测试非常有用,但在创建生产安装时不应使用此选项。
-P
--progress
启用进度报告。启用这个选项将在备份期间发送进度报告。由于数据库可能在备份期间改变,这仅仅是一个大致进度并且可能不会完全达到100%
。特别是,当WAL日志被包括在备份中时,总数据量无法预先估计,在这种情况中估计的目标尺寸会在它传递不带WAL的总估值后增加。
当这个选项被启用时,备份开始时会列举整个数据库的尺寸,然后返回接着开始发送实际的内容。这可能使备份需要多花一些时间,并且它在发送第一个数据之前花费的时间最长。
下列命令行选项控制数据库连接参数:
-d connstr
--dbname=connstr
以一个连接字符串的形式指定用于连接到服务器的参数。
为了和其他客户端应用一致,该选项被称为--dbname
。但是因为ux_basebackup并不连接到集簇中的任何特定数据库,连接字符串中的数据库名将被忽略。
-h host
--host=host
指定运行服务器的机器的主机名。如果该值以一个斜线开始,它被用作 Unix 域套接字的目录。默认值取自UXHOST
环境变量(如果设置),否则会尝试一个 Unix 域套接字连接。
-p port
--port=port
指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展。默认用UXPORT
环境变量中的值(如果设置),或者一个编译在程序中的默认值。
-s interval
--status-interval=interval
指定发送回服务器的状态包之间的秒数,更容易地监控服务器的进度。0表示完全禁用这种周期性的状态更新,当服务器请求更新时,仍然会发送更新,避免超时导致的断开连接。默认值是10秒。
-U username
--username=username
要作为哪个用户连接。
-w
--no-password
从不发出一个口令提示。如果服务器要求口令认证并且没有其他方式提供口令(例如一个.uxpass
文件),那儿连接尝试将失败。这个选项对于批处理任务和脚本有用,因为在其中没有一个用户来输入口令。
-W
--password
强制ux_basebackup在连接到一个数据库之前提示要求一个口令。
这个选项不是必不可少的,因为如果服务器要求口令认证,ux_basebackup将自动提示要求一个口令。但是,ux_basebackup将浪费一次连接尝试来发现服务器想要一个口令。在某些情况下值得用-W
来避免额外的连接尝试。
其他选项也可用:
-V
--version
打印ux_basebackup版本并退出。
-?
--help
显示有关ux_basebackup命令行参数的帮助并退出。
和大部分其他UXDB工具相似,这个工具也使用libpq支持的环境变量。
在备份开始时,需要在获取备份的服务器上写入一个检查点。如果未使用选项--checkpoint=fast
,则可能需要一些时间,在这段时间内,ux_basebackup将显示为空闲状态。
备份包括数据目录和表空间中的所有文件:配置文件以及第三方放置在该目录中的附加文件(除了由UXDB管理的某些临时文件)。但是只复制常规文件和目录,除了保留用于表空间的符号链接。指向UXDB已知的某些目录的符号链接被复制为空目录。其他符号链接和特殊的设备文件会被跳过。
表空间默认以普通格式备份到与它们在服务器上相同的路径中,除非使用了--tablespace-mapping
选项。如果没有这个选项并且表空间正在使用,一台服务器进行普通格式基础备份时将无法工作,因为备份必须要写入到与原始表空间相同的目录。
在使用tar格式模式时,用户应在启动UXDB服务器前解压每一个tar文件。如果有额外的表空间,用于它们的tar文件需要被解压到正确的位置。在这种情况下,服务器将根据base.tar
中的tablespace_map
文件的内容为那些表空间创建符号链接。
要创建服务器mydbserver
的一个基础备份并将它存储在本地目录/home/uxdb/uxdbinstall/dbsql/data
中:
$
ux_basebackup -h mydbserver -D /home/uxdb/uxdbinstall/dbsql/data
要创建本地服务器的一个备份,为其中每一个表空间产生一个压缩过的tar文件,并且将它存储在目录backup
中,在运行期间显示一个进度报告:
$
ux_basebackup -D backup -Ft -z -P
要创建一个单一表空间本地数据库的备份并且使用bzip2压缩它:
$
ux_basebackup -D - -Ft -X fetch | bzip2 > backup.tar.bz2
(如果在该数据库中有多个表空间,这个命令将失败)。
要创建一个本地数据库的备份,其中/opt/ts
中的表空间被重定位到./backup/ts
:
$
ux_basebackup -D backup/data -T /opt/ts=$(pwd)/backup/ts