Skip to content

mo_br 备份与恢复

数据库物理备份和快照备份是两种重要的数据保护策略,它们在很多场景下都发挥着重要的作用。物理备份通过复制数据库的物理文件,如数据文件和日志文件,能够实现快速和完整的数据库恢复,特别适合于数据库整体迁移或灾难恢复的情况。另一方面,快照备份通过记录数据在特定时间点的状态,提供了一种快速且存储效率高的备份方式,适用于需要进行时间点恢复或只读查询操作的场景,如生成报告或进行数据分析。物理备份的恢复可能需要较长时间,而快照备份则可以提供快速的数据访问,两者结合使用,可以为数据库提供全面的保护,确保数据的安全性和业务的连续性。

MatrixOne 支持通过 mo_br 实用工具进行常规物理备份和快照备份。本章节将介绍 mo_br 的使用方法。

Note

mo_br 企业级服务的物理备份与恢复工具,你需要联系你的 MatrixOne 客户经理,获取工具下载路径。

参考命令指南

help - 打印参考指南

./mo_br help
the backup and restore tool for the matrixone

Usage:
  mo_br [flags]
  mo_br [command]

Available Commands:
  backup      backup the matrixone data
  check       check the backup
  completion  Generate the autocompletion script for the specified shell
  delete      delete the backup
  help        Help about any command
  list        search the backup
  restore     restore the matrixone data
  snapshot    Manage snapshots

Flags:
      --config string      config file (default "./mo_br.toml")
  -h, --help               help for mo_br
      --log_file string    log file (default "console")
      --log_level string   log level (default "error")

Use "mo_br [command] --help" for more information about a command.

物理备份

创建备份

语法结构

mo_br backup
    --host
    --port 
    --user 
    --password 
    --backup_dir s3|filesystem 
        //s3 oss minio
            --endpoint
            --access_key_id 
            --secret_access_key 
            --bucket 
            --filepath
            --region 
            --compression 
            --role_arn 
            --is_minio
            --parallelism 
        //filesystem
            --path
            --parallelism
    --meta_path 
    //增量备份需要
    --backup_type
    --base_id

参数说明

参数 说明
host 目标 MatrixOne 的 IP
port 端口号
user 用户
password 用户的密码
backup_dir 备份的目标路径类型。s3 或 filesystem
endpoint 连接到备份到 s3 的服务的 URL
access_key_id 备份到 s3 的 Access key ID
secret_access_key 备份到 s3 的 Secret access key
bucket 备份到的 s3 需要访问的桶
filepath 备份到 s3 的相对文件路径
region 备份到 s3 的对象存储服务区域
compression 备份到 s3 的文件的压缩格式。
role_arn 备份到 s3 的角色的资源名称。
is_minio 指定备份到的 s3 是否为 minio
path 本地文件系统备份路径
parallelism 并行度
meta_path 指定 meta 文件位置。只能是文件系统中的路径。如果不指定,默认是同一目录下的 mo_br.meta 文件。
backup_type 指定备份类型为增量备份,incremental。
base_id 上次一次备份的 ID,主要用于确定上次备份的时间戳。

示例

  • 全量备份到本地文件系统
./mo_br backup --host "127.0.0.1" --port 6001 --user "root" --password "111" --backup_dir "filesystem"  --path "yourpath"
  • 全量备份到 minio
./mo_br backup --host "127.0.0.1" --port 6001 --user "root" --password "111" --backup_dir "s3"  --endpoint "http://127.0.0.1:9000" --access_key_id "S0kwLuB4JofVEIAxWTqf" --secret_access_key "X24O7t3hccmqUZqvqvmLN8464E2Nbr0DWOu9Qs5A" --bucket "bucket1" --filepath "/backup1" --is_minio
  • 增量备份到本地文件系统
./mo_br backup --host "127.0.0.1" --port 6001 --user "root" --password "111" --backup_dir "filesystem"  --path "yourpath" --backup_type "incremental" --base_id "xxx"

查看备份

语法结构

mo_br list
    -- ID
    //要查询备份数据。如果备份在s3(oss minio)上时,需要指定
      --access_key_id 
      --secret_access_key 
    --not_check_data 
    --meta_path 

参数说明

参数 说明
ID 备份的 ID
access_key_id 备份到的 s3 的 Access key ID
secret_access_key 备份到的 s3 的 Secret access key
not_check_data 只查看 meta 中的信息。不查看备份数据。默认不带这个参数的,就是会检查备份的文件。当前只会检查备份的文件是否存在。
meta_path 指定 meta 文件位置。如果不指定,默认是同一目录下的 mo_br.meta 文件。

