PolarDB：PolarDB MySQL版DDL操作指南

PolarDB MySQL版8.0.2版本

PolarDB MySQL版8.0.1版本

PolarDB MySQL版5.7版本

PolarDB MySQL版5.6版本

PolarDB MySQL版8.0.2版本

PolarDB MySQL版8.0.1版本

PolarDB MySQL版5.7版本

PolarDB MySQL版5.6版本

PolarDB MySQL版8.0.2版本

1. 秒級加欄位功能僅支援將列添加至表的末尾。當表未指定主鍵時，需要將參數implicit_primary_key的值設定為OFF，以避免在執行秒級加欄位操作時因表的最末尾的隱式主鍵列導致加列操作失敗。除此之外，不支援在壓縮表（ROW_FORMAT=COMPRESSED）、帶有全文索引的表以及暫存資料表上執行秒級加欄位操作。如果叢集不支援使用秒級加欄位功能，增加欄位將使用INPLACE方式執行DDL。此時需要進行全表重建，重建期間允許並發讀寫操作。您也可以通過並行DDL功能進行加速。

2. 擴充VARCHAR長度時，儲存VARCHAR列長度所需的位元組數需要保持一致，才能支援快速列擴充。具體來說，對於0~255個位元組的VARCHAR列，只需要一個Byte儲存長度。而對於大於等於256位元組的VARCHAR列，就需要兩個Bytes儲存長度。只有控制VARCHAR列長度的擴充範圍，比如從0~255位元組或從256位元組擴充到更大的範圍，才能保證在執行ALTER TABLE時只修改中繼資料。即當修改VARCHAR列的長度從小於256位元組擴充到大於等於256位元組的長度時，PolarDB預設使用Copy DDL，即全程鎖表，不支援DML寫操作，僅支援讀操作。

   當您不確定自己修改VARCHAR列的範圍是否滿足上述條件時，可以使用ALGORITHM=INPLACE指定採用INPLACE演算法執行當前DDL操作。此時，如果不支援快速列擴充，則會直接報錯。樣本如下：

   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 MySQL版8.0.1版本

1. 秒級加欄位功能僅支援將列添加至表的末尾。當表未指定主鍵時，需要將參數implicit_primary_key的值設定為OFF，以避免在執行秒級加欄位操作時因表的最末尾的隱式主鍵列導致加列操作失敗。除此之外，不支援在壓縮表（ROW_FORMAT=COMPRESSED）、帶有全文索引的表以及暫存資料表上執行秒級加欄位操作。如果叢集不支援使用秒級加欄位功能，增加欄位將使用INPLACE方式執行DDL。此時需要進行全表重建，重建期間允許並發讀寫操作。您也可以通過並行DDL功能進行加速。

   此外，若您的表中存在列存索引，由於加列操作需要重建列存索引，因此，不支援對含有列存索引的表執行秒級加列操作。您可以將參數loose_imci_enable_add_column_instant_ddl的值設定為ON來開啟秒級加列功能，此時，PolarDB會在後台非同步重建列存索引，重建期間列存索引暫不可用，詳情請參見動態增加或刪除列存索引的DDL文法。

2. 擴充VARCHAR長度時，儲存VARCHAR列長度所需的位元組數需要保持一致，才能支援快速列擴充。具體來說，對於0~255個位元組的VARCHAR列，只需要一個Byte儲存長度。而對於大於等於256位元組的VARCHAR列，就需要兩個Bytes儲存長度。只有控制VARCHAR列長度的擴充範圍，比如從0~255位元組或從256位元組擴充到更大的範圍，才能保證在執行ALTER TABLE時只修改中繼資料。即當修改VARCHAR列的長度從小於256位元組擴充到大於等於256位元組的長度時，PolarDB預設使用Copy DDL，即全程鎖表，不支援DML寫操作，僅支援讀操作。

   當您不確定自己修改VARCHAR列的範圍是否滿足上述條件時，可以使用ALGORITHM=INPLACE指定採用INPLACE演算法執行當前DDL操作。此時，如果不支援快速列擴充，則會直接報錯。樣本如下：

   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 MySQL版5.7版本

1. 開啟秒級加欄位功能需要將參數loose_innodb_support_instant_add_column的值設定為ON，且僅支援將列添加至表的末尾。當表未指定主鍵時，需要將參數implicit_primary_key的值設定為OFF，以避免在執行秒級加欄位操作時因表的最末尾的隱式主鍵列導致加列操作失敗。除此之外，不支援在壓縮表（ROW_FORMAT=COMPRESSED）、帶有全文索引的表以及暫存資料表上執行秒級加欄位操作。如果叢集不支援使用秒級加欄位功能，增加欄位將使用INPLACE方式執行DDL。此時需要進行全表重建，重建期間允許並發讀寫操作。您也可以通過並行DDL功能進行加速。

