PolarDB:PolarDB for MySQL の DDL 操作ガイド

PolarDB for MySQL 8.0.2

PolarDB for MySQL 8.0.1

PolarDB for MySQL 5.7

PolarDB for MySQL 5.6

PolarDB for MySQL 8.0.2

PolarDB for MySQL 8.0.1

PolarDB for MySQL 5.7

PolarDB for MySQL 5.6

PolarDB for MySQL 8.0.2

1. カラム即時追加機能は、テーブルの末尾にのみ列を追加することをサポートしています。テーブルに指定されたプライマリキーがない場合、テーブルの末尾にある暗黙のプライマリキー列が原因で列追加操作が失敗するのを防ぐために、implicit_primary_key パラメーターを OFF に設定する必要があります。カラム即時追加機能は、圧縮テーブル (ROW_FORMAT=COMPRESSED)、フルテキストインデックスを持つテーブル、または一時テーブルではサポートされていません。クラスターがカラム即時追加機能をサポートしていない場合、システムは INPLACE アルゴリズムを使用して列を追加します。これにより、テーブルの再構築がトリガーされます。テーブルの再構築プロセス中、同時読み取りおよび書き込み操作が許可されます。並列 DDL 機能を使用して、列の追加を高速化することもできます。

2. VARCHAR 列の長さを拡張する場合、高速な列拡張をサポートするには、長さを格納するために必要なバイト数が同じである必要があります。具体的には、0〜255 バイトの VARCHAR 列は、その長さを格納するために 1 バイトを必要とします。256 バイト以上の VARCHAR 列は 2 バイトを必要とします。ALTER TABLE 文は、VARCHAR 列の長さの拡張が特定の範囲内 (0〜255 バイト、または 256 バイトからより大きなサイズなど) である場合にのみメタデータを変更できます。VARCHAR 列の長さを 256 バイト未満から 256 バイト以上に変更する場合、PolarDB はデフォルトで Copy DDL を使用します。これにより、全期間にわたってテーブルがロックされます。DML 書き込み操作はサポートされませんが、読み取り操作はサポートされます。

   VARCHAR 列の変更範囲が上記の条件を満たすかどうかわからない場合は、ALGORITHM=INPLACE を使用して、現在の DDL 操作に INPLACE アルゴリズムが使用されるように指定できます。高速な列拡張がサポートされていない場合、すぐにエラーが報告されます。例:

   ALTER TABLE table_name ALGORITHM=INPLACE, CHANGE COLUMN c1 c1 VARCHAR(256);
   
   ERROR 0A000: ALGORITHM=INPLACE is not supported. Reason: Cannot change column type INPLACE. Try ALGORITHM=COPY.

   VARCHAR は可変長ストレージタイプです。ディスクには実際の長さのみが格納されます。したがって、VARCHAR フィールドを使用する場合は、最大長を 256 バイト以上に設定することを検討してください。これにより、フィールドを拡張するときに COPY アルゴリズムを使用する必要がなくなります。

3. 次の条件が満たされる場合、列の文字セットを UTF8mb3 から UTF8mb4 に変更すると、データを変更せずにメタデータのみが変更されます。それ以外の場合、COPY アルゴリズムを使用してテーブルが再構築されます。再構築中、テーブルは全期間ロックされます。ターゲットテーブルからは読み取りのみ可能で、書き込み操作はブロックされます。

   • カラムタイプは CHAR、VARCHAR、ENUM、または TEXT です。

   • 変更された列にインデックスが存在しない。

   • 文字セット変換の前後で、列の最大ストレージ長が 256 バイト未満であるか、255 バイトより大きい。

   ALGORITHM=INPLACE を指定して、非再構築メソッドを使用して DDL 文を強制的に実行できます。COPY アルゴリズムが必要な場合は、すぐにエラーが返されます。例:

   ALTER TABLE test modify column b char(1) CHARACTER SET utf8mb4 default null,algorithm = inplace;
   ERROR 1846 (0A000): ALGORITHM=INPLACE is not supported. Reason: Cannot change column type INPLACE. Try ALGORITHM=COPY.

4. データ型のストレージサイズが変更されず、ENUM または SET の末尾に要素を追加する場合にのみ、テーブル全体を再構築せずにメタデータのみを変更できます。それ以外の場合、テーブルを再構築するには COPY アルゴリズムが必要です。

PolarDB for MySQL 8.0.1