示例

  • 查看所有备份列表
./mo_br list
+--------------------------------------+--------+--------------------------------+---------------------------+--------------+---------------------------+
|                  ID                  |  SIZE  |              PATH              |          AT TIME          |   DURATION   |       COMPLETE TIME       |
+--------------------------------------+--------+--------------------------------+---------------------------+--------------+---------------------------+
| 4d21b228-10dd-11ef-9497-26dd28356ef2 | 586 kB |  BackupDir: filesystem  Path:  | 2024-05-13 12:00:12 +0800 | 1.700945333s | 2024-05-13 12:00:13 +0800 |
|                                      |        |    /Users/admin/soft/backup    |                           |              |                           |
| 01108122-10f9-11ef-9359-26dd28356ef2 | 8.3 MB |  BackupDir: filesystem  Path:  | 2024-05-13 15:18:28 +0800 | 3.394437375s | 2024-05-13 15:18:32 +0800 |
|                                      |        |    /Users/admin/soft/backup    |                           |              |                           |
+--------------------------------------+--------+--------------------------------+---------------------------+--------------+---------------------------+
  • 查看指定 ID 备份列表,list 确定的 ID 时,会检测备份的文件。
./mo_br list 4d21b228-10dd-11ef-9497-26dd28356ef2
+--------------------------------------+--------+--------------------------------+---------------------------+--------------+---------------------------+
|                  ID                  |  SIZE  |              PATH              |          AT TIME          |   DURATION   |       COMPLETE TIME       |
+--------------------------------------+--------+--------------------------------+---------------------------+--------------+---------------------------+
| 4d21b228-10dd-11ef-9497-26dd28356ef2 | 586 kB |  BackupDir: filesystem  Path:  | 2024-05-13 12:00:12 +0800 | 1.700945333s | 2024-05-13 12:00:13 +0800 |
|                                      |        |    /Users/admin/soft/backup    |                           |              |                           |
+--------------------------------------+--------+--------------------------------+---------------------------+--------------+---------------------------+

Checking the backup data(currently,no checksum)...

check: /backup_meta
check: /mo_meta
check: hakeeper/hk_data
check: tae/tae_list
check: tae/tae_sum
check: config/log.toml_018f70d1-3100-7762-b28b-8f85ac4ed3cd
check: config/tn.toml_018f70d1-310e-78fc-ac96-aa5e06981bd7
...

删除备份

语法结构

mo_br delete ID  
    //要删除备份数据。如果备份在s3(oss minio)上时,需要指定
      --access_key_id 
      --secret_access_key
    --not_delete_data
    --meta_path

参数说明

参数 说明
ID 要删除的备份的 ID
access_key_id 备份到的 s3 的 Access key ID
secret_access_key 备份到的 s3 的 Secret access key
not_delete_data 只删除 meta 中的信息。不删除备份数据。
meta_path 指定 meta 文件位置。如果不指定,默认是同一目录下的 mo_br.meta 文件。

示例

  • 删除本地文件系统备份
./mo_br delete e4cade26-3139-11ee-8631-acde48001122
  • 删除 minio 上的一个备份。
./mo_br delete e4cade26-3139-11ee-8631-acde48001122 --access_key_id "S0kwLuB4JofVEIAxWTqf" --secret_access_key "X24O7t3hccmqUZqvqvmLN8464E2Nbr0DWOu9Qs5A"

恢复备份

语法结构

  • 恢复指定 ID 的备份
mo_br restore ID
    //读取指定ID的备份数据。如果备份在s3(oss minio)上时,需要指定
    --backup_access_key_id
    --backup_secret_access_key 

    //恢复的目标路径 restore_directory
    --restore_dir s3|filesystem 
        //s3 
            --restore_endpoint 
            --restore_access_key_id 
            --restore_secret_access_key 
            --restore_bucket 
            --restore_filepath 
            --restore_region 
            --restore_compression 
            --restore_role_arn 
            --restore_is_minio
        //filesystem
            --restore_path 
            --dn_config_path 
    --meta_path 
    --checksum
    --parallelism 

参数说明

