PolarDB for MySQL kümelerinde tablo düzeyinde In-Memory Column Index (IMCI) oluşturmak ve silmek için bu sayfadaki DDL deyimlerini kullanın.
Sürüm gereksinimleri
Kümenizin aşağıdaki sürümlerden birini çalıştırması gerekir:
PolarDB for MySQL 8.0.1, revizyon sürümü 8.0.1.1.45 veya üstü
PolarDB for MySQL 8.0.2, revizyon sürümü 8.0.2.2.27 veya üstü
Tek tablo komutları
Tablo düzeyinde IMCI oluşturun
CREATE COLUMNAR INDEX ON <db_name>.<table_name>;
CREATE COLUMNAR INDEX ON <table_name>;
db_name belirtmediğinizde, deyim geçerli oturumun veritabanını hedefler. İkincil dizinden farklı olarak, bir dizin adı veya dahil edilen sütunları belirtmeniz gerekmez; IMCI tüm sütunları otomatik olarak kapsar.
Tabloda zaten bir IMCI varsa hata almamak için IF NOT EXISTS ifadesini ON öncesine ekleyin:
CREATE COLUMNAR INDEX IF NOT EXISTS ON <db_name>.<table_name>;
Varsayılan olarak bu deyim şuna eşdeğerdir:
ALTER TABLE <db_name>.<table_name> COMMENT 'COLUMNAR=1 <OLD_COMMENT>';
Yukarıdaki eşdeğerlik yalnızcaallow_implicit_imci_alter_commentparametresiON(varsayılan) olarak ayarlandığında geçerlidir. ParametreOFFolarak ayarlandığında, IMCI tablo açıklaması değiştirilmeden oluşturulur. Ayrıntılar için bkz. Tablo açıklamalarını değiştirmeden tablo düzeyinde IMCI oluşturma .
Tüm sütunları kabul etmek yerine özel bir IMCI yapılandırmak için bkz. IMCI'yi özelleştirmek için IMCI'nin genişletilmiş özelliklerini kullanma .
IMCI oluşturma durumunu doğrulayın
Bir IMCI oluşturduktan sonra hazır olup olmadığını kontrol etmek için şu komutu çalıştırın:
SHOW IMCI INDEXES;
STATE alanı mevcut durumu gösterir:
| Durum | Açıklama |
|---|---|
COMMITTED |
IMCI hazırdır ve sorgular için kullanılabilir. |
RECOVERING |
IMCI mevcut verilerden oluşturulmaktadır. |
RECOVER_BUILDING |
IMCI, bir kurtarma olayından sonra yeniden oluşturulmaktadır. |
Tablo düzeyinde IMCI silin
DROP COLUMNAR INDEX ON <db_name>.<table_name>;
DROP COLUMNAR INDEX ON <table_name>;
db_name belirtmediğinizde, deyim geçerli oturumun veritabanını hedefler. Dizin adını belirtmeniz gerekmez.
IMCI zaten silinmişse hata almamak için IF EXISTS ifadesini ON öncesine ekleyin:
DROP COLUMNAR INDEX IF EXISTS ON <db_name>.<table_name>;
Bu deyim, aşağıdakilerin her ikisini de çalıştırmaya eşdeğerdir:
ALTER TABLE <db_name>.<table_name> COMMENT 'COLUMNAR=0 <OLD_COMMENT>';
ALTER TABLE <db_name>.<table_name> COMMENT '<OLD_COMMENT>';
Toplu işlemler
Bir veritabanındaki tüm tablolarda aynı anda IMCI oluşturmak veya silmek için aşağıdaki deyimleri kullanın.
Tablo düzeyinde IMCI'ları toplu olarak oluşturun
Üç eşdeğer sözdizimi seçeneği desteklenir:
-- Option 1
CREATE COLUMNAR INDEX FOR TABLES IN <db_name>;
-- Option 2
CREATE COLUMNAR INDEX FOR TABLES FROM <db_name>;
-- Option 3: stored procedure (dbms_imci package)
-- dbms_imci: database package for managing IMCI operations
-- add_columnar_index: creates IMCIs for all tables in the specified database
CALL dbms_imci.add_columnar_index('<db_name>');
Üç seçenek de <db_name> içinde henüz IMCI'si olmayan her tablo için tablo düzeyinde bir IMCI oluşturur.
Saklı yordam isteğe bağlı bir set_implicit parametresi kabul eder. Bu parametreyi 1 olarak ayarlarsanız veritabanına implicit_imci işaretçisi eklenir; bu da söz konusu veritabanında oluşturulan yeni tabloların otomatik olarak IMCI almasını sağlar:
CALL dbms_imci.add_columnar_index('<db_name>', 1);
Örnek
Aşağıdaki örnek, tpch veritabanındaki tüm tablolar için IMCI oluşturur ve sonucu kontrol eder:
mysql> SHOW TABLES IN tpch;
+--------------------+
| Tables_in_tpch |
+--------------------+
| customer |
| lineitem |
| nation |
| orders |
| part |
| partsupp |
| region |
| revenue0 |
| supplier |
+--------------------+
9 rows in set (0.01 sec)
mysql> SHOW IMCI INDEXES;
Empty set (0.02 sec)
mysql> CREATE COLUMNAR INDEX FOR TABLES IN tpch;
+------------+--------+
| Table_Name | Result |
+------------+--------+
| customer | Ok |
| lineitem | Ok |
| nation | Ok |
| orders | Ok |
| part | Ok |
| partsupp | Ok |
| region | Ok |
| supplier | Ok |
+------------+--------+
8 rows in set (0.56 sec)
-- Check the STATE field. COMMITTED means the IMCI is ready.
-- RECOVERING and RECOVER_BUILDING mean it is still being built.
mysql> SHOW IMCI INDEXES;
+----------+-------------+------------+----------+-----------+-----------+---------+------------------+---------------------+-----------------------------+--------------+
| TABLE_ID | SCHEMA_NAME | TABLE_NAME | NUM_COLS | NUM_PACKS | PACK_SIZE | ROW_ID | STATE | STATE_UPDATE_AT | CHECKPOINT_DATADIR | WRITE_POLICY |
+----------+-------------+------------+----------+-----------+-----------+---------+------------------+---------------------+-----------------------------+--------------+
| 1080 | tpch | region | 3 | 0 | 65536 | 0 | RECOVERING | 2024-09-24 18:50:16 | ./imci_1/imci_chkp_1080_258 | Tradeoff |
| 1081 | tpch | nation | 4 | 1 | 65536 | 65536 | COMMITTED | 2024-09-24 18:50:16 | ./imci_1/imci_chkp_1081_254 | Tradeoff |
| 1082 | tpch | part | 9 | 64 | 65536 | 4194304 | RECOVER_BUILDING | 2024-09-24 18:50:16 | ./imci_1/imci_chkp_1082_256 | Tradeoff |
| 1083 | tpch | supplier | 7 | 0 | 65536 | 0 | RECOVERING | 2024-09-24 18:50:16 | ./imci_1/imci_chkp_1083_259 | Tradeoff |
| 1084 | tpch | partsupp | 5 | 0 | 65536 | 0 | RECOVERING | 2024-09-24 18:50:16 | ./imci_1/imci_chkp_1084_257 | Tradeoff |
| 1085 | tpch | customer | 8 | 64 | 65536 | 4194304 | RECOVER_BUILDING | 2024-09-24 18:50:15 | ./imci_1/imci_chkp_1085_252 | Tradeoff |
| 1086 | tpch | orders | 9 | 0 | 65536 | 0 | RECOVER_BUILDING | 2024-09-24 18:50:16 | ./imci_1/imci_chkp_1086_255 | Tradeoff |
| 1087 | tpch | lineitem | 15 | 0 | 65536 | 0 | RECOVER_BUILDING | 2024-09-24 18:50:15 | ./imci_1/imci_chkp_1087_253 | Tradeoff |
+----------+-------------+------------+----------+-----------+-----------+---------+------------------+---------------------+-----------------------------+--------------+
8 rows in set, 1 warning (0.07 sec)
Tablo düzeyinde IMCI'ları toplu olarak silin
Üç eşdeğer sözdizimi seçeneği desteklenir:
-- Option 1
DROP COLUMNAR INDEX FOR TABLES IN <db_name>;
-- Option 2
DROP COLUMNAR INDEX FOR TABLES FROM <db_name>;
-- Option 3: stored procedure (dbms_imci package)
-- dbms_imci: database package for managing IMCI operations
-- drop_columnar_index: deletes IMCIs from all tables in the specified database
CALL dbms_imci.drop_columnar_index('<db_name>');
Üç seçenek de <db_name> içindeki her tablodan mevcut tablo düzeyindeki IMCI'ları siler.
Saklı yordam isteğe bağlı bir reset_implicit parametresi kabul eder. Bu parametreyi 1 olarak ayarlarsanız veritabanından implicit_imci işaretçisi kaldırılır; bu da yeni tabloların otomatik olarak IMCI almasını durdurur:
CALL dbms_imci.drop_columnar_index('<db_name>', 1);
Örnek
mysql> SHOW IMCI INDEXES;
+----------+-------------+------------+----------+-----------+-----------+-----------+-----------+---------------------+-----------------------------+--------------+
| TABLE_ID | SCHEMA_NAME | TABLE_NAME | NUM_COLS | NUM_PACKS | PACK_SIZE | ROW_ID | STATE | STATE_UPDATE_AT | CHECKPOINT_DATADIR | WRITE_POLICY |
+----------+-------------+------------+----------+-----------+-----------+-----------+-----------+---------------------+-----------------------------+--------------+
| 1080 | tpch | region | 3 | 1 | 65536 | 65536 | COMMITTED | 2024-09-24 18:50:30 | ./imci_1/imci_chkp_1080_258 | Tradeoff |
| 1081 | tpch | nation | 4 | 1 | 65536 | 65536 | COMMITTED | 2024-09-24 18:50:16 | ./imci_1/imci_chkp_1081_254 | Tradeoff |
| 1082 | tpch | part | 9 | 306 | 65536 | 20054016 | COMMITTED | 2024-09-24 18:50:30 | ./imci_1/imci_chkp_1082_256 | Tradeoff |
| 1083 | tpch | supplier | 7 | 16 | 65536 | 1048576 | COMMITTED | 2024-09-24 18:50:34 | ./imci_1/imci_chkp_1083_259 | Tradeoff |
| 1084 | tpch | partsupp | 5 | 1221 | 65536 | 80019456 | COMMITTED | 2024-09-24 18:51:15 | ./imci_1/imci_chkp_1084_257 | Tradeoff |
| 1085 | tpch | customer | 8 | 229 | 65536 | 15007744 | COMMITTED | 2024-09-24 18:50:28 | ./imci_1/imci_chkp_1085_252 | Tradeoff |
| 1086 | tpch | orders | 9 | 2289 | 65536 | 150011904 | COMMITTED | 2024-09-24 18:51:23 | ./imci_1/imci_chkp_1086_255 | Tradeoff |
| 1087 | tpch | lineitem | 15 | 9156 | 65536 | 600047616 | COMMITTED | 2024-09-24 18:54:16 | ./imci_1/imci_chkp_1087_253 | Tradeoff |
+----------+-------------+------------+----------+-----------+-----------+-----------+-----------+---------------------+-----------------------------+--------------+
8 rows in set, 1 warning (1.09 sec)
mysql> CALL dbms_imci.drop_columnar_index('tpch');
+-------------+------------+--------+
| Object_Name | Operation | Result |
+-------------+------------+--------+
| customer | drop_index | Ok |
| lineitem | drop_index | Ok |
| nation | drop_index | Ok |
| orders | drop_index | Ok |
| part | drop_index | Ok |
| partsupp | drop_index | Ok |
| region | drop_index | Ok |
| supplier | drop_index | Ok |
+-------------+------------+--------+
8 rows in set (0.33 sec)
mysql> SHOW IMCI INDEXES;
Empty set (0.27 sec)
Toplu işlem sonuç kodları
Toplu işlem çıktısındaki Result sütunu, her tablo için işlemin sonucunu gösterir:
| Sonuç kodu | Açıklama |
|---|---|
Ok |
İşlem başarıyla tamamlandı. |
Skip by unsupported |
İşlem bu tablo için desteklenmiyor. |
Skip by no change |
Hedef zaten mevcut veya durum zaten eşleşiyor; örneğin, oluşturma sırasında IMCI zaten var veya silme sırasında IMCI yok. |
Skip by concurrent operation |
Eşzamanlı işlem çakışması işlemi engelledi; örneğin, başka bir DDL deyimi tabloda meta veri kilidi (MDL) tutuyor. |
Skip by not found |
Hedef nesne bulunamadı. |
Skip by ACL deny |
Geçerli hesap gerekli izinlere sahip değil. |
Failed |
İşlem başarısız oldu. |
Tablo açıklamalarını değiştirmeden tablo düzeyinde IMCI oluşturun
Varsayılan olarak CREATE COLUMNAR INDEX ON deyimi, tablo açıklamasını güncelleyerek (açıklamada COLUMNAR=1 değerine eşdeğer olacak şekilde) IMCI'yı işaretler. Tablo açıklamalarına dokunmadan IMCI oluşturmak için oturum parametresi allow_implicit_imci_alter_comment değerini OFF olarak ayarlayın.
| Parametre | Düzey | Varsayılan | Açıklama |
|---|---|---|---|
allow_implicit_imci_alter_comment |
Oturum | ON |
IMCI oluşturulurken tablo açıklamalarının değiştirilip değiştirilmeyeceğini kontrol eder. Tablo açıklamasını güncellemeyecek şekilde sütun dizini oluşturmak için OFF olarak ayarlayın. |
Parametre OFF olarak ayarlandığında, üç oluşturma yolunun tümüne uygulanır:
CREATE TABLEdeyimi,loose_polar_enable_implicit_imci_with_create_tableparametresiONolarak ayarlandığındaDinamik oluşturma için
CREATE COLUMNAR INDEX ON <db>.<table>deyimiCREATE COLUMNAR INDEX FOR TABLES IN <db_name>ile toplu oluşturma
Örnek 1: Bir tablo oluşturun ve tablo açıklamasını değiştirmeden otomatik olarak IMCI ekleyin.
SET allow_implicit_imci_alter_comment = OFF;
SET GLOBAL polar_enable_implicit_imci_with_create_table = ON;
CREATE TABLE t1 (id INT PRIMARY KEY, name VARCHAR(100));
SHOW CREATE TABLE t1 FULL;
/*
CREATE TABLE `t1` (
`id` int(11) NOT NULL,
`name` varchar(100) DEFAULT NULL,
PRIMARY KEY (`id`),
COLUMNAR INDEX (`id`,`name`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
*/
Örnek 2: Tablo açıklamasını değiştirmeden mevcut bir tabloya dinamik olarak IMCI ekleyin.
CREATE TABLE t1 (id INT PRIMARY KEY, name VARCHAR(100));
SET allow_implicit_imci_alter_comment = OFF;
CREATE COLUMNAR INDEX ON test.t1;
SHOW CREATE TABLE t1 FULL;
/*
CREATE TABLE `t1` (
`id` int(11) NOT NULL,
`name` varchar(100) DEFAULT NULL,
PRIMARY KEY (`id`),
COLUMNAR INDEX (`id`,`name`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
*/
Örnek 3: Tablo açıklamalarını değiştirmeden birden çok tabloda toplu olarak IMCI oluşturun.
CREATE TABLE t1 (id INT PRIMARY KEY, name VARCHAR(100));
CREATE TABLE t2 (id INT PRIMARY KEY, code DOUBLE);
SET allow_implicit_imci_alter_comment = OFF;
CREATE COLUMNAR INDEX FOR TABLES IN test;
/*
Table_Name Result
t1 Ok
t2 Ok
*/
SHOW CREATE TABLE t1 FULL;
/*
CREATE TABLE `t1` (
`id` int(11) NOT NULL,
`name` varchar(100) DEFAULT NULL,
PRIMARY KEY (`id`),
COLUMNAR INDEX (`id`,`name`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
*/
SHOW CREATE TABLE t2 FULL;
/*
CREATE TABLE `t2` (
`id` int(11) NOT NULL,
`code` double DEFAULT NULL,
PRIMARY KEY (`id`),
COLUMNAR INDEX (`id`,`code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci
*/
Bu ayarı ne zaman kullanmalısınız?
allow_implicit_imci_alter_comment = OFF ayarını şu durumlarda kullanın:
Tablo açıklamalarının kiracılar veya örnekler arasında tutarlı kalması gerektiğinde. Örneğin, bir SaaS ortamında IMCI'si olan büyük bir kiracının tablosu ile IMCI'si olmayan küçük bir kiracının tablosu aynı SHOW CREATE TABLE çıktısına sahip olur; bu da ekosistem araçlarıyla doğrulamayı kolaylaştırır.
Aşağıdaki sınırlamalara dikkat edin:
İkili günlük çoğaltma: İkili günlükler aracılığıyla çoğaltma yaparken, ikincil veritabanı IMCI ile ilgili açıklama ikili günlükte bulunmadığından IMCI'yı yeniden oluşturamaz. İkincil veritabanında IMCI oluşturmak için birincil ve ikincil veritabanlarında aynı
allow_implicit_imci_alter_commentve ilgili parametre ayarlarını yapılandırın.Özel IMCI'lar: Özel IMCI'lar bu DDL deyimleri aracılığıyla yapılandırılamaz. IMCI'yi özelleştirmek için bkz. IMCI'yi özelleştirmek için IMCI'nin genişletilmiş özelliklerini kullanma.