SHOW SNAPSHOT SETS¶

列出您拥有访问权限的所有快照集。此命令的作用范围可以是您的整个账户，也可以是指定的数据库或架构。

语法¶

SHOW SNAPSHOT SETS
   [ LIKE '<pattern>' ]
   [ IN { ACCOUNT | DATABASE | DATABASE <db_name> | SCHEMA | SCHEMA <schema_name> } ]

Copy

LIKE 'pattern'

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

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

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

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

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

[ IN { ACCOUNT | DATABASE | DATABASE db_name | SCHEMA | SCHEMA schema_name } ]

如果您指定关键字 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，那么：
- 如果当前有数据库，那么：
  - 如果当前存在架构，则该命令将检索当前数据库中当前架构的记录。
  - 如果不存在当前架构，则该命令将检索当前数据库中所有架构的记录。
- 如果当前没有数据库，则该命令将检索账户中所有数据库和所有架构的记录。

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

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

列	描述
`created_on`	创建快照集的时间戳。
`name`	快照集的名称。
`database_name`	包含快照集的数据库的名称。
`schema_name`	包含快照集的架构的名称。
`object_kind`	快照集正在拍摄快照的对象的类型。
`object_name`	快照集正在拍摄快照的对象的名称。
`object_database_name`	包含该快照集为其拍摄快照的对象的数据库的名称。
`object_schema_name`	包含该快照集为其拍摄快照的对象的架构的名称。
`snapshot_policy_name`	附加到此快照集的快照策略的名称。
`snapshot_policy_database_name`	包含快照策略的数据库的名称。
`snapshot_policy_schema_name`	包含快照策略的架构的名称。
`comment`	快照集的注释。
`owner`	具有快照集 OWNERSHIP 权限的角色的名称。
`owner_role_type`	具有快照集 OWNERSHIP 权限的角色类型。

列出当前账户中您有权限的所有快照集：

SHOW SNAPSHOT SETS IN ACCOUNT;

Copy

列出名称中包含 T1 的快照集：

SHOW SNAPSHOT SETS LIKE '%T1%';

Copy