DESCRIBE RESULT

描述查询结果中的列。

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

DESCRIBE 可以缩写为 DESC。

另请参阅：

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

语法

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

参数

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);
      Copy

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

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

示例

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

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

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

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    |
+-----------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+
Copy
语言: 中文