Lindorm：CREATE TABLE

Nama tabel (table_identifier)

Perhatikan hal-hal berikut saat menentukan nama tabel:

• Nama dapat berisi angka, huruf besar, huruf kecil, titik (.), tanda hubung (-), dan garis bawah (_).

• Nama tidak boleh diawali dengan titik (.) atau tanda hubung (-).

• Panjang nama harus antara 1 hingga 255 karakter.

Definisi kolom (column_definition)

Kunci utama (primary_key)

Kunci primer adalah pengidentifikasi unik untuk data dalam sebuah tabel. Kunci primer terdiri dari satu atau beberapa kolom. Anda harus menentukan kunci primer (PRIMARY KEY) saat membuat tabel.

Saat menggunakan pernyataan CREATE TABLE untuk membuat tabel, perhatikan hal-hal berikut:

Ekspresi indeks (KEY|INDEX)

Saat menggunakan pernyataan CREATE TABLE untuk membuat tabel indeks, Anda dapat menggunakan kata kunci KEY atau INDEX guna menentukan indeks yang akan dibuat.

Partisi (partition_definition)

Partisi hanya didukung oleh LindormTSDB. Pada tabel deret waktu, kolom yang digunakan untuk PARTITION BY harus berupa kolom VARCHAR dalam definisi kunci primer.

Saat membuat tabel, Anda dapat menggunakan pernyataan PARTITION BY HASH(column1, column2, ..., columnN) untuk secara eksplisit menentukan satu atau beberapa kolom guna melakukan partisi hash pada tabel. Contohnya: PARTITION BY HASH(c1, p1).

Properti tabel (table_options)

Hanya mesin tabel lebar yang mendukung properti tabel (table_options). Anda dapat menggunakan kata kunci WITH untuk menambahkan properti tabel berikut:

Buat tabel

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)
);

Verifikasi hasil

Anda dapat menjalankan DESCRIBE table sensor; untuk memeriksa apakah tabel berhasil dibuat.

Buat indeks saat membuat tabel

Buat indeks sekunder saat membuat tabel.

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

Verifikasi hasil

Anda dapat menjalankan DESCRIBE table sensor; untuk memeriksa apakah tabel berhasil dibuat, dan menjalankan SHOW INDEX FROM sensor; untuk memeriksa apakah secondary index berhasil dibuat.

Tentukan TTL dan algoritma kompresi

Saat membuat tabel lebar, atur TTL menjadi 30 hari (2.592.000 detik) dan algoritma kompresi menjadi ZSTD.

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)
) WITH (COMPRESSION='ZSTD', TTL='2592000');

Verifikasi hasil

• Anda dapat menjalankan DESCRIBE table sensor; untuk memeriksa apakah tabel berhasil dibuat.

• Pada halaman Overview sistem manajemen kluster, klik nama tabel target di bawah database target. Di area Current Details Table, klik View Table Properties untuk melihat nilai parameter COMPRESSION dan TTL.

Tentukan periode Major Compaction

Saat membuat tabel lebar, atur periode Major Compaction menjadi 10 hari (864.000.000 milidetik).

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)
) WITH (COMPACTION_MAJOR_PERIOD='864000000');

Verifikasi hasil

• Anda dapat menjalankan DESCRIBE table sensor; untuk memeriksa apakah tabel berhasil dibuat.

• Pada halaman Overview sistem manajemen kluster, klik nama tabel target di bawah database target. Di area Current Details Table, klik View Table Properties untuk melihat nilai parameter COMPACTION_MAJOR_PERIOD.

Aktifkan fitur kolom dinamis

Setelah menetapkan parameter DYNAMIC_COLUMNS ke TRUE saat membuat tabel lebar, Anda dapat menulis data kolom dinamis ke tabel tersebut.

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)
) WITH (DYNAMIC_COLUMNS='TRUE');

Verifikasi hasil

• Anda dapat menjalankan DESCRIBE table sensor; untuk memeriksa apakah tabel berhasil dibuat.

