LIST DEFAULT HASH - PolarDB

Topik ini menjelaskan cara membuat dan memodifikasi tabel partisi hash default daftar.

Informasi latar belakang

PolarDB mendukung dua jenis partisi di tingkat yang sama: daftar dan hash. Data pertama kali dimasukkan ke dalam partisi daftar. Data yang tidak sesuai dengan aturan partisi daftar ditempatkan di partisi default. Jika partisi default memiliki beberapa partisi, aturan hash digunakan. Tabel partisi hash default daftar umumnya digunakan dalam skenario di mana NILAI DAFTAR didistribusikan secara tidak merata dan tidak dapat sepenuhnya dienumerasi. Gambar berikut menunjukkan operasi. LIST DEFAULT HASH

Batasan

Versi kluster harus memenuhi salah satu dari persyaratan berikut. Untuk informasi tentang cara melihat versi kluster Anda, lihat Kueri versi mesin.
- Kluster adalah PolarDB for MySQL 8.0.1 dengan versi revisi 8.0.1.1.34 atau lebih baru.
- Kluster adalah PolarDB for MySQL 8.0.2 dengan versi revisi 8.0.2.2.1 atau lebih baru.
Satu atau lebih partisi default dapat dibuat.
Subpartisi daftar dan default dapat dikombinasikan. Namun, setiap partisi hanya mendukung satu subpartisi default.
Subpartisi dapat berupa tipe apa pun jika hanya satu partisi default yang dibuat.
Jika ada beberapa partisi default, hanya subpartisi hash atau kunci yang didukung.

Buat tabel partisi hash default daftar

Syntax

PolarDB mendukung partisi daftar ditambah satu atau lebih partisi default. Partisi default menyimpan data yang tidak ada di partisi daftar. Jika partisi default terlalu besar, partisi tersebut dapat dibagi menjadi beberapa partisi default berdasarkan aturan hash. Pernyataan berikut digunakan untuk membuat satu atau lebih tabel partisi hash default daftar:

CREATE TABLE [ schema. ]table_name
 table_definition
   PARTITION BY LIST [COLUMNS] (expr)
   SUBPARTITION BY ...
   (list_partition_definition[, ..., list_partition_definition],
    default_partition_definition
   )

default_partition_definition adalah:

PARTITION partition_name DEFAULT [PARTITIONS number]

Definisi setiap partisi juga dapat mencakup subpartisi. List default juga didukung dalam subpartisi yang didefinisikan dengan cara berikut:

SUBPARTITION subpartition_name DEFAULT

Parameters

Parameter	Deskripsi
table_name	Nama tabel.
partition_name	Nama partisi jika hanya satu partisi default yang dibuat. Nama tersebut harus berbeda dari nama-nama di tabel partisi lainnya. Awalan nama partisi jika beberapa partisi default dibuat. Dalam hal ini, nama tersebut dalam format partition_name+nomor urut.
subpartition_name	Nama subpartisi. Nama tersebut harus unik dalam tabel. Maksimal satu subpartisi DEFAULT yang didukung.
number	Jumlah partisi default jika partisi default dibagi menjadi beberapa partisi default berdasarkan aturan hash. Parameter nomor bersifat opsional. Jika Anda tidak menentukan parameter ini, sebuah partisi default akan dibuat.

Examples

Buat partisi default.

CREATE TABLE list_default (
  a INT,
  b INT
)
PARTITION BY LIST (a)
(PARTITION p0 VALUES IN (1,2,3,4,5),
 PARTITION p1 VALUES IN (6,7,8,9,10),
 PARTITION pd DEFAULT);

Buat beberapa partisi default.

CREATE TABLE list_default_hash (
  a INT,
  b INT
)
PARTITION BY LIST (a)
(PARTITION p0 VALUES IN (1,2,3,4,5),
 PARTITION p1 VALUES IN (6,7,8,9,10),
 PARTITION pd DEFAULT PARTITIONS 3);

Buat beberapa partisi default yang berisi tipe data VARCHAR dan menggunakan aturan partisi kolom daftar.

CREATE TABLE t_goods
(
  country   VARCHAR(30),
  year      VARCHAR(60),
  goods     TEXT
) PARTITION BY LIST COLUMNS(country)
(
  PARTITION p1 VALUES IN ('China'),
  PARTITION p2 VALUES IN ('USA'),
  PARTITION p3 VALUES IN ('Asia'),
  PARTITION p3 VALUES IN ('Singapore'),
  PARTITION p_deft DEFAULT PARTITIONS 5
);

Lihat partisi dengan mengeksekusi pernyataan EXPLAIN.

EXPLAIN SELECT * FROM list_default_hash;

Hasil sampel:

