SHOW BACKUPS IN BACKUP SET

列出备份集中的所有 备份。

另请参阅：

CREATE BACKUP SET、ALTER BACKUP SET、SHOW BACKUP SETS

语法

SHOW BACKUPS IN BACKUP SET <name>
  [ LIMIT <rows> ]
Copy

参数

name

指定备份集的标识符。

如果标识符包含空格或特殊字符，则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。

有关更多信息，请参阅 标识符要求。

LIMIT rows

（可选）限制返回的最大行数，同时还对结果启用“分页”功能。返回的实际行数可能小于指定的限制。例如，现有对象的数量小于指定的限制。

默认：无值（不对输出应用限制）

访问控制要求

用于执行此操作的 角色 必须至少具有以下 权限：

权限

备注

OWNERSHIP

您必须拥有备份集的 OWNERSHIP 权限，才能查看其中包含的备份。

有关创建具有指定权限集的自定义角色的说明，请参阅 创建自定义角色。

有关对 安全对象 执行 SQL 操作的相应角色和权限授予的一般信息，请参阅 访问控制概述。

使用说明

  • 该命令 最多 返回指定对象类型的 1 万条记录，由用于执行命令的角色的访问权限决定。即使应用了筛选器，也不会返回任何超出 1 万条限制后的记录。

    要查看存在超过 1 万条记录的结果，请在 Snowflake Information Schema 中查询相应的视图（如果存在）。

输出

列

描述

created_on

备份创建时的时间戳。

backup_id

Snowflake 生成的备份标识符。备份 ID 是一个 UUID 值，其格式由 UUID_STRING 函数返回。

backup_set_name

包含该备份的备份集的名称。

database_name

包含该备份集的数据库的名称。

schema_name

包含该备份集的架构的名称。

expire_on

备份到期的时间戳。

示例

列出备份集 t1_backups 中的所有备份：

SHOW BACKUPS IN BACKUP SET t1_backups;
Copy

显示备份集 t1_backups 中最早备份的创建日期和备份 ID：

SHOW BACKUPS IN BACKUP SET t1_backups ->>
  SELECT "created_on", "backup_id" FROM $1
    ORDER BY "created_on" LIMIT 1;
Copy

显示备份 ID，以及备份集 t1_backups 中最后一个备份的到期日期和时间。此示例假定备份策略未包含计划，或该备份集的备份策略已被暂停，因此不会有新的备份添加到该备份集中。您只需等待所有现有备份到期，然后即可删除该备份集。

SHOW BACKUPS IN BACKUP SET t1_backups ->>
  SELECT "expire_on", "backup_id" FROM $1
    ORDER BY "expire_on" DESC LIMIT 1;
Copy
语言: 中文