列型変更ルール

OceanBaseデータベースのMySQLモードで列型を変更する場合、まずテーブルレベルの列型変更ルール、特に一部のデータ型の禁止シナリオを考慮する必要があります。次に、列型変更におけるソースデータ型とターゲットデータ型の変更ルールを考慮します。

テーブル単位の列型変更ルール

禁止ルール

• 外部キー制約

  Online DDLとOffline DDLにおいて、以下の特別な場合を除き（注意：関連する型の変更は表示精度のみを変更し、格納構造は変更しない）、外部キー列の型変更はサポートされません。

  • 列のデータ型が FLOAT(m,n) の場合、精度の変更はサポートされますが、SIGNED と UNSIGNED の相互変換はサポートされません。

  • 列のデータ型が DOUBLE(m,n) の場合、精度の変更はサポートされますが、SIGNED と UNSIGNED の相互変換はサポートされません。

  • 列のデータ型が VARCHAR(m) の場合、精度の引き上げはサポートされますが、精度の引き下げや CHAR 型への変更はサポートされません。

• CHECK 制約

  Online DDLとOffline DDLにおいて、整数型（INTEGER）の列を除き、CHECK 制約を持つ列の型変更はサポートされません。

• Trigger制約

  Offline DDLのみに適用されます。列に DISABLE 以外のTrigger制約がある場合、列型の変更は禁止されます。すべてのTriggerが DISABLE である場合、DDL操作には影響せず、新しいテーブルにもこの DISABLE のTriggerを含める必要があります。

変更ルール

• 同一データ型で長さが長くなる場合、例えばある列のデータ型を VARCHAR(8) から VARCHAR(11) に変更する操作は、Online DDLとして実行でき、データの再書き込みは不要です。

  • Online DDLで列の長さを変更する際、その列にインデックステーブルが存在する場合（例：VARCHAR 型の長さが長くなる場合）、Online DDLで変更すると同時に、インデックステーブルなどの依存オブジェクトのスキーマも修正する必要があります。つまり、「ユーザーが想定するデータの変更はないが、依存オブジェクトのスキーマも修正する必要がある」ということです。
  • INTEGER および DecimalInt 型の列について、それらがインデックス列または主キー列である場合、列型の拡張操作はOnline DDLで実行できます。

• OceanBaseデータベースでは、LOB 型の拡張に対して、Online DDL操作は以下の状況をサポートします：

  • 通常の列の変更。
  • 生成列（Store/Virtual）としての変更
  • 生成列に依存する（Store/Virtual）変更
  • NOT NULL および CHECK 制約の追加。
  • 既存の NOT NULL 制約の変更。

• 数値データ型において、SIGNED と UNSIGNED の変換が発生する場合、型変更が許可される場合でも、Offline操作を実行する必要があります。文字データ型において、文字セットや照合順序（Collation）の変更が発生する場合、列型変更が許可される場合でも、Offline操作を実行する必要があります。

• ある列が生成列に参照されている場合、列型の変更操作は許可されます。

列レベルの変換ルール

OceanBaseデータベースでは、すべての列データ型は数値データ型、文字データ型、時間データ型の3つの大きなカテゴリに分類されます。これら3つの大カテゴリ内での変換ルールは類似しており、各大カテゴリ間での変更ルールも類似していますが、いくつかの特別なケースもあります。

以下の各表は、それぞれの大カテゴリ内部および大カテゴリ間の変換状況を列挙したものです。

数値データ型間の変換

数値データ型は以下のように分類されます：

• 整数型：TINYINT、SMALLINT、MEDIUMINT、INT、BIGINT

• 浮動小数点数型：FLOAT、DOUBLE

• 固定小数点数型：NUMBER

• バイナリ：BIT

次の表は、数値データ型間の変換を示しています。

文字データ型間の変換

文字データ型は以下のように分類されます：

• CHAR、VARCHAR

• BINARY、VARBINARY

• TEXT 大型データ型：TINYTEXT、MEDIUMTEXT、TEXT、LONGTEXT

• BLOB 大型データ型：TINYBLOB、MEDIUMBLOB、BLOB、LONGBLOB

• ENUM、SET

次の表は、文字データ型間の変換を示しています。

時間型データ型間の変換

時間データ型は以下のとおりです：

• DATE

• TIMESTAMP

• DATETIME

• TIME

• YEAR

次の表は、時間型データ型間の変換ルールを示しています。

数値型と文字型間の変換

数値型と文字型間の変換ルールは次の表のとおりです。

数値型と時系列型の相互変換

数値型と時系列型の相互変換の仕様は、次の表のとおりです。

文字列データ型と時系列データ型間の変換

文字列データ型と時系列データ型間の変換は、次の表のとおりです。

Online DDLによる列型の上位互換変換のシナリオ

整数型の変換

DECIMAL/DECIMALINT

DECIMAL(precision, scale) は10進数データ型を表し、precision は数値の全長、scale は小数部の桁数を表します。Online DDLにおける precision の範囲は [1, 9]、[10, 18]、[19, 38]、[39, 65] です。

precision の範囲が同じで scale が変わらない場合、基盤となる物理ストレージは変更されません。Online DDLを使用して変更できます。例えば、DECIMAL(10, 2) から DECIMAL(12, 2) への変更は、Online DDLを使用して行えます。

• 最初のパラメータ precision の変更について、長くする場合（precisionを増やす場合）は、Online DDLを使用して変更できます。例えば、DECIMAL(10, 2) から DECIMAL(12, 2) への変更は、Online DDLを使用して行えます。しかし、短くする場合（precisionを減らす場合）は、Online DDLでは変更できず、Offline DDLを使用して変更する必要があります。区間をまたぐ変更もOffline DDLを使用して行う必要があります。

• 2番目のパラメータ scale の変更について、長くする場合も短くする場合も、Online DDLは使用できず、Offline DDLを使用して変更する必要があります。例えば、DECIMAL(10, 2) から DECIMAL(10, 4) への変更や、DECIMAL(10, 2) から DECIMAL(10, 1) への変更は、Offline DDLを使用して行う必要があります。

VARCHARの可変長化

VARCHAR(x) を VARCHAR(y) に変換する場合、y の長さが x の長さ以上であれば、Online DDLを使用して列型を上位互換的に変更できます。例えば、VARCHAR(10) を VARCHAR(20) に変換する場合、Online DDLを使用して列型を変更できます。

VARBINARYの可変長化

VARBINARY(x) を VARBINARY(y) に変換する場合、y の長さが x の長さ以上であれば、Online DDLを使用して列型を上位互換的に変更できます。例えば、VARBINARY(10) を VARBINARY(20) に変換する場合、Online DDLを使用して列型を変更できます。

バイト列データ型

VARCHARとTINYTEXTの相互変換

VARBINARYとTINYBLOBの相互変換