ALTER TABLE ステートメントを実行して、既存のマッピングテーブルに属性列を追加または削除できます。
説明 既存のテーブルまたは検索インデックスのマッピングテーブルを作成する方法の詳細については、テーブルのマッピングテーブルの作成を参照してください。
使用方法
- ALTER TABLE ステートメントを実行して、マッピングテーブルのスキーマを更新できます。マッピングテーブルが作成された Tablestore テーブルのスキーマは更新されません。
- マッピングテーブルの主キー列を追加または削除することはできません。
- ALTER TABLE ステートメントを実行した後、SQL エンジンはマッピングテーブルを非同期的に更新します。更新には最大 30 秒かかります。更新期間中、追加した列は、すべての列を返すはずの操作を実行しても返されない場合があります。
- CREATE TABLE ステートメントを実行して作成されたマッピングテーブルでのみ、ALTER TABLE ステートメントを実行して属性列を更新できます。DESCRIBE ステートメントを実行してテーブルに対して自動的に作成されたマッピングテーブルでは、ALTER TABLE ステートメントを実行して属性列を更新することはできません。
- ALTER TABLE ステートメントを実行することで、マッピングテーブルの属性列を 1 つだけ追加または削除できます。マッピングテーブルの複数の属性列を追加または削除する場合は、ALTER TABLE ステートメントを複数回実行できます。
構文
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 マッピングテーブルから colvalue 属性列を削除できます。colvalue 属性列のデータ型は BIGINT です。
ALTER TABLE exampletable DROP COLUMN colvalue;