ALTER TABLE ステートメントを実行して、既存のマッピングテーブルに属性列を追加または削除します。
詳細については、「DDL 操作」をご参照ください。
前提条件
-
OTSClient インスタンスが初期化されていること。詳細については、「OTSClient インスタンスの初期化」をご参照ください。
-
マッピングテーブルが作成されていること。詳細については、「マッピングテーブルの作成」をご参照ください。
注意事項
-
CREATE TABLE文で作成されたマッピングテーブルのみが、ALTER TABLEによる属性列の更新をサポートします。DESCRIBEなどの操作で自動的にバインドされるマッピングテーブルは、属性列の更新をサポートしません。 -
各
ALTER TABLE文で追加または削除できる属性列は 1 つのみです。複数の属性列を更新するには、列ごとにALTER TABLE文を実行します。 -
ALTER TABLE文で更新されるのはマッピングテーブルスキーマのみです。Tablestore テーブルのデータストレージスキーマは更新されません。 -
ALTER TABLE文では、マッピングテーブルのプライマリキー列を追加または削除できません。 -
ALTER TABLE文を実行した後、SQL エンジンはマッピングテーブルを非同期で更新します。更新には最大 30 秒かかる場合があります。更新中は、すべての属性列を返すクエリでは、新しく追加した列が返されない場合があります。 -
既存の属性列の定義を変更するには、
DROP COLUMNを使用して列を削除し、その後ADD COLUMNを使用して新しい定義で列を追加します。
パラメーター
|
パラメーター |
説明 |
|
query |
SQL ステートメント。必要な機能に基づいてこのパラメーターを設定してください。 |
例
-
属性列の追加
次の例では、
exampletableという名前のマッピングテーブルに BIGINT 型のcolvalue列を追加します。const params = { query: "alter table exampletable add column colvalue bigint", } client.sqlQuery(params, function (err, data) { if (err) { console.log('sqlQuery error:', err.toString()); } else { console.log('sqlQuery success:', data); } }); -
属性列の削除
次の例では、
exampletableという名前のマッピングテーブルからcolvalue列を削除します。const params = { query: "alter table exampletable drop column colvalue", } client.sqlQuery(params, function (err, data) { if (err) { console.log('sqlQuery error:', err.toString()); } else { console.log('sqlQuery success:', data); } });
不要になった属性列を削除し、ビジネス要件に基づいて属性列を追加できます。
よくある質問
次のステップ
インデックス選択の最適化と計算プッシュダウンがサポートされています (クエリ最適化)。
-
SELECTステートメントを実行して、マッピングテーブルを使用してデータをクエリおよび分析します。詳細については、「データのクエリ」をご参照ください。 -
DESCRIBEステートメントを実行して、テーブルの詳細を表示します。詳細については、「テーブル情報のクエリ」をご参照ください。 -
DROP MAPPING TABLEステートメントを実行して、テーブルまたは検索インデックスに対して作成されたマッピングテーブルを削除します。詳細については、「マッピングテーブルの削除」をご参照ください。 -
SHOW INDEXステートメントを実行して、テーブルのインデックス情報を表示します。詳細については、「テーブルのインデックス情報のクエリ」をご参照ください。 -
SHOW TABLESステートメントを実行して、現在のデータベース内のマッピングテーブルを一覧表示します。詳細については、「テーブル名の一覧表示」をご参照ください。