+----+-------------+-------------------+-------------------+------+---------------+------+---------+------+------+----------+-------+
| id | select_type | table             | partitions        | type | possible_keys | key  | key_len | ref  | rows | filtered | Extra |
+----+-------------+-------------------+-------------------+------+---------------+------+---------+------+------+----------+-------+
|  1 | SIMPLE      | list_default_hash | p0,p1,pd0,pd1,pd2 | ALL  | NULL          | NULL | NULL    | NULL |    1 |   100.00 | NULL  |
+----+-------------+-------------------+-------------------+------+---------------+------+---------+------+------+----------+-------+
1 row in set (0.04 sec)

Buat tabel partisi hash default daftar yang mendukung subpartisi daftar default:

CREATE TABLE test (a int, b int)
PARTITION BY RANGE(a)
SUBPARTITION BY LIST(b) (
PARTITION part0 VALUES LESS THAN (10)
( SUBPARTITION sub0 VALUES IN (1,2,3,4,5),
  SUBPARTITION sub1 DEFAULT),
PARTITION part1 VALUES LESS THAN (20)
( SUBPARTITION sub2 VALUES IN (1,2,3,4,5),
  SUBPARTITION sub3 DEFAULT),
PARTITION part2 VALUES LESS THAN (30)
( SUBPARTITION sub4 VALUES IN (1,2,3,4,5),
  SUBPARTITION sub5 DEFAULT));

Buat tabel partisi hash default daftar yang hanya mendukung subpartisi hash atau kunci ketika beberapa partisi hash default daftar disertakan:

CREATE TABLE list_default_hash_sub (
  a INT,
  b INT
)
PARTITION BY LIST (a)
SUBPARTITION BY HASH (b) SUBPARTITIONS 20
(PARTITION p0 VALUES IN (1,2,3,4,5),
 PARTITION p1 VALUES IN (6,7,8,9,10),
 PARTITION pd DEFAULT PARTITIONS 3);

Modifikasi tabel partisi hash default daftar

Partisi hash default daftar hanya mendukung pernyataan berikut: ALTER TABLE ADD PARTITION, ALTER TABLE DROP PARTITION, ALTER TABLE REORGANIZE PARTITION, ALTER TABLE TRUNCATE PARTITION, ALTER TABLE EXCHANGE PARTITION, ALTER TABLE OPTIMIZE PARTITION, ALTER TABLE REBUILD PARTITION, ALTER TABLE REPAIR PARTITION, ALTER TABLE ANALYZE PARTITION, dan ALTER TABLE CHECK PARTITION.

Topik ini menjelaskan cara memodifikasi tabel partisi hash default daftar dengan mengeksekusi pernyataan ALTER TABLE ADD PARTITION, ALTER TABLE DROP PARTITION, dan ALTER TABLE REORGANIZE PARTITION. Untuk informasi lebih lanjut tentang pernyataan lainnya, lihat Modifikasi tabel partisi.

ALTER TABLE ADD PARTITION

TAMBAH PARTISI DEFAULT

Syntax

Jika tabel partisi hanya berisi partisi daftar, tambahkan partisi default dengan mengeksekusi pernyataan ADD PARTITION untuk mengubahnya menjadi tabel partisi hash default daftar.

ALTER TABLE table_name ADD PARTITION(default_partition_definition)

Examples

Tambahkan partisi default:

CREATE TABLE list_tab (
  a INT,
  b INT
)
PARTITION BY LIST (a)
(PARTITION p0 VALUES IN (1,2,3,4,5),
 PARTITION p1 VALUES IN (6,7,8,9,10)
);
ALTER TABLE list_tab ADD PARTITION(PARTITION pd DEFAULT);

Tambahkan dua partisi default:

CREATE TABLE list_tab (
  a INT,
  b INT
)
PARTITION BY LIST (a)
(PARTITION p0 VALUES IN (1,2,3,4,5),
 PARTITION p1 VALUES IN (6,7,8,9,10)
);
ALTER TABLE list_tab ADD PARTITION(PARTITION pd DEFAULT PARTITIONS 2);