参数 说明
ID 要恢复的 ID
backup_access_key_id 备份在 s3 的 Access key ID
backup_secret_access_key 备份在 s3 的 Secret access key
restore_dir 恢复的目标路径类型。指定恢复的目标路径时使用。s3
restore_endpoint 连接到恢复到 S3 服务的 URL
restore_access_key_id 恢复到 s3 的 Access key ID
restore_secret_access_key 恢复到 s3 的 Secret access key
restore_bucket 恢复到 s3 需要访问的桶
restore_filepath 恢复到 s3 的相对文件路径
restore_region 恢复到 s3 的对象存储服务区域
restore_compression 恢复到 s3 的 S3 文件的压缩格式。
restore_role_arn 恢复到 s3 的角色的资源名称。
restore_is_minio 指定恢复到的 s3 是否是 minio
restore_path 恢复到本地的路径
dn_config_path dn 配置路径
meta_path 指定 meta 文件位置。只能是文件系统中的路径。如果不指定,默认是同一目录下的 mo_br.meta 文件。
checksum 恢复的时候 tae 文件复制的并行度,默认是 1
parallelism 并行度
  • 不指定恢复备份 ID
//恢复。
mo_br restore
    --backup_dir s3|filesystem 备份的目标路径类型。指定备份的目标路径时使用。
        //s3 
            --backup_endpoint 
            --backup_access_key_id 
            --backup_secret_access_key
            --backup_bucket
            --backup_filepath
            --backup_region 
            --backup_compression 
            --backup_role_arn 
            --backup_is_minio
        //filesystem
            --backup_path 
    //恢复的目标路径 restore_directory
    --restore_dir s3|filesystem 恢复的目标路径类型。指定恢复的目标路径时使用。
        //s3 
            --restore_endpoint 
            --restore_access_key_id 
            --restore_secret_access_key 
            --restore_bucket 
            --restore_filepath
            --restore_region 
            --restore_compression 
            --restore_role_arn 
            --restore_is_minio
        //filesystem
            --restore_path 
            --dn_config_path 
    --meta_path 
    --checksum
    --parallelism

参数说明

参数 说明
backup_dir 恢复的目标路径类型。指定恢复的目标路径时使用。s3
backup_endpoint 连接到备份在 s3 的的 URL
backup_access_key_id 备份在 s3 的 Access key ID
backup_secret_access_key 备份在 s3 的 Secret access key
backup_bucket 备份在 s3 的桶
backup_filepath 备份在 s3 的相对文件路径
backup_region 备份在 s3 的服务区域
backup_compression 备份在 s3 的文件的压缩格式。
backup_role_arn 备份在 s3 的角色的资源名称。
backup_is_minio 指定备份的 s3 是否是 minio
backup_path 本地备份的路径
restore_dir 恢复的目标路径类型。指定恢复的目标路径时使用。s3 或 filesystem
restore_endpoint 连接到恢复到 S3 服务的 URL
restore_access_key_id 恢复到 s3 的 Access key ID
restore_secret_access_key 恢复到 s3 的 Secret access key
restore_bucket 恢复到 s3 需要访问的桶
restore_filepath 恢复到 s3 的相对文件路径
restore_region 恢复到 s3 的对象存储服务区域
restore_compression 恢复到 s3 的 S3 文件的压缩格式。
restore_role_arn 恢复到 s3 的角色的资源名称。
restore_is_minio 指定恢复到的 s3 是否是 minio
restore_path 恢复到本地 matrixone 的路径
dn_config_path dn 配置路径
meta_path 指定 meta 文件位置。只能是文件系统中的路径。如果不指定,默认是同一目录下的 mo_br.meta 文件。
checksum 恢复的时候 tae 文件复制的并行度,默认是 1
parallelism 并行度

示例

从文件系统恢复到文件系统

步骤一:停止 mo,删除 mo-data

步骤二:执行以下恢复命令

./mo_br restore fb26fd88-41bc-11ee-93f8-acde48001122 --restore_dir filesystem --restore_path "your_mopath"

恢复后会在 matrixone 生成新的 mo-data 文件

步骤三:启动 mo

校验备份的校验码

读取备份文件夹中的每个文件及其 sha256 文件。计算文件的 sha256 值并与 sha256 文件值对比。sha256 文件是在文件创建或更新时,创建的。

语法结构

  • 校验某个 ID 的备份
mo_br check ID
    //校验指定ID的备份数据。如果备份在s3(oss minio)上时,需要指定
      --backup_access_key_id string
      --backup_secret_access_key string
    --meta_path string 指定meta文件位置。如果不指定,默认是同一目录下的mo_br.meta文件。

参数说明

参数 说明
backup_access_key_id 备份在 s3 的 Access key ID
backup_secret_access_key 备份在 s3 的 Secret access key
meta_path 指定 meta 文件位置。只能是文件系统中的路径。如果不指定,默认是同一目录下的 mo_br.meta 文件。
  • 校验备份,指定备份的 path
