Microsoft Fabric のミラーリングでは、既存の Azure Cosmos DB データを Fabric の残りのデータと統合するためのシームレスな ETL なしのエクスペリエンスが提供されます。 この記事のヒントは、Fabric で Azure Cosmos DB 用のミラー化されたデータベースを作成するときに発生する可能性がある問題のトラブルシューティングに役立ちます。
Important
Azure Cosmos DB のミラーリングは現在 プレビュー段階です。 運用環境のワークロードは、プレビュー期間中はサポートされません。 現時点では、Azure Cosmos DB for NoSQL アカウントのみがサポートされています。
Azure Cosmos DB データベースを Microsoft Fabric にミラーリングしても期待どおりに動作しない場合に従う一般的な問題と関連するトラブルシューティング手順の一覧を次に示します。
"SQLAPIendpoint" エラーでデータベースを読み込むと、ミラーリングが失敗します。 このエラーを解決するにはどうすればよいですか?
通常、このエラーは、選択した接続に対して Azure Cosmos DB アカウント キーが無効になっていることを示します。 接続資格情報が有効なアカウント キーで更新されたら、もう一度ミラーリングを設定します。
Fabric は、Azure Cosmos DB アカウントに継続的バックアップがないことを示すエラーでミラーリングを構成できません。 このエラーを修正するにはどうすればよいですか?
Azure Cosmos DB アカウントの継続的バックアップを有効にします。 詳細については、 継続的バックアップを使用して Azure Cosmos DB アカウントを作成 する方法、または 既存の Azure Cosmos DB アカウントを継続的バックアップに移行する方法に関するページを参照してください。
継続的バックアップ機能が有効になったら、ファブリック ミラーリングのセットアップに戻り、残りの手順に進みます。
Azure Cosmos DB アカウントで継続的バックアップが有効になっているかどうかを確認するにはどうすればよいですか?
Azure portal を使用すると、Azure Cosmos DB アカウントのリソース メニュー で [ポイントインタイム リストア ] オプションを見つけることで、継続的バックアップ機能が有効になっているかどうかを確認できます。 このオプションを使用できない場合は、アカウントで継続的バックアップが有効になっていないか、アカウントが継続的バックアップに移行しています。
Azure Cosmos DB アカウントで継続的バックアップを有効にすると、さまざまなエラーが発生しています。 ファブリック ミラーリングは引き続き設定できますか?
いいえ。ミラーリング ソースを意図した Azure Cosmos DB アカウントに対して、継続的バックアップを有効にする必要があります。
Azure Cosmos DB アカウントの継続的バックアップを有効にするときにエラー メッセージが表示される場合は、アカウントに機能をブロックする制限がある可能性があります。 たとえば、アカウントの分析ストアを以前に削除した場合、アカウントは継続的バックアップをサポートできません。 このシナリオでは、残りの唯一のオプションは、ミラーリングに新しい Azure Cosmos DB アカウントを使用することです。
[レプリケーションの監視] を選択すると、レプリケーションが機能せず、"内部サーバー エラー" が発生するのはなぜですか?
認証に Entra ID を使用する場合は、必要なロールベースのアクセス制御アクセス許可が追加されていることを確認してください。 詳細については、 Azure Cosmos DB ミラーリングのセキュリティ制限に関するページを参照してください。
そうしないと、レプリケーションが機能する可能性があり、Azure Cosmos DB が Fabric からの要求を調整している場合は、一時的なエラーが発生します。 さらに、この問題の原因となる Azure Cosmos DB でのミラーリングには制限がある可能性があります。 詳細については、 Azure Cosmos DB ミラーリングの制限事項に関するページを参照してください。
Fabric ポータルを更新し、問題が自動的に解決されるかどうかを判断します。 また、影響を受けるコンテナーの選択を解除して再選択して、レプリケーションを停止および再開することもできます。 これらのオプションが機能しない場合は、 サポート チケットを開きます。
Fabric が Azure Cosmos DB からデータをレプリケートしていることを確認するにはどうすればよいですか?
まず、Fabric ミラー化されたデータベースの一般的なトラブルシューティング手順に従います。 詳細については、 トラブルシューティングを参照してください。
ほとんどの場合、[レプリケーションの 監視 ] オプションでは、データが Fabric に正常にレプリケートされているかどうかを示す詳細を提供できます。 一般的なトラブルシューティングの手順では、最後に 更新された時刻 が最新かどうかを確認します。 時刻が最新でない場合は、次の手順としてレプリケーションを停止してから再起動します。 "最後に更新された時刻" は、レプリケーションに関してメモした時刻以降にソース データベースが変更された場合にのみ更新されることに注意してください。 ソース データベースに更新、削除、挿入がない場合、"最終更新時刻" は更新されません。
[レプリケーションの監視] ウィンドウには、かなりの時間が経過した後にレプリケートされた行がないテーブルが含まれています。 レプリケーションが停止していますか?
レプリケーションが停止している可能性があります。 影響を受けるコンテナーの選択を解除し、再度選択して、最初の手順としてレプリケーションを再開します。 この手順が機能しない場合は、 サポート チケットを開きます。
SQL 分析エンドポイントにテーブルが見つからないのはなぜですか?
まず、スキーマと dbo ノードを更新して、テーブルの準備ができているかどうかを判断します。 テーブルは準備ができたら自動的に読み込まれます。 かなりの時間が経過してもテーブルの準備ができていない場合は、[ レプリケーションの監視 ] ウィンドウを使用して、レプリケーション エラーが発生したかどうかを確認します。
レプリケート後にターゲット ウェアハウス テーブルに '_rid' 列のみが含まれるのはなぜですか?
まず、スキーマと dbo ノードを更新して、テーブルの準備ができているかどうかを判断します。 テーブルは準備ができたら自動的に読み込まれます。 大量の時間が経過しても準備ができていない列が増える場合は、[ レプリケーションの監視 ] ウィンドウを使用して、レプリケーション エラーが発生したかどうかを確認します。
Azure Cosmos DB データベースのコンテナーに新しい項目を追加しました。 これらの項目は、SQL 分析エンドポイント クエリの結果には含まれません。 レプリケーションが機能しているかどうかを確認する方法
Monitor レプリケーション オプションでは、データが Fabric に正常にレプリケートされているかどうかを示す詳細を提供できます。 一般的なトラブルシューティングの手順では、最後に 更新された時刻 が最新かどうかを確認します。 時刻が最新でない場合は、次の手順としてレプリケーションを停止してから再起動します。 時刻が最新の場合は、クエリをもう一度試してください。 場合によっては、Azure Cosmos DB にデータが挿入されてから、そのデータがレプリケートされて Fabric で使用できるようになるまで、遅延が発生することがあります。
データがまだ使用できない場合は、Lakehouse を使用してショートカットを作成し、ノートブックから Spark クエリを実行します。 Spark では常に最新のデータが表示されます。 データが Spark で使用できるが、SQL 分析では使用できない場合は、 サポート チケットを開きます。
Spark でもデータを使用できない場合は、レプリケーションの待機時間に意図しない問題が発生する可能性があります。 しばらく待ってから、レプリケーションを再試行します。 問題が解決しない場合は、 サポート チケットを開きます。
"JSON テキストが正しく書式設定されていません。 SQL 分析エンドポイントに対して T-SQL クエリを実行すると、予期しない文字 '"' が位置に見つかりました" というエラー メッセージが表示されますか?
データ ウェアハウスでは、サイズが 8 KB を超える JSON 文字列列を処理できません。 SQL 分析エンドポイントまたはウェアハウス テーブルで JSON 文字列として表される入れ子になったデータは、通常、列のサイズが 8 KB を超えるまで増加する可能性があります。 入れ子のレベルと、このエラー メッセージが表示された場合のデータ量を監視します。 詳細については、 データ ウェアハウスの制限事項を参照してください。
Cosmos DB ミラーリングでは、特殊文字を含む列名はサポートされていますか?
はい。空白を含む列名や、 =, ;, {}, (), \n, \t などのワイルドカード文字がサポートされています。