Fabric のミラー化されたデータベースのトラブルシューティング

2025-07-03

Microsoft Fabric のミラー化されたデータベースのシナリオ、解決策、回避策。

リソース

各データソースのよくあるご質問のトラブルシューティングセクションを確認します。

各データソースの制限事項に関するドキュメントを確認します。

Fabric容量の変更

シナリオ	説明
Fabric 容量が一時停止された	ミラーリングが停止し、ミラー化されたデータベース項目の一覧表示やそれに対するアクセスができません。その容量をワークスペースに復元または再割り当てします。
Fabric の容量が再開された	既知の制限: 一時停止状態から容量が再開されると、ミラー化されたデータベースの状態は実行中と表示されますが、ミラーリングは自動的に開始されません。その結果、ソースに加えられた変更は OneLake にレプリケートされません。ミラーリングを再開するには、Fabric ポータルでミラー化されたデータベースに移動し、[レプリケーションの構成] を選択し、[変更の適用] をクリックします。ミラーリングは、一時停止された場所から続行されます。容量が長時間にわたり一時停止されている場合、ミラーリングが停止ポイントから再開されず、最初からデータが再シードされることに注意してください。たとえば、データベースのトランザクションログがいっぱいの場合に発生する可能性があります。
Fabric の容量のスケーリング	ミラーリングは続行されます。容量をスケールダウンする場合は、ミラー化されたデータの OneLake ストレージが容量サイズに基づいて上限まで解放されるので、容量をスケールダウンすると、追加のストレージ料金が発生する可能性があることに注意してください。詳細については、ミラーリングのコストに関するページを参照してください。
Fabric 容量が調整された	過負荷状態が終わるまで待つか、容量を更新します。容量が復旧された後、ミラーリングは続行します。詳しくは、「過負荷状況から回復するために実行できるアクション」をご覧ください。
ファブリック試用版の容量が期限切れになった	ミラーリングが停止します。ミラー化されたデータベースを保持するには、Fabric 容量を購入します。詳細については、Fabric 試用版の容量の有効期限に関する記事を参照してください。

データがレプリケートされていないように見える

ミラー化されたデータの表示に遅延が発生する場合は、次の項目を確認してください。

ミラーリングの状態: ミラー化されたデータベースの Fabric ポータル監視ページで、ミラー化されたデータベースと特定のテーブルの状態と、ファブリックがミラー化されたテーブルをソースから最後に更新した時刻を示す [最終完了] 列を確認します。 "空の状態は、テーブルがまだミラー化されていないことを意味します。"

ワークスペースの監視を有効にした場合は、ミラーリングされたReplicatorBatchLatencyから値に対してクエリを実行することで、ミラーリング実行の待機時間も確認できます。

Azure SQL Database、Azure SQL Managed Instance、Azure Database for PostgreSQL などのソースの種類については、特定の指示に従って、ソースデータベースの構成と状態も確認します。
OneLake のデータ: ミラーリングでは、Delta Lake テーブル形式でデータが OneLake に継続的にレプリケートされます。データが OneLake に正しく配置されているかどうかを検証するには、ミラー化されたテーブルから Lakehouse へのショートカットを作成し、Spark クエリを使用してノートブックを構築してデータを照会できます。詳細については、ノートブックを使用した探索に関するページを参照してください。
SQL 分析エンドポイント内のデータ: ミラー化されたデータへのショートカットを使用して、ミラー化されたデータベースまたは Lakehouse の SQL 分析エンドポイントを使用して、ミラー化されたデータのクエリを実行できます。遅延が表示されたら、先に説明したように、OneLake でミラーリングの状態とデータを検証します。データが OneLake に表示され、SQL 分析エンドポイントに表示されない場合は、SQL 分析エンドポイントでのメタデータ同期の遅延が原因である可能性があります。

メタデータの自動スキャンを手動で強制的に更新できます。 SQL 分析エンドポイントのページで、次の図に示すように [更新 ] ボタンを選択します。しばらく待ってから、もう一度データのクエリを実行して確認します。

レプリケーションの停止

[レプリケーションの停止] を選択すると、OneLake ファイルはそのままですが、増分レプリケーションは停止します。 [レプリケーションの開始] を選択すると、いつでもレプリケーションを再開できます。レプリケーションの状態をリセットするとき、ソースデータベースが変更された後、またはトラブルシューティングツールとして、レプリケーションを停止または開始する必要がある場合があります。

ソーススキーマ階層をレプリケートする

さまざまな種類のソースデータベースのデータをミラー化する場合、ソーススキーマ階層はミラー化されたデータベースに保持されます。これにより、データが異なるサービス間で一貫して整理され続け、SQL 分析エンドポイント、Spark Notebook、セマンティックモデル、およびデータへのその他の参照で同じロジックを使用してデータを使用できるようになります。

