すべてのプロダクト
Search
ドキュメントセンター

Tablestore:マッピングテーブルの属性列の更新

最終更新日:Oct 23, 2026

ALTER TABLE ステートメントを実行して、既存のマッピングテーブルに属性列を追加または削除します。

説明

詳細については、「DDL 操作」をご参照ください。

前提条件

注意事項

  • 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 ステートメントを実行して、現在のデータベース内のマッピングテーブルを一覧表示します。詳細については、「テーブル名の一覧表示」をご参照ください。