MaxCompute:列操作

スキーマ進化の有効化

次のコマンドを実行して、スキーマ進化を有効にします。

setproject odps.schema.evolution.enable=true;

構文

ALTER TABLE <table_name>
  ADD COLUMNS [IF NOT EXISTS]
  (<col_name1> <type1> COMMENT ['<col_comment>']
  [, <col_name2> <type2> COMMENT '<col_comment>'...]
  );

パラメーター

例

sale_detail テーブルに 2 つの列を追加します。

ALTER TABLE sale_detail ADD COLUMNS IF NOT EXISTS(customer_name STRING, education BIGINT);

sale_detail テーブルにコメント付きの 2 つの列を追加します。

ALTER TABLE sale_detail ADD COLUMNS (customer_name STRING COMMENT 'Customer', education BIGINT COMMENT 'Education' );

sale_detail テーブルに複雑なデータ型の列を追加します。

ALTER TABLE sale_detail ADD COLUMNS (region_info struct<province:string, area:string>);

列が既に存在し、文に IF NOT EXISTS が含まれている場合、文は成功しますが、列は再度追加されません。

-- 文は成功しますが、ID 列は繰り返し追加されません。
ALTER TABLE sale_detail ADD COLUMNS IF NOT EXISTS(id bigint);

Delta テーブルに列を追加します。

CREATE TABLE delta_table_test (pk BIGINT NOT NULL PRIMARY KEY, val BIGINT)
  TBLPROPERTIES ("transactional"="true");

ALTER TABLE delta_table_test ADD COLUMNS (val2 bigint);

構文

-- 単一の列を削除します。
ALTER TABLE <table_name> DROP COLUMN <col_name>;

-- 複数の列を削除します。
ALTER TABLE <table_name> DROP COLUMNS <col_name1>[, <col_name2>...];

パラメーター

例

sale_detail テーブルから customer_id 列を削除します。

-- sale_detail テーブルから customer_id 列を削除します。 削除を確認するには yes と入力します。
ALTER TABLE sale_detail DROP COLUMN customer_id;

DROP COLUMNS を使用して customer_id 列を削除します。

-- sale_detail テーブルから customer_id 列を削除します。 削除を確認するには yes と入力します。
ALTER TABLE sale_detail DROP COLUMNS customer_id;

sale_detail テーブルから shop_name 列と customer_id 列を削除します。

-- sale_detail テーブルから shop_name 列と customer_id 列を削除します。 削除を確認するには yes と入力します。
ALTER TABLE sale_detail DROP COLUMNS shop_name, customer_id;

構文

ALTER TABLE <table_name> CHANGE [COLUMN] <old_column_name> <new_column_name> <new_data_type>;

パラメーター

例

sale_detail テーブルの id フィールドのデータ型を BIGINT から STRING に変更します。

ALTER TABLE sale_detail CHANGE COLUMN id id STRING;

データ型変換テーブル

構文

ALTER TABLE <table_name> CHANGE <old_column_name> <new_column_name> <column_type> AFTER <column_name>;

パラメーター

例

customer 列の名前を customer_id に変更し、total_price 列の後に移動します。

ALTER TABLE sale_detail CHANGE customer customer_id STRING AFTER total_price;

customer_id 列の名前を変更せずに total_price 列の後に移動します。

ALTER TABLE sale_detail CHANGE customer_id customer_id STRING AFTER total_price;

構文

ALTER TABLE <table_name> CHANGE COLUMN <old_col_name> RENAME TO <new_col_name>;

パラメーター

例

sale_detail テーブルの customer_name 列の名前を customer に変更します。

ALTER TABLE sale_detail CHANGE COLUMN customer_name RENAME TO customer;

構文

ALTER TABLE <table_name> CHANGE COLUMN <col_name> COMMENT '<col_comment>';

パラメーター

例

sale_detail0113 テーブルの customer 列のコメントを変更します。

ALTER TABLE sale_detail0113 CHANGE COLUMN customer COMMENT 'customer';

構文

ALTER TABLE <table_name> CHANGE COLUMN <old_col_name> <new_col_name> <column_type> COMMENT '<col_comment>';

パラメーター

例

customer 列の名前を customer_newname に変更し、そのコメントを 'customer' に設定します。

ALTER TABLE sale_detail CHANGE COLUMN customer customer_newname STRING COMMENT 'customer';

構文

ALTER TABLE <table_name> CHANGE COLUMN <old_col_name> NULL;

パラメーター

例

id 列に NOT NULL 制約を持つパーティションテーブルを作成し、NULL 値を許可します。

-- id 列が NULL にできないパーティションテーブルを作成します。
CREATE TABLE null_test(id INT NOT NULL, name STRING) PARTITIONED BY (ds string);

-- テーブルのプロパティを表示します。
DESC EXTENDED null_test;
-- 次の結果が返されます。
+------------------------------------------------------------------------------------+
| Native Columns:                                                                    |
+------------------------------------------------------------------------------------+
| Field    | Type   | Label | ExtendedLabel | Nullable | DefaultValue | Comment      |
+------------------------------------------------------------------------------------+
| id       | int    |       |               | false    | NULL         |              |
| name     | string |       |               | true     | NULL         |              |
+------------------------------------------------------------------------------------+
| Partition Columns:                                                                 |
+------------------------------------------------------------------------------------+
| ds              | string     |                                                     |
+------------------------------------------------------------------------------------+

-- id 列に NULL を許可します。
ALTER TABLE null_test CHANGE COLUMN id NULL;
-- テーブルのプロパティを表示します。
DESC EXTENDED null_test;
-- 次の結果が返されます。
+------------------------------------------------------------------------------------+
| Native Columns:                                                                    |
+------------------------------------------------------------------------------------+
| Field    | Type   | Label | ExtendedLabel | Nullable | DefaultValue | Comment      |
+------------------------------------------------------------------------------------+
| id       | int    |       |               | true     | NULL         |              |
| name     | string |       |               | true     | NULL         |              |
+------------------------------------------------------------------------------------+
| Partition Columns:                                                                 |
+------------------------------------------------------------------------------------+
| ds              | string     |                                                     |
+------------------------------------------------------------------------------------+