mo_br check
    --backup_dir s3|filesystem 
        //s3 
            --backup_endpoint
            --backup_access_key_id
            --backup_secret_access_key 
            --backup_bucket
            --backup_filepath 
            --backup_region 
            --backup_compression
            --backup_role_arn 
            --backup_is_minio
        //filesystem
            --backup_path
    --meta_path 

参数说明

参数 说明
backup_dir 备份所在的路径类型,在没有指定 ID 时,必须要指定。s3 或 filesystem
backup_endpoint 连接到备份在 s3 的的 URL
backup_access_key_id 备份在 s3 的 Access key ID
backup_secret_access_key 备份在 s3 的 Secret access key
backup_bucket 备份在 s3 的桶
backup_filepath 备份在 s3 的相对文件路径
backup_region 备份在 s3 的服务区域
backup_compression 备份在 s3 的文件的压缩格式。
backup_role_arn 备份在 s3 的角色的资源名称。
backup_is_minio 指定备份的 s3 是否是 minio
backup_path 本地备份的路径
meta_path 指定 meta 文件位置。只能是文件系统中的路径。如果不指定,默认是同一目录下的 mo_br.meta 文件。

示例

  • 校验某个 ID 的备份
./mo_br check  1614f462-126c-11ef-9af3-26dd28356ef3
+--------------------------------------+--------+-----------------------------------+---------------------------+---------------+---------------------------+
|                  ID                  |  SIZE  |               PATH                |          AT TIME          |   DURATION    |       COMPLETE TIME       |
+--------------------------------------+--------+-----------------------------------+---------------------------+---------------+---------------------------+
| 1614f462-126c-11ef-9af3-26dd28356ef3 | 126 MB |   BackupDir: filesystem  Path:    | 2024-05-15 11:34:28 +0800 | 22.455633916s | 2024-05-15 11:34:50 +0800 |
|                                      |        | /Users/admin/soft/incbackup/back2 |                           |               |                           |
+--------------------------------------+--------+-----------------------------------+---------------------------+---------------+---------------------------+

Checking the backup data...

check: /backup_meta
check: /mo_meta
check: hakeeper/hk_data
check: tae/tae_list
check: tae/tae_sum
check: config/launch.toml_018f7a50-d300-7017-8580-150edf08733e
...
  • 校验某个备份目录中的备份
(base) admin@admindeMacBook-Pro mo-backup % ./mo_br check --backup_dir filesystem --backup_path /Users/admin/soft/incbackup/back2
2024/05/15 11:40:30.011160 +0800 INFO malloc/malloc.go:42 malloc {"max buffer size": 1073741824, "num shards": 16, "classes": 23, "min class size": 128, "max class size": 1048576, "buffer objects per class": 23}
check: /backup_meta
check: /mo_meta
check: hakeeper/hk_data
check: tae/tae_list
check: tae/tae_sum
check: config/launch.toml_018f7a50-d300-7017-8580-150edf08733e
check: config/log.toml_018f7a50-d30c-7ed0-85bc-191e9f1eb753
...

快照备份

创建快照

语法结构

mo_br snapshot create
    --host
    --port 
    --user
    --password 
    --level 
    --account 
    --sname 

参数说明

参数 说明
host 目标 MatrixOne 的 IP
port 端口号
user 用户
password 用户的密码
level 快照备份的范围,account
account 快照备份的租户对象名,cluster 级别无需填写此参数
sname 快照名称

示例

  • 集群管理员创建集群级别快照:
./mo_br snapshot create --host "127.0.0.1" --port 6001 --user "root" --password "111" --level "cluster" --sname "cluster_sp1"
  • 系统租户管理员为系统租户 sys 创建租户级别快照:
./mo_br snapshot create --host "127.0.0.1" --port 6001 --user "root" --password "111" --level "account" --sname "snapshot_01" --account "sys"
  • 系统租户管理员为普通租户 acc1 创建租户级别快照:
 ./mo_br snapshot create --host "127.0.0.1" --port 6001 --user "root" --password "111" --level "account" --sname "snapshot_02" --account "acc1" 
  • 普通租户管理员创建租户级别快照:

    • 创建普通租户 acc1
    create account acc1 admin_name admin IDENTIFIED BY '111';
    
    • acc1 创建快照
    ./mo_br snapshot create  --host "127.0.0.1" --port 6001 --user "acc1#admin" --password "111" --level "account" --account "acc1" --sname "snapshot_03"
    

查看快照

语法结构

