DESCRIBE ICEBERG TABLE

描述 Apache Iceberg™ 表 中的列或 Iceberg 表属性的当前值和默认值。

DESCRIBE 可以缩写为 DESC。

请注意，本主题将 Iceberg 表简称为“表”，除非指定 Iceberg 表 以避免混淆。

另请参阅：

ALTER ICEBERG TABLE、DROP ICEBERG TABLE、CREATE ICEBERG TABLE、SHOW ICEBERG TABLES

语法

DESC[RIBE] [ ICEBERG ] TABLE <name> [ TYPE =  { COLUMNS | STAGE } ]
Copy

参数

name

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

TYPE = COLUMNS | STAGE

指定是显示表的列，还是显示表的暂存属性（包括其当前值和默认值）。

默认：TYPE = COLUMNS

访问控制要求

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

权限

对象

备注

SELECT

Iceberg 表

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

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

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

使用说明

  • 此命令不显示表的对象参数。请改用 SHOW PARAMETERS IN TABLE。

  • DESC ICEBERG TABLE、DESCRIBE TABLE 和 DESCRIBE VIEW 是可互换的。这些命令中的任何一条都可以检索与语句中的条件相匹配的表或视图的详细信息；但是 TYPE = STAGE 不适用于视图，因为该视图没有暂存属性。

  • 输出包括一个 POLICY NAME 列，用于指示在列上设置的 掩码策略。

    如果未在该列上设置掩码策略，或者 Snowflake 账户不是 Enterprise Edition 或更高版本，Snowflake 将返回 NULL。

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

示例

创建一个 Iceberg 表示例：

CREATE OR REPLACE ICEBERG TABLE my_iceberg_table
  CATALOG='my_catalog_integration'
  EXTERNAL_VOLUME='my_ext_volume'
  METADATA_FILE_PATH='path/to/metadata/v2.metadata.json';
Copy

描述表中的列：

DESC ICEBERG TABLE my_iceberg_table ;
Copy
语言: 中文