Truncateパーティション

ビジネスニーズに応じて、パーティションテーブルのデータを削除し、パーティション構造を保持することができます。

パーティションテーブルにおけるTruncateパーティション操作のサポート状況

OceanBaseデータベースのMySQLモードでは、パーティションテーブルとサブパーティションテーブルにおけるTruncateパーティション操作のサポート状況は以下の表のとおりです。

Truncateパーティション操作の説明

Truncateパーティションがグローバルインデックスに与える影響

Range/Range Columns、List/List Columnsのパーティション（パーティションとサブパーティションの両方を含む）を使用し、TRUNCATE パーティション操作をサポートするテーブルについて、システムはグローバルインデックスを再作成せず、バックグラウンドでのメジャーコンパクションによるデータ削除を通じて、遅延（lazy）メンテナンス戦略でインデックスの有効性を維持します。これにより、インデックスの無効化によるクエリの中断やパフォーマンスの低下を回避できます。ただし、この最適化は通常のグローバルインデックスにのみ適用されます。以下のシナリオではこの最適化はトリガーされません：

• パーティションがHashパーティションである場合（サブパーティションがRange/Range Columns、List/List Columnsであっても）、そのサブパーティションに対してTruncate操作を実行する場合。
• パーティションキーが通常の列ではなく式である場合。

パーティションDDL時のグローバルインデックス動作を制御する隠れたパラメータ

V4.3.5バージョンから、OceanBaseデータベースはV4.3.5 BP2バージョン以降、テナントレベルの隠れたパラメータ _ob_enable_truncate_partition_preserve_global_index を導入しました。このパラメータは、TRUNCATE/DROP メインテーブルのパーティション（以下、パーティションDDLと略称）時にグローバルインデックスを無効にしないかどうかを制御します。アップグレードされたテナントの場合、この隠れたパラメータのデフォルト値は False です。新規テナントの場合、デフォルト値は True です。値の動作比較は以下のとおりです：

例：

• インデックスのメンテナンス。

  obclient> ALTER SYSTEM SET _ob_enable_truncate_partition_preserve_global_index = True;
  

• インデックスの無効化。

  obclient> ALTER SYSTEM SET _ob_enable_truncate_partition_preserve_global_index = False;
  

Truncateパーティションが並行DDL/DML/クエリに与える影響

TruncateパーティションはOffline DDL操作に属します。Truncateパーティションを実行する際、OceanBaseデータベースは対象パーティションにパーティションレベルの排他的ロックをかけます。

Truncateパーティション

パーティションテーブル内のパーティションをTruncateできます。

パーティションをTruncateするSQL構文は以下のとおりです：

ALTER TABLE table_name TRUNCATE PARTITION partition_name[, partition_name ...];

一部の例は以下のとおりです：

• パーティションテーブル tbl1_r の M202001 および M202002 パーティションのデータを削除します。

  obclient> CREATE TABLE tbl1_r (log_id BIGINT NOT NULL,log_value VARCHAR(50),log_date TIMESTAMP NOT NULL)
         PARTITION BY RANGE(UNIX_TIMESTAMP(log_date)) 
          (PARTITION M202001 VALUES LESS THAN(UNIX_TIMESTAMP('2020/02/01'))
         , PARTITION M202002 VALUES LESS THAN(UNIX_TIMESTAMP('2020/03/01'))
         , PARTITION M202003 VALUES LESS THAN(UNIX_TIMESTAMP('2020/04/01'))
         , PARTITION M202004 VALUES LESS THAN(UNIX_TIMESTAMP('2020/05/01'))
         , PARTITION M202005 VALUES LESS THAN(UNIX_TIMESTAMP('2020/06/01'))
         , PARTITION M202006 VALUES LESS THAN(UNIX_TIMESTAMP('2020/07/01'))
         , PARTITION M202007 VALUES LESS THAN(UNIX_TIMESTAMP('2020/08/01'))
         , PARTITION M202008 VALUES LESS THAN(UNIX_TIMESTAMP('2020/09/01'))
         , PARTITION M202009 VALUES LESS THAN(UNIX_TIMESTAMP('2020/10/01'))
         , PARTITION M202010 VALUES LESS THAN(UNIX_TIMESTAMP('2020/11/01'))
         , PARTITION M202011 VALUES LESS THAN(UNIX_TIMESTAMP('2020/12/01'))
         , PARTITION M202012 VALUES LESS THAN(UNIX_TIMESTAMP('2021/01/01'))
          );
  Query OK, 0 rows affected
  
  obclient> ALTER TABLE tbl1_r TRUNCATE PARTITION M202001,M202002;
  Query OK, 0 rows affected
  

• Range Columns + List Columnsパーティションテーブルt_f_rclcのパーティションp0のデータを削除します。

セカンダリパーティションのTRUNCATE

セカンダリパーティションのTRUNCATEのSQL構文は以下のとおりです：

ALTER TABLE table_name TRUNCATE SUBPARTITION subpartition_name[, subpartition_name ...];

Range + Rangeパーティションテーブルt_f_rrのセカンダリパーティションsp1とsp2のデータを削除する例を以下に示します：

obclient> CREATE TABLE t_f_rr(col1 INT,col2 TIMESTAMP) 
       PARTITION BY RANGE(col1)
       SUBPARTITION BY RANGE(UNIX_TIMESTAMP(col2))
        (PARTITION p0 VALUES LESS THAN(100)
           (SUBPARTITION sp0 VALUES LESS THAN(UNIX_TIMESTAMP('2021/04/01')),
            SUBPARTITION sp1 VALUES LESS THAN(UNIX_TIMESTAMP('2021/07/01')),
            SUBPARTITION sp2 VALUES LESS THAN(UNIX_TIMESTAMP('2021/10/01')),
            SUBPARTITION sp3 VALUES LESS THAN(UNIX_TIMESTAMP('2022/01/01'))
           ),
         PARTITION p1 VALUES LESS THAN(200)
           (SUBPARTITION sp4 VALUES LESS THAN(UNIX_TIMESTAMP('2021/04/01')),
            SUBPARTITION sp5 VALUES LESS THAN(UNIX_TIMESTAMP('2021/07/01')),
            SUBPARTITION sp6 VALUES LESS THAN(UNIX_TIMESTAMP('2021/10/01')),
            SUBPARTITION sp7 VALUES LESS THAN(UNIX_TIMESTAMP('2022/01/01'))
            )
         );
Query OK, 0 rows affected

obclient> ALTER TABLE t_f_rr TRUNCATE SUBPARTITION sp1,sp2;
Query OK, 0 rows affected