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 }] identifierParameter yang didukung
Tabel berikut menjelaskan parameter dari sintaks DESCRIBE yang didukung oleh LindormTable dan LindormTSDB.
Parameter | LindormTable | LindormTSDB |
✖️ | 〇 | |
〇 | 〇 | |
〇 | 〇 |
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 DATABASEyang dieksekusi untuk membuat database. Untuk informasi lebih lanjut, lihat CREATE DATABASE.