Azure Cosmos DB (プレビュー) からの Microsoft Fabric ミラー データベースの制限事項

この記事では、Microsoft Fabric にミラーされている Azure Cosmos DB アカウントの現在の制限事項について詳しく説明します。 このページの制限事項とクォータの詳細は、今後変更される可能性があります。

可用性

ミラーリングは、Fabric と Azure Cosmos DB の API の特定のリージョン セットでサポートされています。

サポート対象 API

ミラーリングは、ここに記載されている Azure Cosmos DB アカウントの種類でのみ使用できます。

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

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

アカウントとデータベースの制限事項

• ミラーを有効にできるのは、Azure Cosmos DB アカウントが 7 日間または 30 日間の継続的バックアップで構成されている場合のみです。
• Azure Cosmos DB の継続的バックアップ機能に関する現在の制限はすべて、Fabric ミラーにも適用されます。
  • これらの制限事項には一度有効にすると継続的バックアップを無効にできないこと、複数リージョンの書き込みアカウントのサポートが不足していることが含まれていますが、これらに限定されるわけではありません。 詳細については、「Azure Cosmos DB の継続的バックアップの制限事項」を参照してください。
  • 同じ Azure Cosmos DB アカウントで分析ストアと継続的バックアップ機能の両方を有効にすることができます。
• 継続的バックアップが有効になっている Azure Cosmos DB アカウントの分析ストア機能を無効にすることはできません。
• コンテナーの分析ストア機能を以前に無効にした Azure Cosmos DB アカウントでは、継続的バックアップを有効にすることはできません。

セキュリティの制限事項

• Azure Cosmos DB の読み取り/書き込みアカウント キーと、ロールベースのアクセス制御を使用した Microsoft Entra ID 認証は、ソース アカウントに接続するための唯一のサポートされているメカニズムです。 読み取り専用アカウント キーとマネージド ID はサポートされていません。
  • Microsoft Entra ID 認証では、次のロールベースのアクセス制御アクセス許可が必要です。
    • Microsoft.DocumentDB/databaseAccounts/readMetadata
    • Microsoft.DocumentDB/databaseAccounts/readAnalytics
  • 詳細については、 データ プレーンのロールベースのアクセス制御に関するドキュメントを参照してください。
• アカウント キーがローテーションされる場合は、Fabric ミラーリングの接続の資格情報を更新する必要があります。 キーを更新しないと、ミラーリングは失敗します。 このエラーを解決するには、レプリケーションを停止し、新しくローテーションされたキーで資格情報を更新してから、レプリケーションを再開します。
• ワークスペースにアクセスできるファブリック ユーザーは、ミラー データベースへのアクセス権を自動的に継承します。 ただし、ワークスペースとテナント レベルのアクセスを細かく制御して、組織内のユーザーのアクセスを管理できます。
• ミラー データベースは Fabric で直接共有できます。

アクセス許可

• Fabric にビューアーのアクセス許可しかない場合は、SQL 分析エンドポイントでデータをプレビューしたりクエリを実行したりすることはできません。
• データ エクスプローラーを使用する場合、Azure Cosmos DB データ エクスプローラーでは Fabric と同じアクセス許可は使用されません。 データ エクスプローラーを使用してデータを表示およびクエリする要求は、Fabric ではなく Azure にルーティングされます。

ネットワークのセキュリティ

• ソースの Azure Cosmos DB アカウントでは、すべてのネットワークに対してパブリック ネットワーク アクセスを有効にする必要があります。
• プライベート エンドポイントは、Azure Cosmos DB アカウントではサポートされていません。
• AZURE Cosmos DB アカウントでは、IP アドレスやサービス エンドポイントなどの手法や機能を使用したネットワークの分離はサポートされていません。
• OneLake のデータは、プライベート エンドポイント、カスタマー マネージド キー、または二重暗号化をサポートしていません。

データ エクスプローラーの制限事項

• Fabric データ エクスプローラー クエリは読み取り専用です。 既存のコンテナーを表示したり、アイテムを表示したり、アイテムをクエリできます。
• Fabric のデータ エクスプローラーを使用してコンテナーを作成または削除することはできません。
• Fabric のデータ エクスプローラーを使用して項目を挿入、変更、または削除することはできません。
• SQL 分析エンドポイントを他のユーザーと分析用に共有するだけで、ソース データベースの共有を回避できます。
• ミラー データベースのデータ エクスプローラーをオフにすることはできません。

レプリケーションの制限事項