TAMBAH PARTISI DAFTAR
Untuk tabel partisi hash default daftar di PolarDB for MySQL 8.0.2.2.11 dan versi lebih baru, Anda dapat menambahkan WITHOUT VALIDATION ke pernyataan ALTER TABLE ADD PARTITION untuk menambahkan partisi daftar.
Anda perlu memastikan bahwa nilai daftar partisi baru adalah data baru, artinya tidak ada data di partisi default yang memenuhi aturan partisi daftar baru. Jika tidak, eksekusi pernyataan ALTER TABLE REORGANIZE PARTITION untuk memisahkan sebagian data dari partisi default untuk membuat partisi daftar baru.
Syntax
```
ALTER TABLE table_name ADD PARTITION(
  list_partition_definition[, ..., list_partition_definition])
WITHOUT VALIDATION
```
Examples
Menambahkan partisi daftar.
```
CREATE TABLE list_default_hash (
  a INT,
  b INT
)
PARTITION BY LIST (a)
(PARTITION p0 VALUES IN (1,2,3,4,5),
 PARTITION p1 VALUES IN (6,7,8,9,10),
 PARTITION pd DEFAULT PARTITIONS 3);

ALTER TABLE list_default_hash ADD PARTITION(
  PARTITION p2 VALUES IN (11,12,13)
)WITHOUT VALIDATION;
```
Setelah pernyataan di atas dieksekusi, partisi daftar bernama p2 ditambahkan ke tabel list_default_hash. p2 tidak berisi data.
Catatan
Anda perlu memastikan bahwa nilai parameter a di partisi default bukan 11, 12, atau 13. Jika tidak, Anda mungkin gagal menemukan data ini di partisi default setelah partisi daftar ditambahkan.

ALTER TABLE DROP PARTITION

Untuk informasi lebih lanjut tentang pernyataan DROP PARTITION, lihat DROP PARTITION.

Examples

Catat bahwa pernyataan DROP PARTITION menghapus semua partisi default sekaligus. Anda tidak dapat mengeksekusi pernyataan ini untuk menghapus hanya beberapa partisi default.

Eksekusi pernyataan DROP PARTITION untuk menghapus semua partisi.

ALTER TABLE list_default_hash DROP PARTITION pd0,pd1,pd2;
Query OK, 0 rows affected (0.33 sec)
Records: 0  Duplicates: 0  Warnings: 0

Error message

Kesalahan dikembalikan saat Anda menghapus hanya beberapa partisi default.

ALTER TABLE list_default_hash DROP PARTITION pd0;

Pesan kesalahan berikut dikembalikan:

ERROR 8078 (HY000): DROP PARTITION cannot be used on default partitions of LIST DEFAULT, except once dropping all default partitions

ALTER TABLE REORGANIZE PARTITION

Untuk informasi lebih lanjut tentang pernyataan REORGANIZE PARTITION, lihat REORGANIZE PARTITION.

Examples

Catat bahwa pernyataan REORGANIZE PARTITION memodifikasi semua partisi default sekaligus. Anda tidak dapat mengeksekusi pernyataan ini untuk memodifikasi hanya beberapa partisi default.

Anda dapat mengeksekusi pernyataan REORGANIZE PARTITION untuk memodifikasi jumlah partisi default:
```
ALTER TABLE list_default_hash
REORGANIZE PARTITION
  pd0,pd1
INTO(
  PARTITION pd DEFAULT PARTITIONS 3);
```
Setelah pernyataan di atas dieksekusi, jumlah partisi default berubah dari dua menjadi tiga.
Anda dapat mengeksekusi pernyataan REORGANIZE PARTITION untuk memisahkan partisi daftar dari partisi default:
```
ALTER TABLE list_default_hash
REORGANIZE PARTITION
  pd0,pd1
INTO (
 PARTITION p2 VALUES IN (20,21),
 PARTITION pd DEFAULT PARTITIONS 2);
```
Setelah pernyataan di atas dieksekusi, partisi daftar bernama p2 ditambahkan ke tabel list_default_hash. p2 berisi data yang dipisahkan dari partisi default yang sesuai dengan aturan VALUES IN (20,21).
Anda dapat mengeksekusi pernyataan REORGANIZE PARTITION untuk menggabungkan partisi daftar ke partisi default:
```
ALTER TABLE list_default_hash
REORGANIZE PARTITION
  p2, pd0, pd1
INTO (
 PARTITION pd DEFAULT PARTITIONS 2);
```
Setelah pernyataan di atas dieksekusi, partisi daftar p2 digabungkan ke partisi default.
Anda dapat mengeksekusi pernyataan REORGANIZE PARTITION untuk memisahkan beberapa nilai dari partisi default dan menambahkannya ke partisi daftar:
```
ALTER TABLE list_default
REORGANIZE partition
  p2, pd0, pd1
INTO (
  PARTITION p2 VALUES IN (20,21,22,23,24),
  PARTITION pd DEFAULT PARTITIONS 4);
```
Setelah pernyataan di atas dieksekusi, definisi p2 berubah dari PARTITION p2 VALUES IN (20,21) menjadi PARTITION p2 VALUES IN (20,21,22,23,24). Data yang sesuai dengan aturan VALUES IN (20,21,22,23,24) dipindahkan dari partisi default ke p2.

Referensi

Partisi hash default daftar