mo_br snapshot show
    --host
    --port 
    --user 
    --password 
    --cluster
    --account 
    --db 
    --table 
    --sname 
    --beginTs 
    --endTs

参数说明

参数 说明
host 目标 MatrixOne 的 IP
port 端口号
user 用户
password 用户的密码
cluster 固定填写 sys,其他值不生效,仅 sys 管理员使用
account 要筛选的租户名,仅限 sys 管理员使用
db 要筛选的数据库名
table 要筛选的表名
sname 要筛选的快照名称
beginTs 要筛选的快照时间戳的开始时间
endTs 要筛选的快照时间戳的结束时间

示例

  • 查看系统租户管理员下创建的快照:
./mo_br snapshot show --host "127.0.0.1" --port 6001 --user "root" --password "111"
SNAPSHOT NAME           TIMESTAMP           SNAPSHOT LEVEL  ACCOUNT NAME    DATABASE NAME   TABLE NAME 
snapshot_02     2024-05-11 02:29:23.07401   account         acc1                                        
snapshot_01     2024-05-11 02:26:03.462462  account         sys  
  • 查看普通租户管理员在 acc1 下创建的快照:
./mo_br snapshot show --host "127.0.0.1" --port 6001 --user "acc1#admin" --password "111"
SNAPSHOT NAME           TIMESTAMP           SNAPSHOT LEVEL  ACCOUNT NAME    DATABASE NAME   TABLE NAME 
snapshot_03     2024-05-11 02:29:31.572512  account         acc1     
  • 查看系统租户管理员下为租户 acc1 创建的快照,并对开始时间进行筛选:
./mo_br snapshot show --host "127.0.0.1" --port 6001 --user "root" --password "111" --account "acc1" --beginTs "2024-05-11 00:00:00"     
SNAPSHOT NAME           TIMESTAMP           SNAPSHOT LEVEL  ACCOUNT NAME    DATABASE NAME   TABLE NAME 
snapshot_02     2024-05-11 02:29:23.07401   account         acc1 

删除快照

语法结构

mo_br snapshot drop
    --host
    --port 
    --user 
    --password 
    --sname 

参数说明

参数 说明
host 目标 MatrixOne 的 IP
port 端口号
user 用户
password 用户的密码
sname 要筛选的快照名称

示例

  • 删除系统管理员创建的快照:
./mo_br snapshot drop --host "127.0.0.1" --port 6001 --user "root" --password "111" --sname "snapshot_01"
  • 删除普通租户管理员创建的快照:
./mo_br snapshot drop --host "127.0.0.1" --port 6001 --user "acc1#admin" --password "111" --sname "snapshot_03" 

恢复快照

语法结构

mo_br snapshot restore
    --host 
    --port 
    --user 
    --password 
    --sname 
    --account 
    --db 
    --table 
    --newaccount 
    --newaccountadmin 
    --newaccountpwd 

参数说明

参数 说明
host 目标 MatrixOne 的 IP
port 端口号
user 用户
password 用户的密码
sname 要恢复的快照名称
account 要恢复的租户名,仅限 sys 管理员使用
db 要恢复的数据库名
table 要恢复的表名
newaccount 新创建的租户名
newaccountadmin 租户管理员
newaccountpwd 租户管理员密码

NOTE: 只有系统租户才可以执行恢复数据到新租户,且只允许租户级别的恢复。

示例

  • 表级别恢复
./mo_br snapshot restore --host "127.0.0.1" --port 6001 --user "root" --password "111" --account "sys" --db "snapshot_read" --table "test_snapshot_read" --sname "sp_01"
  • 数据库级别恢复
./mo_br snapshot restore --host "127.0.0.1" --port 6001 --user "root" --password "111" --account "sys" --db "snapshot_read" --sname "sp_02"
  • 租户级别恢复到本租户
./mo_br snapshot restore --host "127.0.0.1" --port 6001 --user "root" --password "111" --account "sys" --sname "sp_03"
  • 租户级别恢复到新租户
./mo_br snapshot restore --host "127.0.0.1" --port 6001 --user "root" --password "111" --account "sys" --sname "sp_03" --new_account "acc2" --new_admin_name "admin" --new_admin_password "111";
  • 集群级别恢复
./mo_br snapshot restore --host "127.0.0.1" --port 6001 --user "root" --password "111"  --sname "cluster_sp1"

PITR 备份

创建 PITR

语法结构

mo_br pitr create 
    --host
    --port 
    --user 
    --password 
    --pname 
    --level 
    --account 
    --database 
    --table 
    --rangevalue 
    --rangeunit 

