DESCRIBE STORAGE LIFECYCLE POLICY

描述 存储生命周期策略 的属性。

DESCRIBE 可以缩写为 DESC。

另请参阅：

CREATE STORAGE LIFECYCLE POLICY、ALTER STORAGE LIFECYCLE POLICY、DROP STORAGE LIFECYCLE POLICY、SHOW STORAGE LIFECYCLE POLICIES

语法

{ DESC | DESCRIBE } STORAGE LIFECYCLE POLICY <policy_name>
Copy

参数

policy_name

指定要描述的策略的标识符。

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

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

输出

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

列

描述

name

策略的名称。

signature

该策略用于评估行是否过期的列。

return_type

包含返回值的数据类型的 VARCHAR 值。例如，BOOLEAN、NUMBER、ARRAY 和 OBJECT。

body

用于评估行是否应过期的函数主体。

archive_tier

归档存储层；COOL 或 COLD。

archive_for_days

过期前将表行归档的（可选）天数。如果未设置此属性，则值为 NULL。

访问控制要求

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

权限

对象

备注

APPLY STORAGE LIFECYCLE POLICY

账户

允许对账户中的所有存储生命周期策略执行 DESC 操作。

APPLY

存储生命周期策略

允许对存储生命周期策略执行 DESC 操作。

OWNERSHIP

存储生命周期策略

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 权限。请注意，如果某个角色获授某个架构的任意权限，该角色便能够解析该架构。例如，若某角色被授予 CREATE 权限，则可以在该架构上创建对象，而无需 同时 被授予该架构的 USAGE 权限。

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

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

使用说明

  • 要对该命令的输出进行后处理，可以使用 管道运算符 (->>) 或 RESULT_SCAN 函数。这两种构造都将输出视为可以查询的结果集。

    For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

    When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

    You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.

  • 如果您曾经为策略启用过归档存储，则该命令输出中的 archive_tier 属性会显示归档层（COOL 或 COLD）已设置。即使您使用 ALTER STORAGE LIFECYCLE POLICY 取消设置 ARCHIVE_FOR_DAYS 参数，将归档策略转换为过期策略，情况也是如此。归档层设置后无法更改。

示例

以下示例描述了名为 my_storage_lifecycle_policy 的存储生命周期策略：

DESCRIBE STORAGE LIFECYCLE POLICY example_slp;
Copy

输出：

+-----------------------------+----------------+-------------+------+------------------+
| name                        | signature      | return_type | body | archive_for_days |
|-----------------------------+----------------+-------------+------+------------------|
| MY_STORAGE_LIFECYCLE_POLICY | (ARG1 BOOLEAN) | BOOLEAN     | arg1 |              365 |
+-----------------------------+----------------+-------------+------+------------------+
语言: 中文