ALTER TABLE 文を実行して、既存のマッピングテーブルに属性列を追加または削除できます。
マッピングテーブルの作成方法については、「テーブルのマッピングテーブルを作成する」をご参照ください。
使用上の注意
CREATE TABLE文を実行して作成されたマッピングテーブルの属性列のみ、ALTER TABLE文を実行して更新できます。DESCRIBE文を実行してテーブルに対して自動的に作成されたマッピングテーブルの属性列は、ALTER TABLE文を実行して更新することはできません。ALTER TABLE文を実行して、マッピングテーブルの属性列を 1 つだけ追加または削除できます。マッピングテーブルの複数の属性列を追加または削除する場合は、ALTER TABLE文を複数回実行できます。ALTER TABLE文を実行して、マッピングテーブルのスキーマのみを更新できます。マッピングテーブルが作成される Tablestore テーブルのスキーマは更新されません。ALTER TABLE文を実行して、マッピングテーブルのプライマリキー列を追加または削除することはできません。ALTER TABLE文を実行した後、SQL エンジンは非同期的にマッピングテーブルをリフレッシュします。リフレッシュが完了するまで最大 30 秒かかります。リフレッシュ期間中は、すべての列を返すはずの操作を実行しても、追加した列が返されない場合があります。
構文
ALTER TABLE table_name option column_name [data_type];パラメーター
パラメーター | 必須 | 説明 |
table_name | はい | マッピングテーブルを識別するために使用されるマッピングテーブルの名前。 |
option | はい | 実行する更新操作。有効な値：
|
column_name | はい | 属性列の名前。追加する属性列の名前は、マッピングテーブル内の既存の属性列の名前とは異なる必要があります。 SQL の列名は、Tablestore テーブルの列名と同じである必要があります。たとえば、Tablestore テーブルの列名が Aa の場合、SQL の列名は Aa、AA、aA、または aa である必要があります。 |
data_type | いいえ | 属性列のデータ型（BIGINT、DOUBLE、BOOL など）。このパラメーターは、option を ADD COLUMN に設定した場合にのみ必須です。 SQL の列のデータ型は、Tablestore テーブルの列のデータ型と一致する必要があります。データ型のマッピングについては、「SQL でのデータ型のマッピング」をご参照ください。 |
例
マッピングテーブルに属性列を追加する
次の文を実行して、exampletable マッピングテーブルに colvalue 属性列と content 属性列を追加できます。 colvalue 属性列のデータ型は BIGINT、content 属性列のデータ型は MEDIUMTEXT です。
ALTER TABLE exampletable ADD COLUMN colvalue BIGINT;ALTER TABLE exampletable ADD COLUMN content MEDIUMTEXT;マッピングテーブルから属性列を削除する
次の文を実行して、exampletable マッピングテーブルから BIGINT 型の colvalue 列を削除できます。
ALTER TABLE exampletable DROP COLUMN colvalue;