参数说明

参数 说明
host 目标 MatrixOne 的 IP
port 端口号
user 用户
password 用户的密码
pname pitr 名字
level 备份的范围,cluster
account 备份的租户名
database 备份的租数据库名
table 备份的表名
rangevalue 时间范围值,1-100
rangeunit 时间范围单位,可选范围 h(小时)、d(天,默认)、mo(月)、y(年)

示例

  • 集群级别

只有系统租户才能创建集群级别的 pitr。

./mo_br pitr create --host "127.0.0.1" --port 6001 --user "root" --password "111" --pname "pitr01" --level "cluster" --rangevalue 10 --rangeunit "h"
  • 租户级别

系统租户可以为自己和其它租户创建租户级别的 pitr。

./mo_br pitr create --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr02" --level "account" --account "sys" --rangevalue 1 --rangeunit "d"

mo create account acc01 admin_name = 'test_account' identified by '111';
mo create account acc02 admin_name = 'test_account' identified by '111';

./mo_br pitr create --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr015" --level "account" --account "acc01" --rangevalue 1 --rangeunit "y"

./mo_br pitr create --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr016" --level "account" --account "acc02" --rangevalue 1 --rangeunit "y"

普通租户只能为自己创建租户级别的 pitr。

./mo_br pitr create --host "127.0.0.1" --port 6001 --user "acc01#test_account" --password "111" --pname "pitr07" --level "account" --account "acc01" --rangevalue 1 --rangeunit "h"
  • 数据库级别
./mo_br pitr create --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr011" --level "database" --account "sys" --database "abc" --rangevalue 1 --rangeunit "y"
  • 表级别
./mo_br pitr create --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr011" --level "database" --account "sys" --database "abc" --rangevalue 1 --rangeunit "y"

查看 PITR

语法结构

mo_br pitr show
    --hostname 
    --port 
    --user 
    --password 
    --cluster 
    --account 
    --database 
    --table 

参数说明

参数 说明
host 目标 MatrixOne 的 IP
port 端口号
user 用户
password 用户的密码
pname pitr 名字
cluster 固定填写 sys,其他值不生效,仅 sys 管理员使用
account 备份的租户名
database 备份的租数据库名
table 备份的表名

示例

  • 查看所有 pitr
./mo_br pitr show --host "127.0.0.1" --port 6001 --user "dump" --password "111" 
PITR NAME      CREATED TIME        MODIFIED TIME    PITR LEVEL  ACCOUNT NAME    DATABASE NAME   TABLE NAME  PITR LENGTH PITR UNIT 
pitr016     2024-08-08 06:55:40 2024-08-08 06:55:40 account     acc02           *               *                     1 y           
pitr015     2024-08-08 06:55:04 2024-08-08 06:55:04 account     acc01           *               *                     1 y           
pitr012     2024-08-08 06:52:30 2024-08-08 06:52:30 table       sys             abc             test                  1 y           
pitr011     2024-08-08 06:50:43 2024-08-08 06:50:43 database    sys             abc             *                     1 y           
pitr05      2024-08-08 06:45:56 2024-08-08 06:45:56 account     sys             *               *                     1 y           
pitr04      2024-08-08 06:45:52 2024-08-08 06:45:52 account     sys             *               *                     1 mo          
pitr03      2024-08-08 06:45:42 2024-08-08 06:45:42 account     sys             *               *                     1 d           
pitr02      2024-08-08 06:45:25 2024-08-08 06:45:25 account     sys             *               *                     1 h           
pitr01      2024-08-08 06:32:31 2024-08-08 06:32:31 cluster     *               *               *                    10 h  
  • 查看集群级别 pitr
./mo_br pitr show --host "127.0.0.1" --port 6001 --user "dump" --password "111"  --cluster "sys"
PITR NAME      CREATED TIME        MODIFIED TIME    PITR LEVEL  ACCOUNT NAME    DATABASE NAME   TABLE NAME  PITR LENGTH PITR UNIT 
pitr01      2024-08-08 06:32:31 2024-08-08 06:32:31 cluster     *               *               *                    10 h 
  • 查看租户级别 pitr