• ミラーリングでは、空白文字またはワイルド カード文字を含むプロパティ名を持つアイテムを持つコンテナーはサポートされていません。 この制限により、特定のコンテナーのミラーリングが失敗します。 同じデータベース内の他のコンテナーは、引き続き正常にミラーリングできます。 これらの無効な文字を削除するようにプロパティ名が更新された場合は、同じデータベースとコンテナーに対して新しいミラーを構成する必要があり、古いミラーを使用することはできません。
• Fabric OneLake は、地理的に最も近い Azure リージョンから Fabric の容量リージョンにミラーします。このシナリオでは、Azure Cosmos DB アカウントに複数の読み取りリージョンがあります。 ディザスター リカバリー シナリオでは、読み取り領域がフェールオーバーして変更される可能性があるため、ミラーリングは自動的にスキャンして新しい読み取り領域を選択します。
• ソース コンテナーの削除操作は、ミラーリングを使用して Fabric OneLake に直ちに反映されます。 Time to Live (TTL) 値を使用した論理的な削除操作はサポートされていません。
• ミラーリングでは、カスタム パーティション分割はサポートされていません。
• ファブリックには、T-SQL に関する既存の制限があります。 詳細については、「T-SQL の制限事項」に関するページを参照してください。

スキーマとデータの変更

• 同様のコンテナーを削除して追加すると、ウェアハウス テーブル内のデータが新しいコンテナーのデータのみに置き換えられます。
• 複数の項目にわたってプロパティ内のデータのタイプを変更すると、レプリケーターは該当する場合にはデータをアップキャストします。 この動作は、ネイティブ デルタ エクスペリエンスと同等です。 サポートされている基準に適合しないデータはすべて null 型になります たとえば、配列プロパティを文字列に変更すると、null 型にアップキャストされます。
• 新しいプロパティを項目に追加すると、ミラーによって新しいプロパティがシームレスに検出され、対応する列がウェアハウス テーブルに追加されます。 項目のプロパティが削除または欠落している場合には、対応するレコードに null 値が設定されます。
• ミラーリングを使用してデータをレプリケートする場合、完全な忠実性や明確に定義されたスキーマはありません。 ミラーリングは、プロパティの変更とデータ型 (許可されている場合) を自動的かつ継続的に追跡します。

入れ子になったデータ

• Azure Cosmos DB 項目の入れ子になった JSON オブジェクトは、ウェアハウス テーブルの JSON 文字列として表されます。
• OPENJSON、CROSS APPLY および OUTER APPLY コマンドを使用して、JSON 文字列データを選択的に展開できます。
  • OPENJSONによる自動スキーマ推論を使用すると、不明または予測不可能な入れ子になったスキーマを使用して、入れ子になったデータをフラット化して探索できます。 詳細については、 入れ子になったデータのクエリを実行する方法を参照してください。
• PowerQuery には、JSON 文字列データを選択的に展開する ToJson が含まれています。
• ミラーリングには、入れ子のレベルに関するスキーマ制約はありません。 詳細については、「Azure Cosmos DB 分析ストアのスキーマの制約」を参照してください。

データ ウェアハウスの制限事項

• ウェアハウスでは、サイズが 8 KB を超える JSON 文字列の列を処理できません。 このシナリオのエラー メッセージは、"JSON テキストが正しく書式設定されていません。予期しない文字 '"' が位置に見つかりました" です。
  • 現在の回避策は、Fabric Lakehouse でミラー化されたデータベースのショートカットを作成し、Spark Notebook を使用してデータのクエリを実行し、この制限を回避することです。
• SQL 分析エンドポイント とウェアハウス テーブルで JSON 文字列として表される入れ子になったデータは、多くの場合、列のサイズが 8 KB を超えるまで増加する可能性があります。 このエラー メッセージが表示された場合、入れ子のレベルとデータ量を監視します。

ミラーリングされる項目に関する制限事項

• ワークスペースで Azure Cosmos DB アカウントのミラーを有効にするには、ワークスペースの管理者ロール、またはメンバー ロールが必要です。
• レプリケーションを停止すると、ミラーリングが完全に無効になります。
• レプリケーションを再度開始すると、すべてのターゲット ウェアハウス テーブルが再シードされます。 この操作は、実質的にゼロからミラーリングを開始します。

フィードバックを送る

現在の制限、機能、問題についてフィードバックを送りたい場合は、fabriccosmosdbmirror@microsoft.com までご連絡ください。

関連するコンテンツ

• Azure Cosmos DB のミラーリング (プレビュー)
• FAQ: Azure Cosmos DBからの Microsoft Fabric ミラー データベース
• トラブルシューティング: Azure Cosmos DB からの Microsoft Fabric ミラーデータベース