メインコンテンツまでスキップ
バージョン: 26.x

ALTER TABLE COLUMN

説明​

このステートメントは、既存のTableに対してスキーマ変更操作を実行するために使用されます。スキーマ変更は非同期で行われ、タスクが正常に送信されるとタスクが返されます。その後、SHOW ALTER TABLE COLUMNコマンドを使用して進行状況を確認できます。

Dorisには、Table構築後にマテリアライズドインデックスという概念があります。Table構築が成功すると、それがベースTableとなり、マテリアライズドインデックスがベースインデックスとなります。rollupインデックスは、ベースTableに基づいて作成できます。ベースインデックスとrollupインデックスの両方がマテリアライズドインデックスです。スキーマ変更操作中にrollup_index_nameが指定されない場合、デフォルトでベースTableに基づいて操作が実行されます。

ヒント

Doris 1.2.0では、軽量なスケール構造変更に対してlight schema changeをサポートしており、value列の加算および減算操作をより迅速かつ同期的に完了できます。Table作成時に手動で"light_schema_change" = 'true'を指定できます。このパラメータは、バージョン2.0.0以降ではデフォルトで有効になっています。

文法:​

ALTER TABLE [database.]table alter_clause;

schema changeのalter_clauseは以下の変更方法をサポートしています：

1. 指定されたインデックスの指定された位置にカラムを追加する

文法

ALTER TABLE [database.]table table_name ADD COLUMN column_name column_type [KEY | agg_type] [DEFAULT "default_value"]
[AFTER column_name|FIRST]
[TO rollup_index_name]
[PROPERTIES ("key"="value", ...)]

例

  1. key_1の後にキーカラムnew_colをexample_db.my_tableに追加する（非集計モデル）
ALTER TABLE example_db.my_table
ADD COLUMN new_col INT KEY DEFAULT "0" AFTER key_1;
  1. example_db.my_tableのvalue_1の後に値カラムnew_colを追加する（非集計モデル）
ALTER TABLE example_db.my_table
ADD COLUMN new_col INT DEFAULT "0" AFTER value_1;
  1. key_1の後にキー列new_col（aggregateモデル）をexample_db.my_tableに追加する
ALTER TABLE example_db.my_table
ADD COLUMN new_col INT KEY DEFAULT "0" AFTER key_1;
  1. example_db.my_tableのvalue_1の後にvalue列をnew_col SUM集約タイプ（集約モデル）で追加する
ALTER TABLE example_db.my_table   
ADD COLUMN new_col INT SUM DEFAULT "0" AFTER value_1;
  1. example_db.my_table Table（非集約モデル）の最初の列位置に new_col を追加する
ALTER TABLE example_db.my_table
ADD COLUMN new_col INT KEY DEFAULT "0" FIRST;
ヒント
  • 集約モデルにvalue列を追加する場合は、agg_typeを指定する必要があります
  • 非集約モデル（DUPLICATE KEYなど）でkey列を追加する場合は、KEYキーワードを指定する必要があります
  • base indexに既に存在する列をrollup indexに追加することはできません（必要に応じてrollup indexを再作成できます）

2. 指定されたインデックスに複数の列を追加する

文法

ALTER TABLE [database.]table table_name ADD COLUMN (column_name1 column_type [KEY | agg_type] DEFAULT "default_value", ...)
[TO rollup_index_name]
[PROPERTIES ("key"="value", ...)]

Example

  1. example_db.my_table に複数のカラムを追加します。ここで new_col と new_col2 は SUM 集約タイプです（集約モデル）
ALTER TABLE example_db.my_table
ADD COLUMN (new_col1 INT SUM DEFAULT "0" ,new_col2 INT SUM DEFAULT "0");
  1. example_db.my_table（非集計モデル）に複数の列を追加します。ここで、new_col1がKEY列、new_col2がvalue列になります
ALTER TABLE example_db.my_table
ADD COLUMN (new_col1 INT key DEFAULT "0" , new_col2 INT DEFAULT "0");
ヒント
  • aggregation modelに値列を追加する場合は、agg_typeを指定する必要があります
  • aggregation modelにキー列を追加する場合は、KEYキーワードを指定する必要があります
  • base indexに既に存在する列をrollup indexに追加することはできません（必要に応じてrollup indexを再作成できます）

3. 指定されたindexから列を削除する

文法*

ALTER TABLE [database.]table table_name DROP COLUMN column_name
[FROM rollup_index_name]

例

  1. example_db.my_tableからカラムcol1を削除する
ALTER TABLE example_db.my_table DROP COLUMN col1;
ヒント
  • パーティションカラムを削除できません
  • aggregateモデルはKEYカラムを削除できません
  • ベースインデックスからカラムが削除された場合、rollupインデックスに含まれている場合も削除されます

4. 指定されたインデックスのカラムタイプとカラム位置を変更する

文法

ALTER TABLE [database.]table table_name MODIFY COLUMN column_name column_type [KEY | agg_type] [NULL | NOT NULL] [DEFAULT "default_value"]
[AFTER column_name|FIRST]
[FROM rollup_index_name]
[PROPERTIES ("key"="value", ...)]

Example

  1. ベースインデックスのキー列col1の型をBIGINTに変更し、col2列の後ろに移動する
ALTER TABLE example_db.my_table 
MODIFY COLUMN col1 BIGINT KEY DEFAULT "1" AFTER col2;
ヒント

キー列または値列のどちらを変更する場合でも、完全な列情報を宣言する必要があります

  1. base indexのval1列の最大長を変更します。元のval1は (val1 VARCHAR(32) REPLACE DEFAULT "abc") です