• Pada halaman Overview sistem manajemen kluster, klik nama tabel target di bawah database target. Di area Current Details Table, klik View Table Properties untuk melihat nilai parameter DYNAMIC_COLUMNS.

Tentukan batas data panas dan dingin

Saat membuat tabel lebar, atur batas data panas dan dingin. Sistem akan mengarsipkan data berdasarkan batas ini.

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)
) WITH (CHS = '86400', CHS_L2 = 'storagetype=COLD');

Verifikasi hasil

• Anda dapat menjalankan DESCRIBE table sensor; untuk memeriksa apakah tabel berhasil dibuat.

• Pada halaman Overview sistem manajemen kluster, klik nama tabel target di bawah database target. Di area Current Details Table, klik View Table Properties untuk melihat nilai parameter CHS dan CHS_L2.

Tentukan beberapa properti sekaligus

Saat membuat tabel lebar, tentukan algoritma kompresi, TTL, dan batas data panas dan dingin.

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)
) WITH (
    COMPRESSION='ZSTD', 
    CHS = '86400', 
    CHS_L2 = 'storagetype=COLD', 
    TTL = '2592000');

Verifikasi hasil

• Anda dapat menjalankan DESCRIBE table sensor; untuk memeriksa apakah tabel berhasil dibuat.

• Pada halaman Overview sistem manajemen kluster, klik nama tabel target di database target. Di area Current Details Table, klik View Table Properties untuk melihat nilai parameter COMPRESSION, CHS, CHS_L2, dan TTL.

Atur partisi

Saat membuat tabel lebar, Anda dapat menentukan lima partisi sebelumnya. Kunci awal untuk partisi-partisi ini adalah 1.000 dan kunci akhirnya adalah 9.000.

CREATE TABLE sensor (
  p1 INTEGER NOT NULL, 
  c1 INTEGER, 
  c2 VARCHAR, 
  c3 VARCHAR,
  PRIMARY KEY(p1)
) WITH (NUMREGIONS='5', STARTKEY='1000', ENDKEY='9000');

Verifikasi hasil

• Anda dapat menjalankan DESCRIBE table sensor; untuk memeriksa apakah tabel berhasil dibuat.

• Pada halaman Overview sistem manajemen kluster, klik nama tabel target di bawah database target. Di area Shard Details, lihat nilai parameter startKey dan endKey untuk setiap shard.

Tentukan kunci awal untuk beberapa partisi

Saat membuat tabel lebar, Anda dapat menentukan lima kunci awal sebelumnya. Tabel tersebut kemudian akan dibuat dengan enam partisi secara default.

CREATE TABLE sensor (
  p1 INT NOT NULL,
  p2 INT NOT NULL,
  c1 VARCHAR,
  c2 BIGINT,
  PRIMARY KEY(p1, p2)
) WITH (SPLITKEYS = '100000,300000,500000,700000,900000');

Verifikasi hasil

• Anda dapat menjalankan DESCRIBE table sensor; untuk memverifikasi bahwa tabel berhasil dibuat.

• Pada halaman Overview sistem manajemen kluster, klik nama tabel target di database target. Di area Shard Details, lihat nilai parameter startKey dan endKey untuk setiap shard.

Tentukan secara eksplisit kolom kunci partisi

Sebagian besar skenario kueri melibatkan kueri data instan dari satu perangkat. Untuk skenario ini, Anda dapat menentukan secara eksplisit device_id sebagai kolom kunci partisi untuk pemartisian data.

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)
) PARTITION BY HASH(device_id);

Verifikasi hasil

Anda dapat menjalankan pernyataan DESCRIBE TABLE sensor; untuk memverifikasi hasil pembuatan tabel.

Buat tabel data spatio-temporal

