全部产品
Search
文档中心

Lindorm:DESCRIBE

更新时间:Jun 24, 2025

Anda dapat menggunakan sintaks DESCRIBE untuk melihat skema tabel atau database yang sudah ada saat ingin membuat tabel atau database baru dengan skema serupa.

Mesin yang berlaku

Sintaks DESCRIBE berlaku untuk LindormTable dan LindormTSDB.

Sintaks

describe_statement ::= { DESCRIBE | DESC } [{ DATABASE | TABLE }] identifier

Parameter yang didukung

Tabel berikut menjelaskan parameter dari sintaks DESCRIBE yang didukung oleh LindormTable dan LindormTSDB.

Parameter

LindormTable

LindormTSDB

DATABASE

✖️

TABLE

identifier

Parameter

DATABASE

Hanya LindormTSDB yang mendukung parameter DATABASE.

Parameter DATABASE digunakan dalam sintaks DESCRIBE untuk memperoleh skema database.

TABLE

Parameter TABLE digunakan dalam sintaks DESCRIBE untuk memperoleh skema tabel. Perhatikan bahwa skema tabel yang dikembalikan untuk LindormTSDB dan LindormTable tidak persis sama.

identifier

Jika parameter DATABASE digunakan dalam pernyataan DESCRIBE, parameter identifier menentukan nama database secara default. Jika parameter TABLE digunakan dalam pernyataan DESCRIBE, parameter identifier menentukan nama tabel secara default. Jika parameter DATABASE dan TABLE tidak digunakan dalam pernyataan DESCRIBE, parameter identifier menentukan nama tabel secara default. Sebagai contoh, pernyataan berikut dapat dieksekusi untuk memperoleh skema tabel test di database saat ini: DESCRIBE test;

Contoh

Pada contoh berikut, tabel test bernama sensor dibuat dengan mengeksekusi pernyataan berikut:

CREATE TABLE sensor (
    device_id VARCHAR NOT NULL,
    region VARCHAR NOT NULL,
    time TIMESTAMP NOT NULL,
    temperature DOUBLE,
    humidity BIGINT,
    PRIMARY KEY(device_id, region, time)
);

Memperoleh skema tabel

DESCRIBE TABLE sensor; -- Pernyataan lengkap.
DESC sensor; -- Pernyataan singkat.

Hasil berikut dikembalikan untuk LindormTable:

+--------------+------------+-------------+-----------+----------------+------------+
| TABLE_SCHEMA | TABLE_NAME | COLUMN_NAME |   TYPE    | IS_PRIMARY_KEY | SORT_ORDER |
+--------------+------------+-------------+-----------+----------------+------------+
| default      | sensor     | device_id   | VARCHAR   | true           | ASC        |
| default      | sensor     | region      | VARCHAR   | true           | ASC        |
| default      | sensor     | time        | TIMESTAMP | true           | ASC        |
| default      | sensor     | temperature | DOUBLE    | false          | none       |
| default      | sensor     | humidity    | BIGINT    | false          | none       |
+--------------+------------+-------------+-----------+----------------+------------+

Hasil berikut dikembalikan untuk LindormTSDB:

+-------------+-----------+------------+------------+--------------+
| columnName  | typeName  | columnKind | primaryKey | partitionTag |
+-------------+-----------+------------+------------+--------------+
| device_id   | VARCHAR   | TAG        | true       | true         |
| region      | VARCHAR   | TAG        | true       | true         |
| time        | TIMESTAMP | TIMESTAMP  | true       | false        |
| temperature | DOUBLE    | FIELD      | false      | false        |
| humidity    | BIGINT    | FIELD      | false      | false        |
+-------------+-----------+------------+------------+--------------+

Memperoleh skema database

Memperoleh skema database seri waktu bernama DB1.

DESCRIBE DATABASE DB1;

Hasil berikut dikembalikan:

+--------------------+-------+
|     attribute      | value |
+--------------------+-------+
| shard_num_per_node | 0     |
| skip_wal           | false |
| string_compression | false |
| cold_boundary      | 30    |
| partition_interval | 30    |
| ttl                | 60    |
| shard_num          | 0     |
+--------------------+-------+

Berikut adalah bidang-bidang yang termasuk dalam hasil yang dikembalikan:

  • shard_num_per_node: Jumlah shard yang digunakan oleh database di setiap node. Nilai default: 1.

  • skip_wal: Menunjukkan apakah log dicatat. Nilai default dari bidang ini adalah false, yang menunjukkan bahwa log dicatat untuk database.

  • string_compression: Menunjukkan apakah data STRING dikompresi. Nilai default dari bidang ini adalah false, yang menunjukkan bahwa data STRING tidak dikompresi.

  • shard_num: Jumlah total shard database dalam kluster. Bidang ini tidak memiliki nilai default.

  • cold_boundary, partition_interval, dan ttl: Atribut database yang dikonfigurasi dalam pernyataan CREATE DATABASE yang dieksekusi untuk membuat database. Untuk informasi lebih lanjut, lihat CREATE DATABASE.