DESCRIBE RESULT¶
Beschreibt die Spalten im Ergebnis einer Abfrage.
Snowflake speichert das Ergebnis einer Abfrage für einen bestimmten Zeitraum, danach wird das Ergebnis gelöscht. Die Abfrage kann aus der aktuellen Sitzung oder einer Ihrer anderen Sitzungen, einschließlich vergangener Sitzungen, erfolgen, solange der befristete Zeitraum nicht abgelaufen ist. Dieser Zeitraum ist nicht veränderbar. Weitere Details dazu finden Sie unter Verwenden von persistent gespeicherten Abfrageergebnissen.
DESCRIBE kann mit DESC abgekürzt werden.
- Siehe auch:
LAST_QUERY_ID (Kontextfunktion), RESULT_SCAN (Tabellenfunktion)
Syntax¶
DESC[RIBE] RESULT { '<query_id>' | LAST_QUERY_ID() }
Parameter¶
query_idoderLAST_QUERY_ID()Gibt entweder die ID für eine Abfrage an, die Sie ausgeführt haben (innerhalb der letzten 24 Stunden in einer Sitzung), oder die Funktion LAST_QUERY_ID, die die ID für eine Abfrage innerhalb Ihrer aktuellen Sitzung zurückgibt.
Nutzungshinweise¶
Um die ID für eine bestimmte Abfrage abzurufen:
Suchen Sie die Abfrage-ID auf der Weboberfläche. Die Seite History
listet bei jeder Abfrage die ID mit auf. Beachten Sie jedoch, dass Sie diese Funktion nur für Abfragen verwenden können, die Sie ausgeführt haben.
Führen Sie die Tabellenfunktion QUERY_HISTORY , QUERY_HISTORY_BY_* aus, die eine Liste von Abfragen und deren IDs zurückgibt. Beachten Sie jedoch, dass Sie diese Funktion nur für Abfragen verwenden können, die Sie ausgeführt haben.
Wenn die Abfrage in der aktuellen Sitzung ausgeführt wurde, führen Sie die Funktion LAST_QUERY_ID aus. Beispiel:
SELECT LAST_QUERY_ID(-2);
Beachten Sie, dass dies der Verwendung von LAST_QUERY_ID() als Eingabe für DESC RESULT entspricht.
Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie den Befehl Pipe-Operator (
->>) oder die RESULT_SCAN-Funktion verwenden. Beide Konstrukte behandeln die Ausgabe als Resultset, das Sie abfragen können.Sie können zum Beispiel den Pipe-Operator oder die RESULT_SCAN-Funktion verwenden, um bestimmte Spalten aus der SHOW-Befehlsausgabe auszuwählen oder die Zeilen zu filtern.
Wenn Sie sich auf die Ausgabespalten beziehen, verwenden Sie Bezeichner mit doppelten Anführungszeichen für die Spaltennamen. Um beispielsweise die Ausgabespalte
typeauszuwählen, geben SieSELECT "type"an.Sie müssen Bezeichner in doppelten Anführungszeichen verwenden, da die Ausgabespaltennamen für SHOW-Befehle in Kleinbuchstaben geschrieben sind. Die doppelten Anführungszeichen stellen sicher, dass die Spaltennamen in der SELECT-Liste oder WHERE-Klausel den Spaltennamen in der SHOW-Befehlsausgabe entsprechen, die gescannt wurde.
Beispiele¶
Beschreiben Sie die Spalten im Ergebnis der angegebenen Abfrage aus einer Ihrer Sitzungen (innerhalb der letzten 24 Stunden):
DESC RESULT 'f2f07bdb-6a08-4689-9ad8-a1ba968a44b6';
Beschreiben Sie die Spalten in den Ergebnissen Ihrer letzten Abfrage in der aktuellen Sitzung:
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 | +-----------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+