Microsoft Fabric のミラーリングでは、既存の Azure Cosmos DB データを Fabric の残りのデータと統合するためのシームレスな ETL なしのエクスペリエンスが提供されます。 この記事のヒントは、Fabric で Azure Cosmos DB 用のミラー データベースを作成するときに発生する可能性がある問題のトラブルシューティングに役立ちます。
重要
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 アカウントを継続的バックアップに移行する」をご覧ください。
継続的バックアップ機能が有効になったら、Fabric ミラーリング セットアップに戻り、残りの手順に進みます。
どうすれば、Azure Cosmos DB アカウントで継続的バックアップが有効になっているかどうかを確認できますか?
Azure portal を使用すると、Azure Cosmos DB アカウントのリソース メニューで [ポイントインタイム リストア] オプションを確認することで、継続的バックアップ機能が有効になっているかどうかをチェックできます。 このオプションを使用できない場合は、アカウントで継続的バックアップが有効になっていないか、アカウントが継続的バックアップに移行中です。
Azure Cosmos DB アカウントで継続的バックアップを有効にすると、さまざまなエラーが発生しています。 この状態で Fabric のミラーリングを設定することはできますか?
いいえ。継続的バックアップは、ミラーリングソースであることを意図した Azure Cosmos DB アカウントに対して有効にする必要があります。
Azure Cosmos DB アカウントの継続的バックアップを有効にするときにエラー メッセージが表示される場合は、アカウントの制限により、機能がブロックされている可能性があります。 たとえば、アカウントの分析ストアを以前に削除した場合、アカウントは継続的バックアップをサポートできません。 このシナリオで唯一他にできることは、新しい 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 分析エンドポイント クエリの結果には含まれません。 どうすれば、レプリケーションが機能しているかどうかを判断できますか?
[レプリケーションの監視] オプションにより、データが Fabric に正常にレプリケートされているかどうかを示す詳細を確認できます。 一般的なトラブルシューティングの手順は、最終更新時刻が最新かどうかをチェックすることです。 時刻が最新でない場合は、次の手順として、レプリケーションを停止してから再起動します。 時刻が最新の場合は、クエリをもう一度試してください。 場合によっては、Azure Cosmos DB にデータが挿入されてから、そのデータがレプリケートされて Fabric で使用できるようになるまで、遅延が発生することがあります。
データがまだ使用できない場合は、Lakehouse を使用してショートカットを作成し、ノートブックから Spark クエリを実行します。 Spark では常に最新のデータが表示されます。 データが Spark で使用できても、SQL 分析では使用できない場合は、サポート チケットを開始してください。
Spark でもデータを使用できない場合は、レプリケーションの待機時間に意図しない問題が発生している可能性があります。 しばらく待ってから、レプリケーションを再試行します。 問題が解決しない場合は、サポート チケットを開始してください。
SQL 分析エンドポイントに対して T-SQL クエリを実行すると、"JSON テキストが正しく書式設定されていません。 予期しない文字 '"' が位置に見つかりました" というエラー メッセージが表示されます。理由を教えてください。
データ ウェアハウスでは、サイズが 8 KB を超える JSON 文字列列を処理できません。 SQL 分析エンドポイント、またはウェアハウス テーブルで JSON 文字列として表される入れ子になったデータは、多くの場合、列のサイズが 8 KB を超えるまで増加する可能性があります。 このエラー メッセージが表示された場合、入れ子のレベルとデータ量を監視します。 詳細については、「データ ウェアハウスの制限事項」を参照してください。
[レプリケーションの監視] ウィンドウに "列名が無効です" というエラーが表示されるのはなぜですか?
ミラーリングでは、空白文字またはワイルド カード文字を含むプロパティ名を持つアイテムを持つコンテナーはサポートされていません。 この制限により、特定のコンテナーのミラーリングが失敗します。 同じデータベース内の他のコンテナーは、引き続き正常にミラーリングできます。 詳細については、「レプリケーションの制限事項」を参照してください。