PolarDB:Petunjuk penggunaan

Sintaks

CREATE {DATABASE | SCHEMA} [IF NOT EXISTS] db_name
[create_option] ...
create_option: [DEFAULT] {
CHARACTER SET [=] charset_name
| COLLATE [=] collation_name
| ENCRYPTION [=] {'Y' | 'N'}
| DIST_DB [=] {'Y' | 'N'}
}

Contoh

Buat database bernama test1 dan izinkan pembuatan tabel partisi kluster multi-master di dalam database tersebut.

CREATE DATABASE test1 DIST_DB='Y';

Mode database sharding

Pernyataan CREATE TABLE digunakan untuk membuat tabel. Di dalam database yang ditandai sebagai DIST_DB='Y', Anda dapat menggunakan DBDISTRIBUTION untuk menentukan metode distribusi tabel partisi kluster multi-master. Jika jumlah shard tidak didefinisikan secara eksplisit, sistem akan menentukannya secara otomatis berdasarkan konfigurasi kluster.

Sintaks

CREATE [TEMPORARY] TABLE [IF NOT EXISTS] tbl_name
    (create_definition,...)
    [table_options]
    [dbdistribution_options]

dbdistribution_options:
    DBDISTRIBUTION BY
        { [LINEAR] HASH(expr)
        | [LINEAR] KEY [ALGORITHM={1 | 2}] (column_list)
        | RANGE{(expr) | COLUMNS(column_list)}
        | LIST{(expr) | COLUMNS(column_list)} }
    [(dbdistribution_definition [, dbdistribution_definition] ...)]

dbdistribution_definition:
    DBDISTRIBUTION distribution_name
        [VALUES
            {LESS THAN {(expr | value_list) | MAXVALUE}
            |
            IN (value_list)}]
        [[STORAGE] ENGINE [=] engine_name]
        [COMMENT [=] 'string' ]
        [DATA DIRECTORY [=] 'data_dir']
        [INDEX DIRECTORY [=] 'index_dir']
        [MAX_ROWS [=] max_number_of_rows]
        [MIN_ROWS [=] min_number_of_rows]
        [TABLESPACE [=] tablespace_name]

Contoh:

• Tabel tunggal biasa

  CREATE database test;
  CREATE TABLE t1(
   id bigint NOT NULL, 
   name varchar(30), 
   PRIMARY key(id)
  );

• Tabel partisi multi-master yang mendukung mode sharding database

  Gunakan fungsi hash untuk pemisahan

  Buat tabel partisi kluster multi-master dan gunakan kolom id untuk pemisahan hash. Shard data didistribusikan di seluruh node baca/tulis kluster.

  CREATE TABLE dist1(
   id bigint NOT NULL, 
   c1 int, 
   c2 varchar(30), 
   PRIMARY key(id)
  ) dbdistribution BY hash(id);

  LIST sharding

  list adalah kumpulan daftar nilai enumerasi yang dapat memenuhi kebutuhan sharding berbasis enumerasi. Pada sharding list, definisi dilakukan menggunakan DBDISTRIBUTION BY LIST(expr), di mana expr merupakan singkatan dari expression, yang merepresentasikan nilai suatu kolom atau ekspresi berdasarkan nilai kolom tersebut. expr harus mengembalikan nilai integer. Setiap shard kemudian dapat didefinisikan dengan VALUES IN (value_list), di mana value_list adalah daftar nilai integer yang dipisahkan koma.

  CREATE TABLE t1 (
      id INT NOT NULL,
      store_id INT,
      partition_no INT,
      PRIMARY key(id, partition_no)
  ) DBDISTRIBUTION BY LIST(partition_no) (
    DBDISTRIBUTION a VALUES IN (1),
    DBDISTRIBUTION b VALUES IN (2)
  );

  Sharding LIST-COLUMNS

  Sharding list column sangat mirip dengan sharding list dan didefinisikan dengan menggunakan DBDISTRIBUTION BY LIST COLUMNS(column_list), di mana column_list dapat berupa satu atau beberapa nama kolom, bukan ekspresi. Faktanya, columns() tidak mengizinkan ekspresi selain nama kolom. Sharding list columns tidak lagi terbatas pada kolom integer. Jenis data yang didukung meliputi:

  • Semua tipe integer: TINYINT, SMALLINT, MEDIUMINT, INT (INTEGER), dan BIGINT.

  • Tipe numerik lain: misalnya, DECIMAL dan FLOAT tidak didukung.

  • Tipe tanggal: DATE dan DATETIME.

  • Tipe string: CHAR, VARCHAR, BINARY, dan VARBINARY. TEXT dan BLOB tidak didukung.

  CREATE TABLE t3 (
      id INT NOT NULL,
      store_id INT,
      partition_no varchar(20),
      PRIMARY key(id, partition_no)
  ) DBDISTRIBUTION BY LIST COLUMNS (partition_no) (
    DBDISTRIBUTION a values in ('id_1'),
    DBDISTRIBUTION b values in ('id_2')
  );

ALTER TABLE

Sintaks ALTER TABLE MySQL yang umum digunakan didukung. Tabel partisi kluster multi-master tidak mendukung modifikasi aturan distribusi atau operasi yang memerlukan reorganisasi shard. Untuk batasan spesifik, lihat bagian batasan pengembangan dalam topik ini.

CREATE INDEX

Sintaks CREATE INDEX MySQL yang umum digunakan didukung. Saat membuat primary key atau unique index, indeks tersebut harus mencakup semua kunci distribusi.