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
ouLAST_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
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 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.Os nomes das colunas de saída para este comando são gerados em minúsculas. Se você consumir um conjunto de resultados deste comando com o operador de canal ou a função RESULT_SCAN, use identificadores entre aspas duplas para os nomes das colunas na consulta para garantir que eles correspondam aos nomes das colunas na saída que foi verificada. Por exemplo, se o nome de uma coluna de saída for
type
, especifique"type"
para o identificador.
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 | +-----------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+