1. カラム即時追加機能は、テーブルの末尾にのみ列を追加することをサポートしています。テーブルにプライマリキーがない場合、テーブルの末尾にある暗黙のプライマリキー列が原因で列追加操作が失敗するのを防ぐために、implicit_primary_key パラメーターを OFF に設定する必要があります。カラム即時追加機能は、圧縮テーブル (ROW_FORMAT=COMPRESSED)、フルテキストインデックスを持つテーブル、または一時テーブルではサポートされていません。クラスターがカラム即時追加機能をサポートしていない場合、システムは INPLACE アルゴリズムを使用して列を追加します。これにより、テーブル全体の再構築がトリガーされます。再構築中、同時読み取りおよび書き込み操作が許可されます。並列 DDL 機能を使用して操作を高速化することもできます。

   さらに、テーブルに列ストアインデックスが含まれている場合、列を追加するには列ストアインデックスを再構築する必要があるため、カラム即時追加機能はサポートされていません。loose_imci_enable_add_column_instant_ddl パラメーターを ON に設定して、カラム即時追加機能を有効にできます。この場合、PolarDB はバックグラウンドで非同期に列ストアインデックスを再構築します。再構築中、列ストアインデックスは一時的に利用できなくなります。詳細については、「列ストアインデックスを動的に追加または削除するための DDL 構文」をご参照ください。

2. VARCHAR 列の長さを拡張する場合、高速な列拡張をサポートするには、長さを格納するために必要なバイト数が同じである必要があります。具体的には、0〜255 バイトの VARCHAR 列は、その長さを格納するために 1 バイトを必要とします。256 バイト以上の VARCHAR 列は 2 バイトを必要とします。ALTER TABLE 文は、VARCHAR 列の長さの拡張が特定の範囲内 (0〜255 バイト、または 256 バイトからより大きなサイズなど) である場合にのみメタデータを変更できます。VARCHAR 列の長さを 256 バイト未満から 256 バイト以上に変更する場合、PolarDB はデフォルトで Copy DDL を使用します。これにより、全期間にわたってテーブルがロックされます。DML 書き込み操作はサポートされませんが、読み取り操作はサポートされます。

   VARCHAR 列の変更範囲が上記の条件を満たすかどうかわからない場合は、ALGORITHM=INPLACE を使用して、現在の DDL 操作に INPLACE アルゴリズムが使用されるように指定できます。高速な列拡張がサポートされていない場合、すぐにエラーが報告されます。例:

   ALTER TABLE table_name ALGORITHM=INPLACE, CHANGE COLUMN c1 c1 VARCHAR(256);
   
   ERROR 0A000: ALGORITHM=INPLACE is not supported. Reason: Cannot change column type INPLACE. Try ALGORITHM=COPY.

   VARCHAR は可変長ストレージタイプです。ディスクには実際の長さのみが格納されます。したがって、VARCHAR フィールドを使用する場合は、最大長を 256 バイト以上に設定することを検討してください。これにより、フィールドを拡張するときに COPY アルゴリズムを使用する必要がなくなります。

3. loose_innodb_support_instant_modify_charset パラメーターが ON に設定され、次の条件が満たされる場合、列の文字セットを UTF8mb3 から UTF8mb4 に変更すると、データを変更せずにメタデータのみが変更されます。それ以外の場合、COPY アルゴリズムを使用してテーブルが再構築されます。再構築中、テーブルは全期間ロックされます。ターゲットテーブルからは読み取りのみ可能で、書き込み操作はブロックされます。

   • カラムタイプは CHAR、VARCHAR、ENUM、または TEXT です。

   • 変更された列にインデックスが存在しない。

   • 文字セット変換の前後で、列の最大ストレージ長が 256 バイト未満であるか、255 バイトより大きい。

   ALGORITHM=INPLACE を指定して、非再構築メソッドを使用して DDL 文を強制的に実行できます。COPY アルゴリズムが必要な場合は、すぐにエラーが返されます。例:

   ALTER TABLE test modify column b char(1) CHARACTER SET utf8mb4 default null,algorithm = inplace;
   ERROR 1846 (0A000): ALGORITHM=INPLACE is not supported. Reason: Cannot change column type INPLACE. Try ALGORITHM=COPY.

4. データ型のストレージサイズが変更されず、ENUM または SET の末尾に要素を追加する場合にのみ、テーブル全体を再構築せずにメタデータのみを変更できます。それ以外の場合、テーブルを再構築するには COPY アルゴリズムが必要です。

PolarDB for MySQL 5.7

