メインコンテンツまでスキップ
バージョン: 4.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をサポートしており、値列の加算および減算操作をより迅速かつ同期的に完了できます。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（集約モデル）を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. new_colをexample_db.my_tableTableの最初の列位置に追加する（非集計モデル）
ALTER TABLE example_db.my_table
ADD COLUMN new_col INT KEY DEFAULT "0" FIRST;
ヒント
  • aggregationモデルにvalueカラムを追加する場合、agg_typeを指定する必要があります
  • 非集約モデル（DUPLICATE KEYなど）の場合、keyカラムを追加する際にはKEYキーワードを指定する必要があります
  • ベースインデックスに既に存在するカラムをrollupインデックスに追加することはできません（必要に応じてrollupインデックスを再作成することは可能です）

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 モデルに value カラムを追加する場合、agg_type を指定する必要があります
  • aggregation モデルに key カラムを追加する場合、KEY キーワードを指定する必要があります
  • base index に既に存在するカラムを rollup index に追加することはできません（必要に応じて rollup index を再作成できます）

3. 指定されたインデックスからカラムを削除する

構文

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;
ヒント
  • パーティションカラムは削除できません
  • 集計モデルでは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", ...)]

例

  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 keyTableのKeyカラム内のフィールドの長さを変更する
ALTER TABLE example_db.my_table 
MODIFY COLUMN k3 VARCHAR(50) KEY NULL COMMENT 'to 50';
ヒント
  • aggregation モデルで 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  |
+-------+------------+------+-------+---------+-------+
ヒント
  • インデックス内のすべての列が書き出されます
  • value列はkey列の後に配置されます
  • key列の範囲内でのみkey列を調整できます。value列についても同様です

Keywords​

ALTER, TABLE, COLUMN, ALTER TABLE

ベストプラクティス​