DESCRIBE SNAPSHOT

描述 快照 的属性。

DESCRIBE 可以缩写为 DESC。

另请参阅：

CREATE SNAPSHOT、ALTER SNAPSHOT、DROP SNAPSHOT、SHOW SNAPSHOTS

语法

{ DESC | DESCRIBE } SNAPSHOT <name>
Copy

参数

name

指定要描述的快照的标识符。

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

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

输出

命令的输出包括以下列，它们描述了对象的属性和元数据：

列

描述

name

快照的名称。

state

快照状态（例如，CREATED）。

database_name

在其中创建快照的数据库。

schema_name

在其中创建快照的架构。

service_name

从中创建快照的完全限定的服务名称。

volume_name

为其创建快照的指定服务实例中的卷。

instance

服务实例的 ID。

size

快照的大小（以 GB 为单位）。

comment

关于快照的常规注释。

owner

拥有快照的角色。

owner_role_type

拥有对象的角色类型是 ROLE 或 DATABASE_ROLE。

created_on

快照的创建日期和时间。

访问控制要求

用于执行此 SQL 命令的 角色 必须至少具有以下 权限：

权限

对象

备注

OWNERSHIP 或 USAGE

快照

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

请注意，对架构中的对象进行操作还需要对父数据库和架构具有 USAGE 权限。

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

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

使用说明

  • 若要对此命令的输出进行后处理，可以使用 RESULT_SCAN 函数，该函数会将输出视为可查询的表。

示例

以下示例描述了名为 my_snapshot 的快照：

DESC SNAPSHOT my_snapshot;
Copy

输出：

+-------------+---------+---------------+-------------+------------------------------------+-------------+----------+------+-----------------+-----------+-----------------+-------------------------------+-------------------------------+
| name        | state   | database_name | schema_name | service_name                       | volume_name | instance | size | comment         | owner     | owner_role_type | created_on                    | updated_on                    |
|-------------+---------+---------------+-------------+------------------------------------+-------------+----------+------+-----------------+-----------+-----------------+-------------------------------+-------------------------------|
| MY_SNAPSHOT | CREATED | TUTORIAL_DB   | DATA_SCHEMA | TUTORIAL_DB.DATA_SCHEMA.MY_SERVICE | block-vol1  | 0        |   10 | updated comment | TEST_ROLE | ROLE            | 2023-12-13 17:06:04.162 -0800 | 2023-12-13 17:06:56.303 -0800 |
+-------------+---------+---------------+-------------+------------------------------------+-------------+----------+------+-----------------+-----------+-----------------+-------------------------------+-------------------------------+
语言: 中文