1. カラム即時追加機能を有効にするには、loose_innodb_support_instant_add_column パラメーターを ON に設定する必要があります。この機能は、テーブルの末尾にのみ列を追加することをサポートしています。テーブルにプライマリキーがない場合、テーブルの末尾にある暗黙のプライマリキー列が原因で操作が失敗するのを防ぐために、implicit_primary_key パラメーターを OFF に設定する必要があります。カラム即時追加機能は、圧縮テーブル (ROW_FORMAT=COMPRESSED)、フルテキストインデックスを持つテーブル、または一時テーブルでもサポートされていません。クラスターがカラム即時追加機能をサポートしていない場合、システムは INPLACE アルゴリズムを使用して列を追加します。このプロセスはテーブルの再構築をトリガーし、同時読み取りおよび書き込み操作を許可します。並列 DDL 機能を使用して操作を高速化することもできます。

2. VARCHAR 列の長さを拡張する場合、高速な列拡張をサポートするには、長さを格納するために必要なバイト数が同じである必要があります。具体的には、0〜255 バイトの VARCHAR 列は、その長さを格納するために 1 バイトを必要とします。256 バイト以上の VARCHAR 列は 2 バイトを必要とします。ALTER TABLE 文は、VARCHAR 列の長さの拡張が特定の範囲内 (0〜255 バイト、または 256 バイトからより大きなサイズなど) である場合にのみメタデータを変更できます。VARCHAR 列の長さを 256 バイト未満から 256 バイト以上に変更する場合、PolarDB はデフォルトで Copy DDL を使用します。これにより、全期間にわたってテーブルがロックされます。DML 書き込み操作はサポートされませんが、読み取り操作はサポートされます。

   VARCHAR 列の変更範囲が上記の条件を満たすかどうかわからない場合は、ALGORITHM=INPLACE を使用して、現在の DDL 操作に INPLACE アルゴリズムが使用されるように指定できます。高速な列拡張がサポートされていない場合、すぐにエラーが報告されます。例:

   ALTER TABLE table_name ALGORITHM=INPLACE, CHANGE COLUMN c1 c1 VARCHAR(256);
   
   ERROR 0A000: ALGORITHM=INPLACE is not supported. Reason: Cannot change column type INPLACE. Try ALGORITHM=COPY.

   VARCHAR は可変長ストレージタイプです。ディスクには実際の長さのみが格納されます。したがって、VARCHAR フィールドを使用する場合は、最大長を 256 バイト以上に設定することを検討してください。これにより、フィールドを拡張するときに COPY アルゴリズムを使用する必要がなくなります。

3. データ型のストレージサイズが変更されず、ENUM または SET の末尾に要素を追加する場合にのみ、テーブル全体を再構築せずにメタデータのみを変更できます。それ以外の場合、テーブルを再構築するには COPY アルゴリズムが必要です。

PolarDB for MySQL 5.6

1. カラム即時追加機能を有効にするには、loose_innodb_support_instant_add_column パラメーターを ON に設定する必要があります。テーブルの末尾にのみ列を追加できます。テーブルに指定されたプライマリキーがない場合、テーブルの末尾にある暗黙のプライマリキー列が原因で列追加操作が失敗するのを防ぐために、implicit_primary_key パラメーターを OFF に設定する必要があります。さらに、カラム即時追加機能は、圧縮テーブル (ROW_FORMAT=COMPRESSED)、フルテキストインデックスを持つテーブル、一時テーブル、またはパーティションテーブルではサポートされていません。クラスターがカラム即時追加機能をサポートしていない場合、システムは INPLACE アルゴリズムを使用して列を追加します。これにより、テーブルの再構築がトリガーされます。テーブルの再構築プロセス中、同時読み取りおよび書き込み操作が許可されます。

   説明

   PolarDB for MySQL 5.6 のカラム即時追加機能は現在カナリアリリース中です。この機能を使用するには、Quota Center に移動し、[Quota ID] polardb_mysql_iac_56 を使用してクォータ名を見つけ、[アクション] 列の [適用] をクリックして有効にします。

2. データ型のストレージサイズが変更されず、ENUM または SET の末尾に要素を追加する場合にのみ、テーブル全体を再構築せずにメタデータのみを変更できます。それ以外の場合、テーブルを再構築するには COPY アルゴリズムが必要です。

PolarDB for MySQL 8.0.2

PolarDB for MySQL 8.0.1

PolarDB for MySQL 5.7

PolarDB for MySQL 5.6

