DESCRIBE RESULT

Descreve as colunas no resultado de uma consulta.

O Snowflake persiste o resultado de uma consulta durante um período de tempo, após o qual o resultado é limpo. A consulta pode ser da sessão atual ou de qualquer outra sessão, incluindo sessões passadas, desde que o período limitado não tenha transcorrido. Este período não é ajustável. Para obter mais detalhes, consulte Uso de resultados de consultas persistentes.

DESCRIBE pode ser abreviado como DESC.

Consulte também:

LAST_QUERY_ID (Função de contexto) , RESULT_SCAN (Função de tabela)

Sintaxe

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

Parâmetros

query_id ou LAST_QUERY_ID()

Especifica a ID para uma consulta executada (dentro das últimas 24 horas em qualquer sessão) ou a função LAST_QUERY_ID, que retorna a ID para uma consulta dentro de sua sessão atual.

Notas de uso

  • Para recuperar a ID para uma consulta específica:

    • Localize a ID de consulta na interface da web. A página History History tab lista a ID junto com cada consulta; no entanto, observe que você só pode usar esta função para consultas que tenha executado.

    • Execute a função de tabela QUERY_HISTORY , QUERY_HISTORY_BY_*, que retorna uma lista de consultas e suas IDs; no entanto, observe que você só pode usar esta função para consultas que você tenha executado.

    • Se a consulta foi executada na sessão atual, execute a função LAST_QUERY_ID. Por exemplo:

      SELECT LAST_QUERY_ID(-2);
      

      Note que isto é equivalente a usar LAST_QUERY_ID() como a entrada para DESC RESULT.

  • Para pós-processar a saída deste comando, você pode usar a função RESULT_SCAN, que trata a saída como uma tabela que pode ser consultada.

Exemplos

Descreva as colunas no resultado da consulta especificada de qualquer uma de suas sessões (dentro das 24 horas anteriores):

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

Descreva as colunas nos resultados de sua consulta mais recente na sessão atual:

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    |
+-----------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+