getBackupStatus

New in version 1.30.20.

语法

getBackupStatus([userName])

参数

userName 表示用户名的字符串。

详情

查看指定用户的 backup/restore 任务。返回一个表,每一行为一个任务的信息。包含以下字段:

  • userName:用户名。

  • type:备份或恢复的类型。

  • BACKUP_BY_SQL/RESTORE_BY_SQL: 表示使用 SQL 元代码方式的备份/恢复。

  • BACKUP_BY_COPY_FILE/RESTORE_BY_COPY_FILE:表示使用拷贝文件方式的备份/恢复。

  • startTime:任务开始的时间。

  • dbName:数据库的路径。

  • tableName:表的名称。

  • totalPartitions:待备份/恢复的分区数量。

  • completedPartitions:完成备份/恢复的分区数量。

  • percentComplete:任务完成百分比。

  • endTime:若任务已完成,则返回任务完成的时间,否则返回预估完成时间。

  • completed :任务完成状态。若全部完成,则为1,否则为0。

注意:

  • 一次 backup 执行过程产生的任务数与其备份的分区的个数相同。

  • 管理员调用该函数时,若指定了 userName,则返回指定用户的 backup/restore 任务;否则返回所有用户的 backup/restore 任务。

  • 非管理员调用该函数时,只能返回当前用户的 backup/restore 任务。

例子

$ getBackupStatus()

userName type

startTime

dbName

tableName

totalPartitions

completedPartitions

percentComplete

endTime | completed

u1

BACKUP_BY_COPY_FILE 2022.09.21T17:18:04.264

dfs://valuedb

pt

1

1

100

2022.09.21T17:18:04.269 | 1

u1

BACKUP 2022.09.21T17:13:04.344

dfs://valuedb

pt

4

4

100

2022.09.21T17:13:04.413

1

u1

BACKUP_BY_COPY_FILE 2022.09.21T17:18:04.264

dfs://valuedb

pt1

1

1

100

2022.09.21T17:18:04.265

1

admin

BACKUP_BY_COPY_FILE 2022.09.21T16:47:42.798

dfs://valuedb

pt

4

4

100

2022.09.21T16:47:42.859

1

admin

BACKUP_BY_COPY_FILE 2022.09.21T16:37:33.725

dfs://valuedb

pt

4

4

100

2022.09.21T16:37:33.790

1

admin

BACKUP 2022.09.21T15:10:05.016

dfs://compoDB

pt2

10

10

100

2022.09.21T15:10:05.075

1