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

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

最終更新日:Oct 23, 2026

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

説明

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

前提条件

注意事項

  • 最初に 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 ステートメントを実行できます。詳細については、「テーブル名の一覧表示」をご参照ください。