列型変更ルール

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制約がある場合、列型の変更は禁止されます。すべてDISABLEのTriggerである場合、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

以下の表は、時間型データ型間の変換状況を示しています。

数値型と文字列型の相互変換

数値型と文字列型の相互変換の状況は、以下の表に示されています。

数値型と日付時刻型の相互変換

数値型と日付時刻型の相互変換の状況は、以下の表に示されています。

文字列型と日付時刻型間の変換

文字列型と日付時刻型間の変換は、以下の表に示されています。

オンラインDDLによる列型のアップグレードシナリオ

形式的変換

DECIMAL/DECIMALINT

DECIMAL(precision, scale) は10進数型を表し、precision は数字の全長を、scale は小数部の桁数を表します。precision のOnline DDL時の精度範囲は[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 の相互変換