DESCRIBE RESULT

描述查询结果中的列。

Snowflake 将查询结果保留一段时间，之后将清除查询结果。查询可以来自当前会话或任何其他会话，包括过去的会话，只要未超过有限期限即可。此期限不可调整。有关更多详细信息，请参阅 使用持久化查询结果。

DESCRIBE 可以缩写为 DESC。

另请参阅：

LAST_QUERY_ID （上下文函数）、RESULT_SCAN （表函数）

语法

DESC[RIBE] RESULT { '<query_id>' | LAST_QUERY_ID() }

参数

query_id 或 LAST_QUERY_ID()

指定（过去 24 小时内在任意会话中）您执行的查询的 ID，或者 LAST_QUERY_ID 函数，该函数返回当前会话中的查询的 ID。

使用说明

  • 要检索特定查询的 ID，请执行以下操作：

    • 在 Web 界面中找到该查询 ID。History History 选项卡 页面列出了 ID 以及每个查询；但是，请注意，您只能对已执行的查询使用此函数。

    • 执行 QUERY_HISTORY、QUERY_HISTORY_BY_* 表函数，该函数返回查询及其 IDs 的列表；但是，请注意，您只能对已执行的查询使用此函数。

    • 如果查询是在当前会话中执行的，请执行 LAST_QUERY_ID 函数。例如：

      SELECT LAST_QUERY_ID(-2);

      请注意，这等同于将 LAST_QUERY_ID() 用作 DESC RESULT 的输入。

  • 要对该命令的输出进行后处理，可以使用 管道运算符 或 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.

示例

描述来自任何会话（过去 24 小时内）的指定查询结果中的列：

DESC RESULT 'f2f07bdb-6a08-4689-9ad8-a1ba968a44b6';

描述当前会话中最新查询的结果中的列：

SELECT * FROM boston_sales;

+---------------+-------+-------+--------+-------------+---------------------+-------+
| CITY          | ZIP   | STATE | SQ__FT | TYPE        | SALE_DATE           | PRICE |
|---------------+-------+-------+--------+-------------+---------------------+-------|
| MA-Lexington  | 40502 | MA    |    836 | Residential | 0016-01-25T00:00:00 | 59222 |
| MA-Belmont    | 02478 | MA    |    852 | Residential | 0016-02-21T00:00:00 | 69307 |
| MA-Winchester | 01890 | MA    |   1122 | Condo       | 0016-01-31T00:00:00 | 89921 |
+---------------+-------+-------+--------+-------------+---------------------+-------+

DESC RESULT LAST_QUERY_ID();

+-----------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+
| name      | type              | kind   | null? | default | primary key | unique key | check | expression | comment |
|-----------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------|
| CITY      | VARCHAR(16777216) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| ZIP       | VARCHAR(16777216) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| STATE     | VARCHAR(16777216) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| SQ__FT    | NUMBER(38,0)      | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| TYPE      | VARCHAR(16777216) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| SALE_DATE | DATE              | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| PRICE     | NUMBER(38,0)      | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
+-----------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+