すべてのプロダクト
Search

このプロダクト

    Tablestore:検索インデックススキーマの動的変更

    ドキュメントセンター

    Tablestore:検索インデックススキーマの動的変更

    最終更新日:May 14, 2026

    検索インデックスのスキーマを動的に変更して、カラムの追加、更新、削除、またはルーティングキーとプリソーティング方法の変更を行うことができます。これにより、新しいビジネス要件への対応やパフォーマンスの最適化が可能になります。このプロセスでは、変更されたスキーマを持つカナリアインデックスの作成、データの同期、トラフィック重み付けによる A/B テスト、ソースインデックスとカナリアインデックスのスキーマのスワップ、そしてカナリアインデックスの削除を行います。

    仕組み

    Tablestore のデータテーブルはスキーマフリーですが、検索インデックスには厳格なスキーマがあります。検索インデックスを作成する際には、クエリ用にインデックス化するカラムを定義する必要があります。ビジネスの変化やパフォーマンスチューニングをサポートするために、このスキーマを変更することがよく必要になります。一般的なシナリオには次のものがあります。

    • インデックスカラムの追加：ビジネスの進化に伴い、追加のカラムをクエリする必要が生じる場合があります。

    • インデックスカラムの更新：カラムタイプ、仮想列、配列設定、アナライザー、日付フォーマットなどのプロパティを変更できます。

    • インデックスカラムの削除：クエリに不要になったカラムを削除できます。

    • ルーティングキーの変更：適切に定義されたルーティングキーにより、読み出し増幅を減らし、クエリパフォーマンスを向上させることができます。

    • プリソーティングの変更：クエリ内のデータソート順序がインデックスのプリソーティング設定と一致する場合、クエリ速度が向上します。

    ワークフロー

    重要

    動的に動作するため、この一時的なインデックスをクエリに使用しないでください。この機能がニーズを満たさない場合は、チケットを送信。

    次の図は、スキーマを動的に変更するワークフローを示しています。プロセス全体がアプリケーションに対して透過的であるため、アプリケーションコードを変更することなくスキーマを変更できます。

    image

    次の表は、検索インデックスのスキーマを変更するための主な手順を説明しています。

    ステップ

    アクション

    説明

    1

    カナリアインデックスの作成

    ソースインデックスのカナリアインデックスを作成し、必要に応じてカラムの追加、変更、削除を行って、新しいスキーマを定義します。

    2

    インデックス同期進捗状況の確認

    次に進む前に、すべての既存データと増分データが同期され、カナリアインデックスの進捗状況がソースインデックスと一致するまで待ちます。

    3

    A/B テスト用の重み設定

    A/B テストでは、ソースインデックスとカナリアインデックス間でクエリトラフィックを分散して、新しいスキーマを検証できます。

    カナリアインデックスがクエリトラフィックの 100% を処理するまで、段階的にトラフィックをリダイレクトします。

    4

    インデックススキーマのスワップ

    すべてのクエリトラフィックがカナリアインデックスに切り替えられた後、ソースインデックスとカナリアインデックスのスキーマをスワップします。

    スワップ後、ソースインデックス名は新しいスキーマを、カナリアインデックス名は古いスキーマを指すようになります。すべてのクエリトラフィックは、新しいスキーマを使用するソースインデックス名に向けられます。

    5

    カナリアインデックスの削除

    スキーマをスワップし、インデックスが期待どおりに動作することを確認した後、安定期間 (たとえば 1 日) を待ってからカナリアインデックスを削除します。

    操作手順

    1. インデックス タブに移動します。

      1. Tablestore コンソールにログインします。

      2. 上部メニューで、リージョンとリソースグループを選択します。

      3. 概要 ページで、インスタンス名をクリックするか、操作 列の インスタンスの管理 をクリックします。

      4. インスタンスの詳細 タブの テーブルリスト エリアで、データテーブル名をクリックするか、操作 列の インデックス をクリックします。

    2. ソースインデックスに基づいてカナリアインデックスを作成します。

      1. インデックス タブで、検索インデックスを見つけ、操作 列の スキーマの変更 をクリックします。

      2. インデックスの再作成 ダイアログボックスで、必要に応じてインデックスフィールドを追加、変更、または削除します。

        image

      3. ルーティングキーまたはプレソーティングメソッドを変更するには、詳細設定を有効にし、次の表で説明されているパラメーターを設定します。

        パラメータ

        説明

        ルーティングキー

        カスタムルーティングフィールドを指定します。1 つ以上のプライマリーキーカラムをルーティングフィールドとして選択できます。

        データがインデックスに書き込まれる際、システムはルーティングキー値を使用してデータ分散を決定します。同じルーティングキー値を持つレコードは、同じパーティションにインデックス化されます。詳細については、「検索インデックスでのルーティングフィールドの使用」をご参照ください。

        プリソーティング

        検索インデックス内のデータのデフォルトのソート方法です。プリソーティングは、クエリ結果が返されるデフォルトの順序を決定します。詳細については、「インデックスプリソーティング」をご参照ください。

        • プライマリキーでソートするには、デフォルトソートを選択します。

        • フィールド値またはプライマリキー列の組み合わせで並べ替えるには、カスタムソート を選択して設定します。

          1. プライマリーキーの事前ソート や フィールドの事前ソート などの並べ替えタイプを選択し、追加 をクリックします。

          2. フィールド名とソート順序を選択します。

            サポートされているソート順序は、昇順と降順です。

            重要

            フィールドの事前ソート を選択した場合にのみ、フィールド名を選択する必要があります。

          カスタムソートを使用する場合、必要に応じてプライマリーキープリソーティングとフィールドプリソーティングの両方を設定できます。

      4. OK をクリックします。

      5. インデックスの比較 ダイアログボックスで、ソースインデックスとカナリアインデックス間のルーティングキー、プレソーティング、スキーマの比較を確認します。情報が正しいことを確認したら、OK をクリックします。

    3. インデックス同期情報を確認します。

      1. ソースインデックスの横にある image.png アイコンをクリックするか、ソースインデックス名をクリックします。

        ソースインデックスのカナリアインデックスが表示されます。

      2. カナリアインデックスの操作列で、グレーインデックスの使用をクリックします。

        重要

        カナリアインデックスは、完全データ同期フェーズと増分データ同期フェーズを経ます。

        • データ同期が完了する前に、操作 列の グレーインデックスの使用 ボタンにポインターを合わせると、切り替え可能、セキュリティリスクあり というツールチップが表示され、切り替えが無効になります。

        • カナリアインデックスがソースインデックスに追いつき、操作 列の グレーインデックスの使用 ボタンにポインターを合わせると、「安全に切り替え可能」というツールチップが表示されます。その後、次のステップに進むことができます。

      3. グレーインデックスの使用 ダイアログボックスで、インデックス同期情報を確認します。

        image.png

    4. 同期が完了したら、トラフィックの重みを設定して A/B テストを実行します。

      A/B テストを使用して、ソースインデックスとカナリアインデックス間でクエリトラフィックを分散することで、新しいスキーマを検証します。次の手順に進む前に、すべてのトラフィックをカナリアインデックスに切り替える必要があります。

      1. グレーインデックスの使用 ダイアログボックスの 操作 セクションで、スライダーをドラッグしてソースインデックスとカナリアインデックスの重みを調整し、重みの設定 をクリックします。

        fig_setindex

      2. 重みの設定 ダイアログボックスで、重みデータとスキーマの比較を確認します。

      3. 情報が正しいことを確認したら、重みの設定 をクリックします。

      4. 表示される確認ダイアログボックスで、OK をクリックします。

    5. すべてのクエリトラフィックがカナリアインデックスに切り替えられた後、ソースインデックスとカナリアインデックスのスキーマをスワップします。

      スワップ後、ソースインデックス名は新しいスキーマを、カナリアインデックス名は古いスキーマを指すようになります。すべてのクエリトラフィックは、新しいスキーマを使用するソースインデックス名に向けられます。

      image.png

      1. グレーインデックスの使用 ダイアログボックスの 操作 セクションで、インデックスの切り替え をクリックします。

      2. インデックスの切り替え ダイアログボックスで、ソースインデックスとカナリアインデックス間のルーティングキー、プレソーティング、およびスキーマを比較し、内容が正しいことを確認してから 切り替えの確認 をクリックします。

    6. スキーマをスワップし、インデックスが期待どおりに動作することを確認した後、安定期間 (たとえば 1 日) を待ってからカナリアインデックスを削除します。

      image.png

      1. グレーインデックスの使用 ダイアログボックスで、グレースケールインデックスを削除する をクリックします。

      2. [カナリアリリースを完了し、古いインデックスを削除してもよろしいですか?] ダイアログボックスで、削除するカナリアインデックスに関する情報が正しいことを確認します。 次に、テキストボックスに I have confirmed that the new index data has been synchronized and has been in canary release for a period of time と入力します。

      3. OK をクリックします。

    セーフガード

    運用の安全性を確保するため、Tablestore はロールバックメカニズムと切り替えアラートを提供し、インデックス変更時のリスクを最小限に抑えます。

    • ロールバックメカニズム

      動的スキーマ変更プロセスの主要なステップでは、ロールバックがサポートされています。

      • カナリアインデックスを作成した後、スキーマが正しくないことに気づいた場合は、削除して新しいものを作成できます。

      • A/B テスト中は、トラフィックの重みを調整することで、カナリアインデックスにトラフィックを段階的にリダイレクトできます。問題が発生した場合は、重みをリセットすることで、いつでもソースインデックスにトラフィックを戻すことができます。

      • スキーマを交換した後、何らかの問題が見つかった場合は、いつでも 切り替えのキャンセル を実行してソースインデックスのスキーマに戻すことができます。インデックスの切り替え 操作と 切り替えのキャンセル 操作は逆の操作です。

    • 切り替えアラート

      カナリアインデックスがソースインデックスと完全に同期される前にトラフィックを切り替えると、クエリで古いデータが返される可能性があります。Tablestore は、両方のインデックスの同期ステータスと最終同期時刻に基づいて、「切り替えが安全」かどうかを判断します。

      Tablestore は、以下の条件下で、スイッチオーバーが 安全に切り替え可能 であると判断します：

      • ソースインデックスが完全同期フェーズにあり、カナリアインデックスが完全同期フェーズまたは増分同期フェーズにある場合。つまり、カナリアインデックスがソースインデックスに追いついています。

      • ソースインデックスとカナリアインデックスの両方が増分データ同期フェーズにあり、カナリアインデックスの最終同期時刻がソースインデックスの最終同期時刻より 60 秒以上遅れていない場合。

    課金

    カナリアインデックスの構築やデータの書き込みには課金されません。両方のインデックスが消費するストレージと、それらに対してプロビジョニングされた予約読み込み CU に対して課金されます。詳細については、「検索インデックスの課金項目」をご参照ください。

    関連ドキュメント