クエリを説明する
説明
DESCRIBE QUERYステートメントは、クエリの出力のメタデータを返します。省略形DESCを使用して、クエリ出力を説明できます。DESCRIBEの代わりに。
構文
{ DESC | DESCRIBE } [ QUERY ] input_statement
パラメーター
-
QUERYこの句はオプションで、省略できます。
-
input_statement
結果セットを生成するステートメントを指定し、次のいずれかになります
SELECTステートメントCTE（共通テーブル式）ステートメントINLINE TABLEステートメントTABLEステートメントFROMステートメント
クエリパラメーターの詳細な構文については、select-statementを参照してください。
例
-- Create table `person`
CREATE TABLE person (name STRING , age INT COMMENT 'Age column', address STRING);
-- Returns column metadata information for a simple select query
DESCRIBE QUERY SELECT age, sum(age) FROM person GROUP BY age;
+--------+---------+----------+
|col_name|data_type| comment|
+--------+---------+----------+
| age| int|Age column|
|sum(age)| bigint| null|
+--------+---------+----------+
-- Returns column metadata information for common table expression (`CTE`).
DESCRIBE QUERY WITH all_names_cte
AS (SELECT name from person) SELECT * FROM all_names_cte;
+--------+---------+-------+
|col_name|data_type|comment|
+--------+---------+-------+
| name| string| null|
+--------+---------+-------+
-- Returns column metadata information for an inline table.
DESC QUERY VALUES(100, 'John', 10000.20D) AS employee(id, name, salary);
+--------+---------+-------+
|col_name|data_type|comment|
+--------+---------+-------+
| id| int| null|
| name| string| null|
| salary| double| null|
+--------+---------+-------+
-- Returns column metadata information for `TABLE` statement.
DESC QUERY TABLE person;
+--------+---------+----------+
|col_name|data_type| comment|
+--------+---------+----------+
| name| string| null|
| age| int| Agecolumn|
| address| string| null|
+--------+---------+----------+
-- Returns column metadata information for a `FROM` statement.
-- `QUERY` clause is optional and can be omitted.
DESCRIBE FROM person SELECT age;
+--------+---------+----------+
|col_name|data_type| comment|
+--------+---------+----------+
| age| int| Agecolumn|
+--------+---------+----------+