ALTER TABLE ステートメントを実行して、既存のマッピングテーブルに属性列を追加または削除できます。
詳細については、「DDL 操作」をご参照ください。
前提条件
-
OTSClient インスタンスが初期化されていること。詳細については、「OTSClient インスタンスの初期化」をご参照ください。
-
マッピングテーブルが作成されていること。詳細については、「マッピングテーブルの作成」をご参照ください。
注意事項
-
最初に
CREATE TABLE文を実行してデータテーブル用のマッピングテーブルを作成し、その後ALTER TABLE文を使用して属性列を更新します。 -
各
ALTER TABLE文で追加または削除できる属性列は 1 つのみです。複数の属性列を更新するには、列ごとにALTER TABLE文を実行してください。 -
ALTER TABLE文で更新されるのはマッピングテーブルのテーブルスキーマのみです。Tablestore テーブルのデータ保存スキーマは更新されません。 -
ALTER TABLE文では、マッピングテーブルのプライマリキー列を追加または削除できません。 -
ALTER TABLE文を実行した後、SQL エンジンはマッピングテーブルを非同期に更新します。更新には最大 30 秒かかる場合があります。更新中に、すべての属性列を返すクエリを実行すると、新たに追加した列が返されない場合があります。 -
既存の属性列の定義を変更するには、
DROP COLUMNで列を削除してから、ADD COLUMNで新しい定義の列を追加してください。
パラメータ
|
パラメータ |
説明 |
|
query |
SQL ステートメントです。必要な機能に基づいてこのパラメータを設定します。 |
例
-
マッピングテーブルに属性列を追加する
次のサンプルコードは、exampletable という名前のマッピングテーブルに BIGINT 型の colvalue 列を追加する方法を示しています。
$request = array( 'query' => 'alter table exampletable add column colvalue bigint', ); $response = $otsClient->sqlQuery($request); print json_encode($response, JSON_PRETTY_PRINT); -
マッピングテーブルから属性列を削除する
次のサンプルコードは、exampletable という名前のマッピングテーブルから colvalue 列を削除する方法を示しています。
$request = array( 'query' => 'alter table exampletable drop column colvalue', ); $response = $otsClient->sqlQuery($request); print json_encode($response, JSON_PRETTY_PRINT);
マッピングテーブルの属性列を更新する際は、不要になった属性列を削除してから、ビジネス要件に基づいて属性列を追加できます。
よくある質問
関連ドキュメント
-
SQL データクエリと計算を高速化するには、セカンダリインデックスまたは多次元インデックスを作成してください。詳細については、「インデックス選択ポリシー」および「コンピューティングプッシュダウン」をご参照ください。
-
マッピングテーブルの属性列を更新した後、
SELECTステートメントを実行して、マッピングテーブルを使用してデータをクエリおよび分析できます。詳細については、「データのクエリ」をご参照ください。 -
テーブルの説明をクエリする場合は、
DESCRIBEステートメントを実行できます。詳細については、「テーブル情報のクエリ」をご参照ください。 -
テーブルまたは多次元インデックスに対して作成されたマッピングテーブルが不要になった場合は、
DROP MAPPING TABLEステートメントを実行してマッピングテーブルを削除できます。詳細については、「マッピングテーブルの削除」をご参照ください。 -
テーブルのインデックス情報を表示する場合は、
SHOW INDEXステートメントを実行できます。詳細については、「テーブルのインデックス情報のクエリ」をご参照ください。 -
現在のデータベース内のマッピングテーブルの名前をクエリする場合は、
SHOW TABLESステートメントを実行できます。詳細については、「テーブル名の一覧表示」をご参照ください。