Azure Database for PostgreSQL フレキシブル サーバーにおけるファブリック ミラー化データベースのトラブルシューティング

この記事では、Azure Database for PostgreSQL フレキシブル サーバーをミラーリングするためのトラブルシューティング手順について説明します。

ミラーリングのテーブル選択中のエラー/警告メッセージのトラブルシューティング

ミラー化された新しいデータベースを作成すると、[ データの選択 ] ページで、ソース データベース内の特定のテーブルに関する視覚的なフィードバックを受け取ることがあります。 次の表に、表示されるメッセージや問題の解決方法に関する関連する説明など、潜在的な問題の一覧を示します。

スペース (' ') 文字を持つ ^{1 つの}オブジェクト識別子はサポートされていません。

² このテーブルの種類は、ミラーリングではサポートされていません。 現在、ビュー、マテリアライズドビュー、外部テーブル、パーティションテーブルはサポートされていません。 timescaleDB ハイパーテーブルは、Fabric ミラーリングでもサポートされていません。

³ サポートされていないデータ型の一覧については、「 制限事項」を参照してください。 次の型の列のみがサポートされています。

• bigint
• bigserial
• boolean
• bytea
• character
• character varying
• date
• double precision
• integer
• numeric
• real
• serial
• oid
• money
• smallint
• smallserial
• text
• time without time zone
• time with time zone (* 主キーではありません)
• timestamp without time zone
• timestamp with time zone
• uuid
• xml
• json
• jsonb
• inet
• cidr
• macaddr
• macaddr8
• tsvector
• tsquery
• int4range
• int8range
• numrange
• tsrange
• tstzrange
• daterange
• circle
• line
• lseg
• box
• path
• point
• polygon
• interval

Postgres では、まったく同じ瞬間に対応する 2 つの "タイム とタイム ゾーン" の値が異なると見なされます。 たとえば、 06:24:00.59+05 と 05:24:00.59+04 は同じエポック時間に対応しますが、Postgres ではそれらを異なる方法で処理します。

ソース データベース スキーマの既定の制約のない数値列 (定義された有効桁数と小数点以下桁数なし) は、OneLake テーブルにレプリケートされる前に Decimal128(38, 0) に変換され、指定されていない小数点以下桁数が整数精度を意味する SQL 標準規則に準拠します。

ソース データベースでサポートされるデータ定義言語 (DDL) 操作

• Rename column: 新しい名前の列がFabricのミラー化されたテーブルに追加され、新しく挿入された行のデータが含まれます (既存の行の場合は NULL になります)。 古い列は、既存の行の値で保持されます (新しい行の場合は NULL です)。
• 列の追加: 追加された列はミラー化されたテーブルに表示され、新しく挿入された行のデータが含まれます (既存の行の場合は NULL です)。
• 列の削除: 削除された列はミラー化されたテーブルに引き続き表示され、既存の行のデータが含まれます (新しい行の場合は NULL です)。
• 主キーの変更: ミラーリング セッションは定期的に続行されます。

ソース テーブルに対するその他の DDL 操作は現在サポートされていないため、レプリケーションエラーが発生する可能性があります。

Microsoft Fabric の容量またはワークスペースの変更

トラブルシューティングのための SQL クエリ

ミラーリングの問題が発生している場合は、ソース Azure Database for PostgreSQL サーバーに接続し、システム ビューと関数を使用してこれらのチェックを実行して構成を検証します。

1. CDC ミラーリングを開始する前に、次のクエリを実行して、すべての前提条件が満たされているかどうかを検証します。 この関数は、さまざまなシステム要件と構成要件をチェックして、サーバーが CDC 操作の準備ができていることを確認します。

-- Check if all prerequisites are met
SELECT * FROM azure_cdc.check_prerequisites();

-- Example output when all checks pass (on mock mode with identity configured):
 status |                                                               data
--------+----------------------------------------------------------------------------------------------------------------------------------
 ERROR  | [{"status": "ERROR", "details": {"current_value": "12", "required_value": "13"}, "status_code": "MAX_WORKER_PROCESSES_TOO_LOW"}]

-- Example output on standby replica:
 status |                                               data
--------+---------------------------------------------------------------------------------------------------
 ERROR  | [{"status": "ERROR", "status_code": "SERVER_IN_RECOVERY"}]

-- Example output when identity not configured:
 status |                                data
--------+---------------------------------------------------------------------
 ERROR  | [{"status": "ERROR", "status_code": "IDENTITY_NOT_CONFIGURED"}]

戻り値：(status text, data jsonb)

• status: 全体的な状態 - すべてのチェックが成功した場合に OK し、いずれかのチェックが失敗した場合に ERROR します
• data: status、 status_code、および省略可能な詳細な状態エントリを含む JSONB 配列 details

状態コード:

2. 次のクエリを実行して、ソース データベース内のテーブルがレプリケーションの対象であるかどうかを検証します。 システム スキーマ (pg_catalog、 information_schema、 pg_toast) と拡張機能所有のテーブルを除外します。

