Версия: 2.0.x

DESC

DESC используется для просмотра схем таблиц:

Просмотр схемы таблицы, хранящейся в вашем Selena cluster, вместе с типом sort key и materialized view таблицы.
Просмотр схемы таблицы, хранящейся в следующих внешних источниках данных, таких как Apache Hive™. Обратите внимание, что вы можете выполнить эту операцию только в Selena 2.4 и более поздних версиях.

Синтаксис

DESC[RIBE] { [[<catalog_name>.]<db_name>.]<table_name> [ALL] | FILES(files_loading_properties) }

Параметры

Параметр	Обязательный	Описание
catalog_name	Нет	Имя внутреннего catalog или внешнего catalog. Если вы установите значение параметра равным имени внутреннего catalog, которым является `default_catalog`, вы можете просмотреть схему таблицы, хранящейся в вашем Selena cluster. Если вы установите значение параметра равным имени внешнего catalog, вы можете просмотреть схему таблицы, хранящейся во внешнем источнике данных.
db_name	Нет	Имя базы данных.
table_name	Да	Имя таблицы.
ALL	Нет	Если это ключевое слово указано, вы можете просмотреть тип sort key, materialized view и схему таблицы, хранящейся в вашем Selena cluster. Если это ключевое слово не указано, вы просматриваете только схему таблицы. Не указывайте это ключевое слово при просмотре схемы таблицы, хранящейся во внешнем источнике данных.
FILES	Нет	Табличная функция FILES(). Начиная с версии 3.3.4, вы можете использовать DESC с FILES() для просмотра информации о схеме файлов, хранящихся в удалённом хранилище. Подробную информацию см. в Справочнике функций - FILES().

Вывод

+-----------+---------------+-------+------+------+-----+---------+-------+
| IndexName | IndexKeysType | Field | Type | Null | Key | Default | Extra |
+-----------+---------------+-------+------+------+-----+---------+-------+

В следующей таблице описаны параметры, возвращаемые этим оператором.

Параметр	Описание
IndexName	Имя таблицы. Если вы просматриваете схему таблицы, хранящейся во внешнем источнике данных, этот параметр не возвращается.
IndexKeysType	Тип sort key таблицы. Если вы просматриваете схему таблицы, хранящейся во внешнем источнике данных, этот параметр не возвращается.
Field	Имя столбца.
Type	Тип данных столбца.
Null	Могут ли значения столбца быть NULL. `yes`: указывает, что значения могут быть NULL. `no`: указывает, что значения не могут быть NULL.
Key	Используется ли столбец в качестве sort key. `true`: указывает, что столбец используется в качестве sort key. `false`: указывает, что столбец не используется в качестве sort key.
Default	Значение по умолчанию для типа данных столбца. Если тип данных не имеет значения по умолчанию, возвращается NULL.
Extra	Если вы просматриваете схему таблицы, хранящейся в вашем Selena cluster, это поле отображает следующую информацию о столбце: Агрегатная функция, используемая столбцом, такая как `SUM` и `MIN`. Создан ли bloom filter index для столбца. Если да, значение `Extra` будет `BLOOM_FILTER`. Если вы просматриваете схему таблицы, хранящейся во внешних источниках данных, это поле отображает, является ли столбец partition column. Если столбец является partition column, значение `Extra` будет `partition key`.

Примечание: Для информации о том, как materialized view отображается в выводе, см. Пример 2.

Примеры

Пример 1: Просмотр схемы example_table, хранящейся в вашем Selena cluster.

DESC example_table;

Или

DESC default_catalog.example_db.example_table;

Вывод предыдущих операторов следующий.

+-------+---------------+------+-------+---------+-------+
| Field | Type          | Null | Key   | Default | Extra |
+-------+---------------+------+-------+---------+-------+
| k1    | TINYINT       | Yes  | true  | NULL    |       |
| k2    | DECIMAL(10,2) | Yes  | true  | 10.5    |       |
| k3    | CHAR(10)      | Yes  | false | NULL    |       |
| v1    | INT           | Yes  | false | NULL    |       |
+-------+---------------+------+-------+---------+-------+

Пример 2: Просмотр схемы, типа sort key и materialized view таблицы sales_records, хранящейся в вашем Selena cluster. В следующем примере одна materialized view store_amt создана на основе sales_records.

DESC db1.sales_records ALL;

+---------------+---------------+-----------+--------+------+-------+---------+-------+
| IndexName     | IndexKeysType | Field     | Type   | Null | Key   | Default | Extra |
+---------------+---------------+-----------+--------+------+-------+---------+-------+
| sales_records | DUP_KEYS      | record_id | INT    | Yes  | true  | NULL    |       |
|               |               | seller_id | INT    | Yes  | true  | NULL    |       |
|               |               | store_id  | INT    | Yes  | true  | NULL    |       |
|               |               | sale_date | DATE   | Yes  | false | NULL    | NONE  |
|               |               | sale_amt  | BIGINT | Yes  | false | NULL    | NONE  |
|               |               |           |        |      |       |         |       |
| store_amt     | AGG_KEYS      | store_id  | INT    | Yes  | true  | NULL    |       |
|               |               | sale_amt  | BIGINT | Yes  | false | NULL    | SUM   |
+---------------+---------------+-----------+--------+------+-------+---------+-------+

Пример 3: Просмотр схемы hive_table, хранящейся в вашем Hive cluster.

DESC hive_catalog.hive_db.hive_table;

+-------+----------------+------+-------+---------+---------------+
| Field | Type           | Null | Key   | Default | Extra         |
+-------+----------------+------+-------+---------+---------------+
| id    | INT            | Yes  | false | NULL    |               |
| name  | VARCHAR(65533) | Yes  | false | NULL    |               |
| date  | DATE           | Yes  | false | NULL    | partition key |
+-------+----------------+------+-------+---------+---------------+

Пример 4: Просмотр схемы parquet файла lineorder, хранящегося в AWS S3.

ПРИМЕЧАНИЕ

Для файлов, хранящихся в удалённом хранилище, DESC возвращает только три поля: Field, Type и Null.

DESC FILES(
    "path" = "s3://inserttest/lineorder.parquet",
    "format" = "parquet",
    "aws.s3.access_key" = "AAAAAAAAAAAAAAAAAAAA",
    "aws.s3.secret_key" = "BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB",
    "aws.s3.region" = "us-west-2"
);

+------------------+------------------+------+
| Field            | Type             | Null |
+------------------+------------------+------+
| lo_orderkey      | int              | YES  |
| lo_linenumber    | int              | YES  |
| lo_custkey       | int              | YES  |
| lo_partkey       | int              | YES  |
| lo_suppkey       | int              | YES  |
| lo_orderdate     | int              | YES  |
| lo_orderpriority | varchar(1048576) | YES  |
| lo_shippriority  | int              | YES  |
| lo_quantity      | int              | YES  |
| lo_extendedprice | int              | YES  |
| lo_ordtotalprice | int              | YES  |
| lo_discount      | int              | YES  |
| lo_revenue       | int              | YES  |
| lo_supplycost    | int              | YES  |
| lo_tax           | int              | YES  |
| lo_commitdate    | int              | YES  |
| lo_shipmode      | varchar(1048576) | YES  |
+------------------+------------------+------+
17 rows in set (0.05 sec)

Синтаксис​

Параметры​

Вывод​

Примеры​

Ссылки​

Синтаксис

Параметры

Вывод

Примеры

Ссылки