PolarDB for MySQL 8.0.2

PolarDB for MySQL 8.0.1

PolarDB for MySQL 5.7

PolarDB for MySQL 5.6

PolarDB for MySQL 5.6 は生成列機能をサポートしていません。

PolarDB for MySQL 8.0.2

PolarDB for MySQL 8.0.1

PolarDB for MySQL 5.7

PolarDB for MySQL 5.6

PolarDB for MySQL 8.0.2

1. パーティションレベルのメタデータロック (MDL) により、loose_partition_level_mdl_enabled パラメーターを true に設定した後、DDL 操作が影響を受けないパーティションの DML に影響を与えないことが保証されます。詳細については、「オンラインパーティションメンテナンス」をご参照ください。

2. RANGE および LIST パーティションテーブルのパーティションの追加または削除には、テーブルの再構築は必要ありません。HASH および KEY パーティションテーブルへのパーティションの追加には、テーブルの再構築が必要です。HASH および KEY パーティションテーブルからのパーティションの削除はサポートされていません。

3. HASH および KEY パーティションのみがサポートされています。

4. InnoDB エンジンを使用するテーブルで OPTIMIZE PARTITION 操作を実行すると、パーティションテーブル全体が再構築されます。再構築中、ターゲットテーブルでの読み取りおよび書き込み操作が許可されます。この場合、innodb_parallel_build_primary_index パラメーターを ON に設定して、並列 DDL 機能を使用して再構築を高速化できます。

5. 即時変換は、標準テーブルをレンジパーティションテーブルに迅速に変換することのみをサポートします。

6. PolarDB for MySQL は、パーティションレベルのインデックスの作成と削除をサポートしています。詳細については、「部分インデックス」をご参照ください。

7. パーティションの再編成または再構築は、データの再配布と再構築が必要な指定されたパーティションのみを再構築します。他のパーティションは影響を受けません。

8. パーティションの分析は、テーブルのメタデータやデータを変更せず、統計情報のみを変更します。

9. パーティションのチェックは、メタデータやデータを変更しません。

10. パーティションの修復は、修復が必要な指定されたパーティションのみを再構築します。

PolarDB for MySQL 8.0.1

1. RANGE および LIST パーティションテーブルへのパーティションの追加には、テーブルの再構築は必要ありません。HASH および KEY パーティションテーブルへのパーティションの追加には、テーブルの再構築が必要です。

2. HASH および KEY パーティションテーブルからのパーティションの削除はサポートされていません。

3. InnoDB エンジンを使用するテーブルで OPTIMIZE PARTITION 操作を実行すると、パーティションテーブル全体が再構築されます。再構築中、ターゲットテーブルでの読み取りおよび書き込み操作が許可されます。innodb_parallel_build_primary_index パラメーターを ON に設定して、並列 DDL 機能を使用して再構築を高速化できます。

4. パーティションの再編成、再構築、修復は、再編成、再構築、修復が必要な指定されたパーティションのみを再構築します。他のパーティションは影響を受けません。

5. パーティションの分析は、テーブルのメタデータやデータを変更せず、統計情報のみを変更します。

6. パーティションのチェックは、メタデータやデータを変更しません。

PolarDB for MySQL 5.7

1. RANGE および LIST パーティションテーブルのパーティションの追加または削除には、テーブルの再構築は必要ありません。HASH および KEY パーティションテーブルへのパーティションの追加には、テーブルの再構築が必要です。HASH および KEY パーティションテーブルからのパーティションの削除はサポートされていません。

2. パーティションの再編成、再構築、修復は、再編成、再構築、修復が必要な指定されたパーティションのみを再構築します。他のパーティションは影響を受けません。

3. パーティションの分析は、テーブルのメタデータやデータを変更せず、統計情報のみを変更します。

4. パーティションのチェックは、メタデータやデータを変更しません。

PolarDB for MySQL 5.6

1. RANGE および LIST パーティションテーブルのパーティションの追加または削除には、テーブルの再構築は必要ありません。HASH および KEY パーティションテーブルへのパーティションの追加には、テーブルの再構築が必要です。HASH および KEY パーティションテーブルからのパーティションの削除はサポートされていません。

2. パーティションの再編成、再構築、修復は、再編成、再構築、修復が必要な指定されたパーティションのみを再構築します。他のパーティションは影響を受けません。

3. パーティションの分析は、テーブルのメタデータやデータを変更せず、統計情報のみを変更します。

4. パーティションのチェックは、メタデータやデータを変更しません。