ALTER TABLE example_db.my_table 
MODIFY COLUMN val1 VARCHAR(64) REPLACE DEFAULT "abc";
ヒント

列のデータ型のみを変更できます。列の他の属性は変更されません。

  1. Duplicate key Tableの Key 列にあるフィールドの長さを変更する
ALTER TABLE example_db.my_table 
MODIFY COLUMN k3 VARCHAR(50) KEY NULL COMMENT 'to 50';
ヒント
  • aggregation modelのvalue列を変更する場合は、agg_typeを指定する必要があります
  • 非集約タイプのkey列を変更する場合は、KEYキーワードを指定する必要があります
  • 列のタイプのみ変更可能で、列の他の属性はそのまま残ります（つまり、他の属性は元の属性に従ってステートメント内に明示的に記述する必要があります。例8を参照）
  • パーティション列とバケット列は一切変更できません
  • 現在、以下のタイプの変換がサポートされています（精度の損失はユーザーが保証します）
    • TINYINT/SMALLINT/INT/BIGINT/LARGEINT/FLOAT/DOUBLEタイプからより大きな数値タイプへの変換
    • TINTINT/SMALLINT/INT/BIGINT/LARGEINT/FLOAT/DOUBLE/DECIMALからVARCHARへの変換
    • VARCHARは最大長の変更をサポート
    • VARCHAR/CHARからTINTINT/SMALLINT/INT/BIGINT/LARGEINT/FLOAT/DOUBLEへの変換
    • VARCHAR/CHARからDATEへの変換（現在"%Y-%m-%d"、"%y-%m-%d"、"%Y%m%d"、"%y%m%d"、"%Y/%m/%d"、"%y/%m/%d"の6つの形式をサポート）
    • DATETIMEからDATEへの変換（年月日情報のみ保持、例：2019-12-09 21:47:05 <--> 2019-12-09）
    • DATEからDATETIMEへの変換（時分秒は自動的にゼロで埋められる、例：2019-12-09 <--> 2019-12-09 00:00:00）
    • FLOATからDOUBLEへの変換
    • INTからDATEへの変換（INTタイプのデータが不正な場合、変換は失敗し、元のデータは変更されません）
    • DATEとDATETIME以外はすべてSTRINGに変換可能ですが、STRINGは他のタイプには変換できません

5. 指定されたインデックスで列を並び替える

文法

ALTER TABLE [database.]table table_name ORDER BY (column_name1, column_name2, ...)
[FROM rollup_index_name]
[PROPERTIES ("key"="value", ...)]

Example

  1. example_db.my_table（非集約モデル）のキーと値の列の順序を調整する
CREATE TABLE `my_table`(
`k_1` INT NULL,
`k_2` INT NULL,
`v_1` INT NULL,
`v_2` varchar NULL,
`v_3` varchar NULL
) ENGINE=OLAP
DUPLICATE KEY(`k_1`, `k_2`)
COMMENT 'OLAP'
DISTRIBUTED BY HASH(`k_1`) BUCKETS 5
PROPERTIES (
"replication_allocation" = "tag.location.default: 1"
);

ALTER TABLE example_db.my_table ORDER BY (k_2,k_1,v_3,v_2,v_1);

mysql> desc my_table;
+-------+------------+------+-------+---------+-------+
| Field | タイプ       | Null | Key   | Default | Extra |
+-------+------------+------+-------+---------+-------+
| k_2   | INT        | Yes  | true  | NULL    |       |
| k_1   | INT        | Yes  | true  | NULL    |       |
| v_3   | VARCHAR(*) | Yes  | false | NULL    | NONE  |
| v_2   | VARCHAR(*) | Yes  | false | NULL    | NONE  |
| v_1   | INT        | Yes  | false | NULL    | NONE  |
+-------+------------+------+-------+---------+-------+
  1. 2つのアクションを同時に実行する
CREATE TABLE `my_table` (
`k_1` INT NULL,
`k_2` INT NULL,
`v_1` INT NULL,
`v_2` varchar NULL,
`v_3` varchar NULL
) ENGINE=OLAP
DUPLICATE KEY(`k_1`, `k_2`)
COMMENT 'OLAP'
DISTRIBUTED BY HASH(`k_1`) BUCKETS 5
PROPERTIES (
"replication_allocation" = "tag.location.default: 1"
);

ALTER TABLE example_db.my_table
ADD COLUMN col INT DEFAULT "0" AFTER v_1,
ORDER BY (k_2,k_1,v_3,v_2,v_1,col);

mysql> desc my_table;
+-------+------------+------+-------+---------+-------+
| Field | タイプ       | Null | Key   | Default | Extra |
+-------+------------+------+-------+---------+-------+
| k_2   | INT        | Yes  | true  | NULL    |       |
| k_1   | INT        | Yes  | true  | NULL    |       |
| v_3   | VARCHAR(*) | Yes  | false | NULL    | NONE  |
| v_2   | VARCHAR(*) | Yes  | false | NULL    | NONE  |
| v_1   | INT        | Yes  | false | NULL    | NONE  |
| col   | INT        | Yes  | false | 0       | NONE  |
+-------+------------+------+-------+---------+-------+
ヒント
  • indexのすべての列が書き出されます
  • value列はkey列の後に配置されます
  • key列の調整はkey列の範囲内でのみ可能です。value列についても同様です

Keywords​

ALTER, TABLE, COLUMN, ALTER TABLE

ベストプラクティス​