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 的输入。

  • To post-process the output of this command, you can use the pipe operator (->>) or the RESULT_SCAN function. Both constructs treat the output as a result set that you can query.

    The output column names for this command are generated in lowercase. If you consume a result set from this command with the pipe operator or the RESULT_SCAN function, use double-quoted identifiers for the column names in the query to ensure that they match the column names in the output that was scanned. For example, if the name of an output column is type, then specify "type" for the identifier.

示例

描述来自任何会话（过去 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
语言: 中文