./mo_br pitr show --host "127.0.0.1" --port 6001 --user "dump" --password "111"  --account "sys"
PITR NAME      CREATED TIME        MODIFIED TIME    PITR LEVEL  ACCOUNT NAME    DATABASE NAME   TABLE NAME  PITR LENGTH PITR UNIT 
pitr012     2024-08-08 06:52:30 2024-08-08 06:52:30 table       sys             abc             test                  1 y           
pitr011     2024-08-08 06:50:43 2024-08-08 06:50:43 database    sys             abc             *                     1 y           
pitr05      2024-08-08 06:45:56 2024-08-08 06:45:56 account     sys             *               *                     1 y           
pitr04      2024-08-08 06:45:52 2024-08-08 06:45:52 account     sys             *               *                     1 mo          
pitr03      2024-08-08 06:45:42 2024-08-08 06:45:42 account     sys             *               *                     1 d           
pitr02      2024-08-08 06:45:25 2024-08-08 06:45:25 account     sys             *               *                     1 h   
  • 查看数据库级别 pitr
./mo_br pitr show --host "127.0.0.1" --port 6001 --user "dump" --password "111"  --account "sys" --database "abc"
PITR NAME      CREATED TIME        MODIFIED TIME    PITR LEVEL  ACCOUNT NAME    DATABASE NAME   TABLE NAME  PITR LENGTH PITR UNIT 
pitr012     2024-08-08 06:52:30 2024-08-08 06:52:30 table       sys             abc             test                  1 y           
pitr011     2024-08-08 06:50:43 2024-08-08 06:50:43 database    sys             abc             *                     1 y     
  • 查看表级别 pitr
 ./mo_br pitr show --host "127.0.0.1" --port 6001 --user "dump" --password "111"  --account "sys" --database "abc" --table "test"
PITR NAME      CREATED TIME        MODIFIED TIME    PITR LEVEL  ACCOUNT NAME    DATABASE NAME   TABLE NAME  PITR LENGTH PITR UNIT 
pitr012     2024-08-08 06:52:30 2024-08-08 06:52:30 table       sys             abc             test                  1 y          

更改 PITR

语法结构

mo_br pitr alter
    --host
    --port 
    --user 
    --password 
    --pname 
    --rangevalue
    --rangeunit 

参数说明

参数 说明
host 目标 MatrixOne 的 IP
port 端口号
user 用户
password 用户的密码
pname pitr 名字
rangevalue 时间范围值,1-100
rangeunit 时间范围单位,可选范围 h(小时)、d(天,默认)、mo(月)、y(年)

示例

./mo_br pitr alter --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr01" --rangevalue 10 --rangeunit "d"
 ./mo_br pitr show --host "127.0.0.1" --port 6001 --user "dump" --password "111"  --cluster "sys"
PITR NAME      CREATED TIME        MODIFIED TIME    PITR LEVEL  ACCOUNT NAME    DATABASE NAME   TABLE NAME  PITR LENGTH PITR UNIT 
pitr01      2024-08-08 06:32:31 2024-08-08 07:31:06 cluster     *               *               *                    10 d    

恢复 PITR

语法结构

mo_br pitr restore
    --host string 集群 IP
    --port int 集群端口号
    --user string 用户名
    --password 用户密码
    //要恢复的对象名
    --cluster 恢复整个集群,仅限集群管理员使用,固定填写 sys,该字段填写后,只需填写 --timestamp
    --account 要筛选的租户名,仅限集群管理员使用
    --database 要筛选的数据库名
    --table 要筛选的表名
    //要恢复的时间
    --timestamp
    //创建并恢复到新租户
    --new_account string 新创建的租户名
    --new_admin_name string 租户管理员
    --new_admin_password string 租户管理员密码

参数说明

参数 说明
host 目标 MatrixOne 的 IP
port 端口号
user 用户
password 用户的密码
cluster 恢复整个集群,仅限集群管理员使用,固定填写 sys,该字段填写后,只需填写 --timestamp
account 要筛选的租户名,仅限集群管理员使用
database 要筛选的数据库名
table 要筛选的表名
timestamp 要恢复的时间
new_account 要恢复的时间
new_admin_name 创建并恢复到新租户,新创建的租户名
new_admin_password 租户管理员
timestamp 租户管理员密码