SELECT * FROM azure_cdc.get_all_tables_mirror_status();
 table_schema | table_name | mirroring_status |                      mirroring_data
--------------+------------+------------------+------------------------------------------------------
 public       | customers  | OK               | [{"status": "OK", "status_code": "HAS_PRIMARY_KEY"}]
 public       | orders     | OK               | [{"status": "OK", "status_code": "HAS_UNIQUE_INDEX"}]
 public       | logs       | WARNING          | [{"status": "WARNING", "status_code": "NO_INDEX_FULL_IDENTITY"}]

返されるもの：(table_schema text, table_name text, mirroring_status text, mirroring_data jsonb)のセット

• table_schema: テーブルのスキーマ名
• table_name: テーブルの名前
• mirroring_status: 全体的な状態 - OK、 WARNING、または ERROR
• mirroring_data: status、 status_code、および省略可能な詳細な状態エントリを含む JSONB 配列 details

状態コード:

3. 次のクエリを実行して、システム全体のエラー、パブリケーション固有のエラー、テーブルごとのエラーなど、レプリケーション操作中に検出されたエラーと問題を返します。

-- Get only system-wide errors
SELECT * FROM azure_cdc.get_health_status('', '');

-- Get system-wide errors and publication-specific errors
SELECT * FROM azure_cdc.get_health_status('my_database', 'my_publication');

パラメーター:

• db_name (テキスト): データベース名
• pub_name (テキスト): パブリケーション名

動作：

• 両方のパラメーター (azure_cdc.get_health_status('', '')) の空の文字列で呼び出された場合: システム全体のエラー (エラーの種類 'S') のみを返します。
• 有効なデータベース名とパブリケーション名で呼び出された場合: 指定されたパブリケーションのシステム全体のエラーとパブリケーション/テーブル固有のエラーの両方を返します。

返されるもの：(error_time timestamptz, schema_name text, table_name text, error_type char(1), error_code text, params jsonb) のセット

エラーの種類:

エラー コード:

4. 次のクエリを実行して、パブリケーションが正しく作成され、レプリケーションの変更が正しくフローしているかどうかを確認します。

   select * from azure_cdc.tracked_publications;
   

   パブリケーションがアクティブで、スナップショットが生成されているかどうかを確認します。 次のクエリを実行して、後続の変更バッチが生成されたかどうかを確認することもできます。

   select * from azure_cdc.tracked_batches;
   

5. azure_cdc.tracked_publications ビューに増分変更の処理の進行状況が表示されない場合は、次の SQL クエリを実行して、問題が報告されているかどうかを確認します。

   SELECT * FROM pg_stat_activity WHERE state = 'idle in transaction';
   

6. 報告された問題がない場合は、次のコマンドを実行して、ミラー化された PostgreSQL データベースの現在の構成を確認します。 正しく有効になっていることを確認します。

   SELECT * FROM pg_replication_slots;
   

   ここで探すキー列は slot_name と active です。 t (true) 以外の値は、潜在的な問題を示します。

7. トラブルシューティングが必要な場合は、サポートにお問い合わせください。

マネージド ID

Azure Database for PostgreSQL フレキシブル サーバーのシステム割り当てマネージド ID (SAMI) を有効にする必要があり、プライマリ ID である必要があります。 詳細については、「 PostgreSQL フレキシブル サーバーのシステム割り当てマネージド ID」を参照してください。

有効化後、SAMI 設定の状態が後で無効になった後で再度有効になった場合、Azure Database for PostgreSQL フレキシブル サーバーから Fabric OneLake へのミラーリングは失敗します。

次のクエリで SAMI が有効になっていることを確認します。 show azure.service_principal_id;

「SAMI」のアクセス許可

Azure Database for PostgreSQL フレキシブル サーバーのシステム割り当てマネージド ID (SAMI) の共同作成者権限を、ファブリック ミラー化されたデータベース項目から削除しないでください。

SAMI アクセス許可を誤って削除した場合、Azure Database for PostgreSQL フレキシブル サーバーのミラーリングは想定どおりに機能しません。 ソース データベースから新しいデータをミラー化することはできません。

Azure Database for PostgreSQL フレキシブル サーバー SAMI のアクセス許可を削除した場合、またはアクセス許可が正しく設定されていない場合は、次の手順を使用します。

1. ミラー化されたデータベース項目の ... 省略記号オプションを選択して、フレキシブル サーバー SAMI をユーザーとして追加します。
2. [ アクセス許可の管理] オプションを選択します。
3. Azure Database for PostgreSQL フレキシブル サーバーの名前を入力します。 読み取りと書き込みのアクセス許可を指定します。

関連コンテンツ

• Microsoft Fabric Data Warehouse の制限事項
• Microsoft Fabric での Azure Database for PostgreSQL フレキシブル サーバーのミラーリングに関してよく寄せられる質問