この機能を有効にする前に作成されたミラー化されたデータベースの場合は、ミラー化されたデータベースでソーススキーマがフラット化され、スキーマ名がテーブル名にエンコードされていることがわかります。 スキーマを使用してテーブルを再構成する場合は、ミラー化されたデータベースを再作成します。

API を使用してミラー化されたデータベースを作成または更新する場合は、ソースデータベースからスキーマ階層をレプリケートするかどうかを示すプロパティ defaultSchema の値を設定します。 Microsoft Fabric ミラーリングパブリック REST API の定義サンプルを参照してください。

デルタ列マッピングのサポート

ミラーリングでは、ソースデータベースからミラー化されたデータベースへの、名前 (,;{}()\n\t=など) のスペースまたは特殊文字を含む列のレプリケートがサポートされています。ミラーリングでは、バックグラウンドで Delta 列マッピングが有効になっている OneLake にデータが書き込まれます。

この機能が有効になる前に既にレプリケーション中のテーブルの場合、特殊文字を含む列を名前に含めるには、これらのテーブルを削除して再追加してミラー化されたデータベース設定を更新するか、ミラー化されたデータベースを停止して再起動する必要があります。

ミラー化されたデータベースの所有権を取得する

現在、ミラー化されたデータベースでは所有権の変更はサポートされていません。アイテムの所有者が組織を離れたためにミラー化されたデータベースの動作が停止した場合、または無効になった場合は、ミラー化されたデータベースを再作成する必要があります。

サポートされているリージョン

データベースミラーリングとオープンミラーリングをサポートする Fabric リージョンを次に示します。

アメリカ:

ブラジル南部
カナダ中部
カナダ東部
米国中部
米国東部
米国東部 2
米国中北部
米国中南部
米国西部
米国西部 2
米国西部 3

アジア太平洋:

東アジア
東南アジア
オーストラリア東部
オーストラリア南東部
インド中部
インド南部
東日本
韓国中部

ヨーロッパ、中東、アフリカ:

北ヨーロッパ
西ヨーロッパ
フランス中部
ドイツ中西部
イタリア北部
ノルウェー東部
ポーランド中部
南アフリカ北部
スウェーデン中部
スイス北部
スイス西部
アラブ首長国連邦北部
英国南部
英国西部

トラブルシューティング

このセクションでは、ミラーリングの一般的なトラブルシューティング手順について説明します。

ソースデータベースに接続できない

接続の詳細が正しいこと、サーバー名、データベース名、ユーザー名、パスワードを確認します。
サーバーがファイアウォールまたはプライベート仮想ネットワークの内側にないことを確認します。適切なファイアウォールのポートを開きます。
- 一部のミラー化されたソースでは、仮想ネットワークデータゲートウェイまたはオンプレミスデータゲートウェイがサポートされています。この機能のサポートについては、ソースのドキュメントを参照してください。

ビューがレプリケートされていない

現在、ビューはサポートされていません。通常のテーブルのレプリケートのみがサポートされています。

テーブルが複製されていません

監視の状態を確認して、テーブルの状態をチェックします。詳細については、「Fabric ミラー化データベースレプリケーションを監視する」を参照してください。
[レプリケーションの構成] ボタンを選択します。テーブルがテーブルの一覧に存在するかどうか、または各テーブルの詳細に関するアラートが存在するかどうかを確認します。

コピー先テーブルにいくつかの列が欠けている

[レプリケーションの構成] ボタンを選択します。
列がレプリケートされていない場合は、テーブルの詳細の横にある [アラート] アイコンを選択します。

列のデータの一部が切り捨てられているように見える

SQL 分析エンドポイントは、VARCHAR(max) をサポートしておらず、現在サポートしているのは VARCHAR(8000) のみです。

ソースデータベースを変更できない

ソースデータベースの変更はサポートされていません。新しいミラー化データベースを作成してください。

エラーメッセージを制限する

これらの一般的なエラーメッセージには、説明と軽減策があります。

エラーメッセージ	理由	軽減策
"テーブル数が制限を超えている可能性があり、一部のテーブルが欠落している可能性があります。"	最大 500 個のテーブルがあります。	ソースデータベースで、テーブルをドロップまたはフィルター処理します。新しいテーブルが 500 番目のテーブルの場合、軽減策は必要ありません。
"レプリケーションは調整中であり、YYYY-MM-DDTHH:MM:ss で続行する予定です。"	1 日あたり、ミラー化されたデータベースごとに最大 1 TB の変更データがキャプチャされます。	調整が終了するまで待ちます。

次の方法で共有