PolarDB:DDL 変更ルールとベストプラクティス

インプレース変更のサポート可否

次の表は、検索ビューまたは ETL ストアドプロシージャの一般的な変更と、インプレース変更がサポートされているかどうかを示しています。

インプレース変更

既存のリンクで SQL ロジックを変更し、既存のリンク状態を使用して同期を再開します。詳細については、「検索ビュー - 検索ビューの変更」および「ETL ストアドプロシージャ (sync_by_sql) - 同期リンクの変更」をご参照ください。

• 検索ビューの構文：

  ALTER SEARCH VIEW view_name UPDATE
    [WITH (option_list)]
    [TO (column_list, PRIMARY KEY (pk_column_list))]
    AS new_select_statement;

• ETL ストアドプロシージャの構文：

  SET esl_link_options = "<new_option_list>";
  -- new_sync_sql が空の場合、既存の同期 SQL が保持されます
  CALL dbms_etl.update_sync_link('<sync_id>', '<new_sync_sql>'); 

「新しいインデックス + 新しいリンク」による変更

「新しいインデックス + 新しいリンク」アプローチは、最も汎用性の高い変更方法です。リンクはデータを再スキャンし、PolarSearch ノードに書き込みます。新しい検索ビューまたは ETL ストアドプロシージャがデータ同期と検証を完了した後、アプリケーションのクエリトラフィックを新しいインデックスに切り替えます。

例：

shop.user テーブルにフィールドを追加し、検索ビューを再構築します。元の検索ビューは shop.user テーブル (id, name, phone, gmt_create カラムを含む) を user_v1 インデックスに同期しています。オンラインクエリを中断せずに membership_level カラムを追加する必要があります。

1. 新しいインデックスの作成： PolarSearch ノードに user_v2 という名前の新しいインデックスを作成し、そのマッピングに新しい membership_level フィールドを含めます。

   PUT user_v2
   {
     "mappings": {
       "properties": {
         "id":               { "type": "keyword" },
         "name":             { "type": "text", "fields": { "keyword": { "type": "keyword" } } },
         "phone":            { "type": "keyword" },
         "gmt_create":       { "type": "date" },
         "membership_level": { "type": "integer" }
       }
     }
   }

2. ソーステーブルの変更： ソースの PolarDB for MySQL 内の user テーブルに新しいカラムを追加します。

   ALTER TABLE shop.user ADD COLUMN membership_level TINYINT NOT NULL DEFAULT 0 COMMENT 'Membership level';

3. 新しい検索ビューの作成： shop.user テーブルから user_v2 インデックスにデータを同期する新しい検索ビューを作成します。

   CREATE SEARCH VIEW user_v2 AS SELECT id, name, phone, gmt_create, membership_level FROM shop.user;

4. 検証と切り替え： SHOW SEARCH VIEW STATUS を実行して、新しい検索ビューのステータスを確認します。同期レイテンシーが約 0 ～ 1 秒に低下した後、新しいインデックス内のデータを検証します。検証後、アプリケーションのクエリトラフィックを新しい user_v2 インデックスに切り替えます。

5. 古いリソースのクリーンアップ： 新しい検索ビューが安定して動作した後、古い検索ビューと user_v1 インデックスを削除します。

   DROP SEARCH VIEW user_v1;