SHOW BACKUP POLICIES¶

语法¶

SHOW BACKUP POLICIES
   [ LIKE '<pattern>' ]
   [ IN { ACCOUNT | DATABASE | DATABASE <db_name> | SCHEMA | SCHEMA <schema_name> }
     [ STARTS WITH '<name_string>' ]
     [ LIMIT <rows> ]
   ]

参数¶

LIKE 'pattern'

（可选）按对象名称筛选命令输出。筛选器使用 不区分大小写 的模式匹配，并支持 SQL 通配符（% 和 _）。

例如，以下模式返回 相同的 结果：

... LIKE '%testing%' ...

... LIKE '%TESTING%' ...

. 默认：无值（不对输出应用筛选）。

[ IN ... ]

（可选）指定命令的作用域。指定以下任一项：

如果您指定关键字 ACCOUNT，则该命令将检索当前账户的所有数据库中所有架构的记录。

如果您指定关键字 DATABASE，那么：

• 如果指定 db_name，则该命令将检索指定数据库的所有架构的记录。

• 如果没有指定 db_name，那么：

  • 如果存在当前数据库，则该命令将检索当前数据库中所有架构的记录。

  • 如果当前没有数据库，则该命令将检索账户中所有数据库和架构的记录。

如果您指定关键字 SCHEMA，那么：

• 如果指定了限定架构名称（例如，my_database.my_schema），则该命令将检索指定数据库和架构的记录。

• 如果您指定了未限定的 schema_name，那么：

  • 如果存在当前数据库，则该命令将检索当前数据库中指定架构的记录。

  • 如果当前没有数据库，则该命令会显示错误 SQL compilation error: Object does not exist, or operation cannot be performed。

• 如果没有指定 schema_name，那么：

  • 如果当前有数据库，那么：

    • 如果当前存在架构，则该命令将检索当前数据库中当前架构的记录。

    • 如果不存在当前架构，则该命令将检索当前数据库中所有架构的记录。

  • 如果当前没有数据库，则该命令将检索账户中所有数据库和所有架构的记录。

STARTS WITH 'name_string'

（可选）根据对象名称开头显示的字符筛选命令输出。该字符串必须放在单引号内并且 区分大小写。

例如，以下字符串会返回 不同的 结果：

... STARTS WITH 'B' ...

... STARTS WITH 'b' ...

. 默认：无值（不对输出应用筛选）

LIMIT rows

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

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

使用说明¶

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

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

要判断某个备份策略是否关联了任何备份集，请使用 SHOW BACKUP SETS 命令。

输出¶

示例¶

列出当前账户中您有权限访问的所有备份策略：

SHOW BACKUP POLICIES IN ACCOUNT;