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() }
Copy

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 Guia Histórico 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);
      Copy

      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 o operador de canal (->>) ou a função RESULT_SCAN. Ambos os constructos tratam a saída como um conjunto de resultados que você pode consultar.

    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.

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

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    |
+-----------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+
Copy
Linguagem: Português