示例

  • 系统租户

    #集群级别
    ./mo_br pitr create --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr01" --level "cluster" --rangevalue 10 --rangeunit "h"
    
    ./mo_br pitr restore --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr01" --cluster "sys" --timestamp "2024-08-08 15:42:20.249966"
    
    #租户级别
    ./mo_br pitr create --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr100" --level "account" --account "sys" --rangevalue 10 --rangeunit "h"
    ##用 account pitr 恢复 account
    ./mo_br pitr restore --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr100" --timestamp "2024-08-08 15:47:15.216472" --account "sys"
    ##用 account pitr 恢复 db
    ./mo_br pitr restore --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr100" --timestamp "2024-08-08 15:47:15.216472" --account "sys" --database "abc"
    ##用 account pitr 恢复 table 
    ./mo_br pitr restore --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr100" --timestamp "2024-08-08 15:47:15.216472" --account "sys" --database "abc" --table "test"
    
    #数据库级别
    ./mo_br pitr create --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr101" --level "database" --account "sys" --database "abc" --rangevalue 10 --rangeunit "h"
    ##用 db pitr 恢复 db
    ./mo_br pitr restore --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr101" --timestamp "2024-08-08 15:56:18.610295" --account "sys" --database "abc"
    ##用 db pitr 恢复 table
    ./mo_br pitr restore --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr101" --timestamp "2024-08-08 15:56:18.610295" --account "sys" --database "abc" --table "test"
    
    #表级别
    ./mo_br pitr create --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr102" --level "table" --account "sys" --database "abc" --table "test" --rangevalue 10 --rangeunit "h"
    ##用 table pitr 恢复 table
    ./mo_br pitr restore --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr102" --timestamp "2024-08-08 16:00:41.433477" --account "sys" --database "abc" --table "test"
    
  • 普通租户

    #租户级别
    ./mo_br pitr create --host "127.0.0.1" --port 6001 --user "acc01#test_account"  --password "111" --pname "pitr200" --level "account" --account "acc01" --rangevalue 10 --rangeunit "h"
    ##用 account pitr 恢复 account
    ./mo_br pitr restore --host "127.0.0.1" --port 6001 --user "acc01#test_account" --password "111" --pname "pitr200" --timestamp "2024-08-08 16:04:17.276521" --account "acc01"
    ##用 account pitr 恢复 db
    ./mo_br pitr restore --host "127.0.0.1" --port 6001 --user "acc01#test_account" --password "111" --pname "pitr200" --timestamp "2024-08-08 16:04:17.276521" --account "acc01" --database "abc"
    ##用 account pitr 恢复 table
    ./mo_br pitr restore --host "127.0.0.1" --port 6001 --user "acc01#test_account" --password "111" --pname "pitr200" --timestamp "2024-08-08 16:04:17.276521" --account "acc01" --database "abc" --table "test"
    
    #数据库级别
    ./mo_br pitr create --host "127.0.0.1" --port 6001 --user "acc01#test_account"  --password "111" --pname "pitr201" --level "database" --account "acc01" --database "abc" --rangevalue 10 --rangeunit "h"
    ##用 db pitr 恢复 db
    ./mo_br pitr restore --host "127.0.0.1" --port 6001 --user "acc01#test_account" --password "111" --pname "pitr201" --timestamp "2024-08-08 16:06:50.374948" --account "acc01" --database "abc"
    ##用 db pitr 恢复 table
    ./mo_br pitr restore --host "127.0.0.1" --port 6001 --user "acc01#test_account" --password "111" --pname "pitr201" --timestamp "2024-08-08 16:06:50.374948" --account "acc01" --database "abc" --table "test"
    
    #表级别
    ./mo_br pitr create --host "127.0.0.1" --port 6001 --user "acc01#test_account"  --password "111" --pname "pitr202" --level "table" --account "acc01" --database "abc" --table "test" --rangevalue 10 --rangeunit "h"
    ##用 table pitr 恢复 table
    ./mo_br pitr restore --host "127.0.0.1" --port 6001 --user "acc01#test_account" --password "111" --pname "pitr202" --timestamp "2024-08-08 16:06:50.374948" --account "acc01" --database "abc" --table "test"
    
    #系统租户给普通租户创建 pitr 并恢复普通租户
    
    ./mo_br pitr create --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr300" --level "account" --account "acc01" --rangevalue 1 --rangeunit "y"
    
    ./mo_br pitr restore --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr300" --timestamp "2024-08-08 16:09:17.035136" --account "acc01"
    
    #系统租户将普通租户恢复到新租户
    ./mo_br pitr restore --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr300" --timestamp "2024-08-08 16:09:17.035136" --account "acc03" --new_account "acc03"  --new_admin_name "test_account" --new_admin_password "111"
    

删除 PITR

语法结构

mo_br pitr drop
    --host
    --port 
    --user 
    --password 
    --pname

参数说明

参数 说明
host 目标 MatrixOne 的 IP
port 端口号
user 用户
password 用户的密码
pname pitr 名字

示例

./mo_br pitr drop  --host "127.0.0.1" --port 6001 --user "dump" --password "111" --pname "pitr01"