• Buat tabel yang mendukung tipe data spasial apa pun (Geometry). Anda dapat menulis data dengan tipe data spasial apa pun ke tabel tersebut.

  CREATE TABLE geoms(gid INT, g GEOMETRY, PRIMARY KEY(gid));

  Tulis data dengan tipe data spasial apa pun.

  UPSERT INTO geoms(gid, g) VALUES(0,ST_GeomFromText('POINT(-10.1 3.3)')),(1,ST_GeomFromText('LINESTRING(-12.2 4.3, -10.2 4.3)')),(2,ST_GeomFromText('POLYGON((2 2, 2 8, 8 8, 8 2, 2 2))'));

• Buat tabel yang mendukung tipe Point. Anda hanya dapat menulis data titik ke tabel tersebut.

  CREATE TABLE pts(gid INT, g GEOMETRY(POINT), PRIMARY KEY(gid));

  Tulis data titik.

  UPSERT INTO pts(gid, g) VALUES(0, ST_MakePoint(0,0)),(1, ST_MakePoint(1,1));

• Buat tabel yang mendukung tipe Polygon. Anda hanya dapat menulis data poligon ke tabel tersebut.

  CREATE TABLE polys(gid INT, g GEOMETRY(POLYGON), PRIMARY KEY(gid));

  Tulis data poligon.

  UPSERT INTO polys(gid,g) VALUES(0,ST_GeomFromText('POLYGON((2 2, 2 8, 8 8, 8 2, 2 2))'));

• Buat tabel yang mendukung tipe LineString. Anda hanya dapat menulis data garis ke tabel tersebut.

  CREATE TABLE lines(gid INT, g GEOMETRY(LINESTRING), PRIMARY KEY(gid));

  Tulis data garis.

  UPSERT INTO lines(gid,g) VALUES(0, ST_GeomFromText('LINESTRING(-12.2 4.3, -10.2 4.3)'));

• Buat tabel yang mendukung tipe MULTIPOINT. Anda hanya dapat menulis data multipoint ke tabel tersebut.

  CREATE TABLE multipoints(gid INT, g GEOMETRY(MULTIPOINT), PRIMARY KEY(gid));

  Tulis data multipoint.

  UPSERT INTO multipoints(gid,g) VALUES(0, ST_GeomFromText('MULTIPOINT (10 40, 40 30, 20 20, 30 10)'));

• Buat tabel yang mendukung tipe MULTILINESTRING. Anda hanya dapat menulis data multilinestring ke tabel tersebut.

  CREATE TABLE multilines(gid INT, g GEOMETRY(MULTILINESTRING), PRIMARY KEY(gid));

  Tulis data multilinestring.

  UPSERT INTO multilines(gid,g) VALUES(0, ST_GeomFromText('MULTILINESTRING ((10 10, 20 20, 10 40),(40 40, 30 30, 40 20, 30 10))'));

• Buat tabel yang mendukung tipe MULTIPOLYGON. Anda hanya dapat menulis data multipolygon ke tabel tersebut.

  CREATE TABLE multipolys(gid INT, g GEOMETRY(MULTIPOLYGON), PRIMARY KEY(gid));

  Tulis data multipolygon.

  UPSERT INTO multipolys(gid,g) VALUES(0, ST_GeomFromText('MULTIPOLYGON (((30 20, 45 40, 10 40, 30 20)),((15 5, 40 10, 10 20, 5 10, 15 5)))'));

• Buat tabel yang mendukung tipe GEOMETRYCOLLECTION. Anda hanya dapat menulis data koleksi geometri ke tabel tersebut.

  CREATE TABLE collections(gid INT, g GEOMETRY(GEOMETRYCOLLECTION), PRIMARY KEY(gid));

  Tulis data koleksi geometri.

  UPSERT INTO collections(gid,g) VALUES(0, ST_GeomFromText('GEOMETRYCOLLECTION (POINT (40 10), LINESTRING (10 10, 20 20, 10 40), POLYGON ((40 40, 20 45, 45 30, 40 40)))'));

• Buat tabel yang terdiri dari beberapa kolom dengan tipe data spasial (Geometry).

  CREATE TABLE mix(gid INT, pt GEOMETRY(POINT), ply GEOMETRY(POLYGON), PRIMARY KEY(gid));