2. 擴充VARCHAR長度時，儲存VARCHAR列長度所需的位元組數需要保持一致，才能支援快速列擴充。具體來說，對於0~255個位元組的VARCHAR列，只需要一個Byte儲存長度。而對於大於等於256位元組的VARCHAR列，就需要兩個Bytes儲存長度。只有控制VARCHAR列長度的擴充範圍，比如從0~255位元組或從256位元組擴充到更大的範圍，才能保證在執行ALTER TABLE時只修改中繼資料。即當修改VARCHAR列的長度從小於256位元組擴充到大於等於256位元組的長度時，PolarDB預設使用Copy DDL，即全程鎖表，不支援DML寫操作，僅支援讀操作。

   當您不確定自己修改VARCHAR列的範圍是否滿足上述條件時，可以使用ALGORITHM=INPLACE指定採用INPLACE演算法執行當前DDL操作。此時，如果不支援快速列擴充，則會直接報錯。樣本如下：

   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 MySQL版5.6版本

1. 開啟秒級加欄位功能需要將參數loose_innodb_support_instant_add_column的值設定為ON，且僅支援將列添加至表的末尾。當表未指定主鍵時，需要將參數implicit_primary_key的值設定為OFF，以避免在執行秒級加欄位操作時因表的最末尾的隱式主鍵列導致加列操作失敗。除此之外，不支援在壓縮表（ROW_FORMAT=COMPRESSED）、帶有全文索引的表、暫存資料表以及分區表上執行秒級加欄位操作。如果叢集不支援使用秒級加欄位功能，增加欄位將使用INPLACE方式執行DDL。此時需要進行全表重建，重建期間允許並發讀寫操作。

   說明

   PolarDB MySQL版5.6版本的秒級加列功能目前處於灰階階段，如需使用，請前往配額中心，根據配額ID polardb_mysql_iac_56找到配額名稱，在對應的操作列單擊申請來開通該功能。

2. 僅當資料類型的儲存大小不發生改變，且向ENUM或SET的末尾追加元素時，才可以僅修改中繼資料，不重建整張表。否則需要使用COPY演算法進行表重建。

PolarDB MySQL版8.0.2版本

PolarDB MySQL版8.0.1版本

PolarDB MySQL版5.7版本

PolarDB MySQL版5.6版本

PolarDB MySQL版8.0.2版本

PolarDB MySQL版8.0.1版本

PolarDB MySQL版5.7版本

PolarDB MySQL版5.6版本

PolarDB MySQL版5.6版本不支援Generated Column特性。

PolarDB MySQL版8.0.2版本

PolarDB MySQL版8.0.1版本

PolarDB MySQL版5.7版本

PolarDB MySQL版5.6版本

PolarDB 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. 秒級轉換僅支援將普通錶快速轉換為RANGE分區表。

6. PolarDB MySQL版支援建立和刪除分區粒度的索引，詳情請參見部分索引（Partial Index）。

7. 重分布分區或重建分區只重建指定需要做資料重分布和重建的分區，其他分區不受影響。

8. 分析分區只修改統計資訊，不修改表的中繼資料和資料。

9. 檢查分區不修改中繼資料和資料。

10. 修複分區只重建指定需要修複的分區。

PolarDB 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 MySQL版5.7版本

1. RANGE和LIST分區增加或刪除分區時不需要重建表。HASH和KEY分區增加分區時需要重建表，HASH和KEY分區不支援刪除分區操作。

2. 重分布、重建和修複分區只重建指定需要重分布、重建和修複的分區， 不涉及其他分區。

3. 分析分區只修改統計資訊，不修改表的中繼資料和資料。

4. 檢查分區不修改中繼資料和資料。

PolarDB MySQL版5.6版本

1. RANGE和LIST分區增加或刪除分區時不需要重建表。HASH和KEY分區增加分區時需要重建表，HASH和KEY分區不支援刪除分區操作。

2. 重分布、重建和修複分區只重建指定需要重分布、重建和修複的分區， 不涉及其他分區。

3. 分析分區只修改統計資訊，不修改表的中繼資料和資料。

4. 檢查分區不修改中繼資料和資料。