この記事では、Microsoft Fabric にミラー化された Azure Cosmos DB アカウントの現在の制限について詳しく説明します。 このページの制限事項とクォータの詳細は、今後変更される可能性があります。
Important
Azure Cosmos DB のミラーリングは現在 プレビュー段階です。 運用環境のワークロードは、プレビュー期間中はサポートされません。 現時点では、Azure Cosmos DB for NoSQL アカウントのみがサポートされています。
可用性の制限事項
ミラーリングは、Fabric と Azure Cosmos DB の API の特定のリージョン セットでサポートされています。
ミラーリングは、ここに記載されている Azure Cosmos DB アカウントの種類でのみ使用できます。
在庫有り NoSQL 用 API イエス MongoDB 用 API (RU ベース) いいえ MongoDB 用 API (仮想コアベース) いいえ Apache Gremlin 用 API いいえ テーブル用 API いいえ API for Apache Cassandra (RU ベース) いいえ Managed Instance for Apache Cassandra いいえ -
データベース ミラーリングとオープン ミラーリングは、すべての Microsoft Fabric リージョンで利用できます。 詳細については、「Fabric が使用できるリージョン」を参照してください。
アカウントとデータベースの制限事項
ミラーリングを有効にできるのは、Azure Cosmos DB アカウントが 7 日間または 30 日間の連続バックアップで構成されている場合のみです。
Azure Cosmos DB の継続的バックアップ機能に関する現在の制限はすべて、ファブリック ミラーリングにも適用されます。
これらの制限事項には以下が含まれますが、これらに限定されるわけではありません。一度有効にすると継続的バックアップを無効にできないことと、複数リージョンの書き込みアカウントのサポートが不足しています。 詳細については、 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/readMetadataMicrosoft.DocumentDB/databaseAccounts/readAnalytics
注
詳細については、 データ プレーンのロールベースのアクセス制御に関するドキュメントを参照してください。
カスタム ロールベースのアクセス制御ロールを自動適用するスクリプトの例については、azure-samples/azure-cli-samples の
rbac-cosmos-mirror.shを参照してください。アカウント キーがローテーションされる場合は、Fabric ミラーリングの接続資格情報を更新する必要があります。 キーを更新しないと、ミラーリングは失敗します。 このエラーを解決するには、レプリケーションを停止し、新しくローテーションされたキーで資格情報を更新してから、レプリケーションを再開します。
ワークスペースにアクセスできるファブリック ユーザーは、ミラー データベースへのアクセス権を自動的に継承します。 ただし、ワークスペースとテナント レベルのアクセスを細かく制御して、組織内のユーザーのアクセスを管理できます。
ミラー化されたデータベースは Fabric で直接共有できます。
ソースの Azure Cosmos DB アカウントでは、すべてのネットワークに対してパブリック ネットワーク アクセスを有効にする必要があります。
プライベート エンドポイントは、Azure Cosmos DB アカウントではサポートされていません。
AZURE Cosmos DB アカウントでは、IP アドレスやサービス エンドポイントなどの手法や機能を使用したネットワーク分離はサポートされていません。
OneLake のデータは、プライベート エンドポイント、カスタマー マネージド キー、または二重暗号化をサポートしていません。
アクセス許可の制限事項
Fabric にビューアーのアクセス許可しかない場合は、SQL 分析エンドポイントでデータをプレビューしたりクエリを実行したりすることはできません。
データ エクスプローラーを使用する場合、Azure Cosmos DB データ エクスプローラーでは Fabric と同じアクセス許可は使用されません。 データ エクスプローラーを使用してデータを表示およびクエリする要求は、Fabric ではなく Azure にルーティングされます。
データ エクスプローラーの制限事項
Fabric Data Explorer クエリは読み取り専用です。 既存のコンテナー、アイテム、クエリ アイテムを表示できます。
Fabric のデータ エクスプローラーを使用してコンテナーを作成または削除することはできません。
Fabric のデータ エクスプローラーを使用して項目を挿入、変更、または削除することはできません。
SQL 分析エンドポイントを他のユーザーと分析用に共有するだけで、ソース データベースの共有を回避できます。
ミラー化されたデータベースのデータ エクスプローラーをオフにすることはできません。
レプリケーションの制限事項
ミラーリングでは、空白文字またはワイルドカード文字を含むプロパティ名を持つ項目を含むコンテナーはサポートされていません。 この制限により、特定のコンテナーのミラーリングが失敗します。 同じデータベース内の他のコンテナーでも、正常にミラーリングできます。 これらの無効な文字を削除するようにプロパティ名が更新された場合は、同じデータベースとコンテナーに対して新しいミラーを構成する必要があり、古いミラーを使用することはできません。
Fabric OneLake は、Azure Cosmos DB アカウントに複数の読み取りリージョンがあるシナリオで、地理的に最も近い Azure リージョンから Fabric の容量リージョンにミラーリングします。 ディザスター リカバリーシナリオでは、読み取りリージョンがフェールオーバーおよび変更される可能性がある場合に、ミラーリングによって自動的にスキャンされ、新しい読み取りリージョンが取得されます。
ソース コンテナーの削除操作は、ミラーリングを使用して Fabric OneLake に直ちに反映されます。 Time to Live (TTL) 値を使用した論理的な削除操作はサポートされていません。
ミラーリングでは、カスタム パーティション分割はサポートされていません。
ファブリックには、T-SQL に関する既存の制限があります。 詳細については、 T-SQL の制限事項を参照してください。
スキーマとデータの変更の制限事項
同様のコンテナーを削除して追加すると、ウェアハウス テーブル内のデータが新しいコンテナーのデータのみに置き換えられます。
プロパティ内のデータ型を複数の項目にわたって変更すると、レプリケーターは該当する場合にデータをアップキャストします。 この動作は、ネイティブデルタエクスペリエンスと同等です。 サポートされている条件に適合しないデータは、null 型になります。 たとえば、配列プロパティを文字列に変更すると、null 型にアップキャストされます。
項目に新しいプロパティを追加すると、ミラーリングによって新しいプロパティがシームレスに検出され、対応する列がウェアハウス テーブルに追加されます。 項目のプロパティが削除または欠落している場合は、対応するレコードに null 値が設定されます。
ミラーリングを使用してデータをレプリケートする場合、完全な忠実性や明確に定義されたスキーマはありません。 ミラーリングは、プロパティの変更とデータ型 (許可されている場合) を自動的かつ継続的に追跡します。
入れ子になったデータの制限事項
Azure Cosmos DB 項目の入れ子になった JSON オブジェクトは、ウェアハウス テーブルの JSON 文字列として表されます。
OPENJSON、CROSS APPLY、OPENJSONなどのコマンドを使用して、JSON 文字列データを選択的に展開できます。-
OPENJSONによる自動スキーマ推論を使用すると、不明または予測不可能な入れ子になったスキーマを使用して、入れ子になったデータをフラット化して探索できます。 詳細については、 入れ子になったデータのクエリを実行する方法を参照してください。
-
PowerQuery には、JSON 文字列データを選択的に展開するための
ToJsonが含まれています。ミラーリングには、入れ子のレベルに関するスキーマ制約はありません。 詳細については、「 Azure Cosmos DB 分析ストアスキーマの制約」を参照してください。
データ ウェアハウスの制限事項
Warehouse では、サイズが 8 KB を超える JSON 文字列列を処理できません。 このシナリオのエラー メッセージは 、"JSON テキストが正しく書式設定されていません。予期しない文字 '"' が位置に見つかりました"。
- 現在の回避策は、Fabric Lakehouse でミラー化されたデータベースのショートカットを作成し、Spark Notebook を使用してデータのクエリを実行し、この制限を回避することです。
SQL 分析エンドポイントとウェアハウス テーブルで JSON 文字列として表される入れ子になったデータは、通常、列のサイズが 8 KB を超えるまで増加する可能性があります。 入れ子のレベルと、このエラー メッセージが表示された場合のデータ量を監視します。
ミラーリングされる項目に関する制限事項
ワークスペースで Azure Cosmos DB アカウントのミラーリングを有効にするには、ワークスペースの 管理者 ロールまたは メンバー ロールが必要です。
レプリケーションを停止すると、ミラーリングが完全に無効になります。
レプリケーションを再度開始すると、すべてのターゲット ウェアハウス テーブルが再シードされます。 この操作は、実質的にゼロからミラーリングを開始します。