ファブリック ミラー化されたデータベースのトラブルシューティング

この記事では、Microsoft Fabric ミラー化データベースの一般的なシナリオ、解決策、回避策について説明します。 データ ソースごとに、特定のトラブルシューティング、よく寄せられる質問 (FAQ)、および制限事項も確認します。

ファブリック容量の変更

データが複製されていないように見える

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

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

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

  Azure SQL Database、Azure SQL Managed Instance、Azure Database for MySQL、Azure Database forPostgreSQL などのソースの種類については、特定の手順に従って、ソース データベースの構成と状態も確認します。

• 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 にデータが書き込まれます。

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

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

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

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

データベース ミラーリングとオープン ミラーリングは、すべてのMicrosoft Fabricリージョンで使用できます。 詳細については、「Fabric が使用できるリージョン」を参照してください。

Troubleshoot

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

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

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

ビューはレプリケートされません

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

レプリケートされるテーブルがない

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

変換先テーブルに列がありません

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

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

SQL 分析エンドポイントは、最大 16 MB の varchar(max) をサポートします。

• 2025 年 11 月 18 日以降にミラー化されたデータベースで作成されたテーブルには 16 MB の制限が適用されますが、ミラー化された各アイテムの種類には異なる下限を設定できます。 たとえば、ミラー化されたSQL Serverでは最大 1 MB がサポートされ、Cosmos DB では最大 2 MB がサポートされます。 次の表を参照してください。
• 2025 年 11 月 18 日より前に作成された既存のテーブルは varchar(8000) のみをサポートしており、新しいデータ型を採用し、8 KB を超えるデータをサポートするために再作成する必要があります。

ミラー化されたテーブルまたはスキーマは、ソース データベースに削除しても削除されません

テーブルレベル:

• 選択テーブルの一覧をミラー化することを選択し、ソース テーブルが削除されると、ミラー化されたテーブルは維持され、監視に "ソース テーブルが存在しません" というエラーが表示されます。 このテーブルをレプリケートしなくなった場合は、ミラー化されたデータベース構成を更新して削除すると、ミラー化されたテーブルが削除されます。
• すべてのデータをミラー化することを選択し、ソース テーブルが削除されると、ミラー化されたテーブルも削除されます。

スキーマ レベル: ソース データベースでスキーマを削除しても、SQL Analytics エンドポイントのスキーマは空のスキーマとして表示されます。

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

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

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

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

関連コンテンツ

• ファブリックのミラーリングとは
• Fabric のミラー化データベース レプリケーションを監視する