プレビュー機能: Azure Cosmos DB for NoSQL データ プロバイダー要件

  • [アーティクル]

このトピックでは、Azure Cosmos DB for NoSQL データ プロバイダーの要件、および仮想テーブルが含まれる Azure Cosmos DB for NoSQL データ プロバイダーを使用するときに推奨されるベスト プラクティスを構成する方法について説明します。

重要

  • プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。 これらの機能を公式リリースの前に使用できるようにすることで、顧客が一足先にアクセスし、そこからフィードバックを得ることができます。
  • この機能は変更される予定であるため、運用環境では使用しないでください。 開発環境およびテスト環境に限ってご使用ください。
  • マイクロソフトはこのプレビュー機能のサポートを提供しません。 Microsoft Dynamics 365 テクニカル サポートでは、問題や質問への対応ができません。 プレビュー機能は運用環境での使用を想定しておらず、別個の追加使用条件が適用されます。

Cosmos DB Azure とは何ですか ?

Azure Cosmos DB は、ミッションクリティカルなアプリケーションのための Microsoft のグローバル分散マルチモデル データベース サービスです。 これは、スキーマのない JSON データ全体で豊富でよく知られた SQL クエリ機能に一貫性のある低遅延を提供します。 詳細: Azure Cosmos DB の概要: Azure Cosmos DB for NoSQL

要件

  • Azure Cosmos DB を含む Azure サブスクリプション。
  • Azure Cosmos DB for NoSQL コレクション。
  • Azure Cosmos DB データベース タイプは SQL である必要があります。

データの種類のマッピング

次の JSON 構造を持つ受注という名前のコレクションに Azure Cosmos DB ドキュメントがあるとします。

例 JSON for Azure Cosmos DB for NoSQL ドキュメント。

このテーブルは、Microsoft Dataverse を持つ 注文 コレクション内の Azure Cosmos DB for NoSQL ドキュメントのデータ タイプ マッピングを示します。

Azure Cosmos DB for NoSQL データ Dataverse
id Primary Key
name 1 行テキスト
quantity 整数
orderid 1 行のテキスト
ordertype 選択肢
amount 少数または通貨
delivered はい/いいえ
datetimeoffset 日時

注意

  • アンダースコア (_) 接頭辞の付いた属性は、Azure Cosmos DB for NoSQL によって生成されます。
  • Azure Cosmos DB for NoSQL ドキュメントで任意として構成され、ビジネスに必須 として Dataverse にマップされている属性は、ランタイム エラーが発生する原因になります。
  • ID 属性値は GUID である必要があります。

サポートされる SQL クエリのフィルター処理

SQL クエリのフィルター処理は次の演算子をサポートします。

  • 比較演算子:<、>、<=、>=、!=
  • 論理演算子: and、or
  • 集合演算子: in、not in
  • 文字列演算子: like、contains、begins with、ends with

注意

like 演算子の使用は、同等の contains/begins with/ends with 演算子に変換されます。 Azure Cosmos DB for NoSQL は、トピック 類似 (Transact-SQL) で説明されているパターン引数をサポートしません。 Azure Cosmos DB for NoSQL データ プロバイダーは、単一の特殊なケース Like('[aA]%') を BeginsWith('a') または BeginsWith('A') に変換できます。 Azure Cosmos DB for NoSQL の文字列比較は、大文字と小文字が区別されることに注意してください。

Azure Cosmos DB for NoSQL データ プロバイダーを使用してデータ ソースを追加する

  1. AppSource に移動して、今すぐ取得を選択し、指示に従って v9x 以降を使用する環境にアプリケーションを追加します。

  2. ソリューションがインストールされた後に、 環境サインインし、設定 > 管理 > 仮想エンティティ データ ソースの順に移動します。

  3. 操作ツール バーで 新規を選択して、データ プロバイダーの選択 ダイアログ ボックスで Azure Cosmos DB for SQL API データ プロバイダーを選択し、OK を選択します。 Azure Cosmos DB for NoSQL データ プロバイダーを選択します。

  4. 以下の情報を入力し、保存して閉じるを選択します。

    カラム グラフ 内容
    名前 データ ソースを説明する名前を入力します。
    コレクション名 仮想テーブルで公開するコレクションを含む Azure Cosmos DB データベース コレクションの名前。
    認証キー Azure Cosmos DB アカウントの主キーまたは予備キー。 Azure Cosmos DB アカウントのキー設定の下にある Azure 管理用ポータルからキーを見つけることができます。
    Uri Azure Cosmos DB コレクションがあるリソース グループの URI。 URI は https://contoso/documents.azure.com:443 と同様に作成されます。 Azure Cosmos DB アカウントのキー設定の下にある Azure 管理用ポータルから URI を見つけることができます。
    タイムアウト (秒) データ リクエストがタイムアウトする前に Azure Cosmos DB サービスからの応答を待機する時間を秒数で入力します。たとえば、タイムアウトが発生する前に最大 30 秒待つには、30 を入力します。 既定のタイムアウトは 120 秒です。

    Azure Cosmos DB for NoSQL データ プロバイダーを使用してデータ ソースを作成する。

ベスト プラクティスと制限

  • Azure Cosmos DB をデータ ソースとして使用するときは、以下に注意します。
    • 各 Azure Cosmos DB データ ソースは、1 つの仮想テーブルにのみ関連付けることができます。
    • 複数のデータ ソースを Azure Cosmos DB インスタンス内の同じコレクションに接続できます。
  • コレクション内のデータをテーブルでセグメント化できません。
  • Azure Cosmos DB データベースはスキーマを必要としませんが、Azure Cosmos DB 内のデータは予測可能なスキーマを使用して構造化する必要があります。
  • Azure Cosmos DB for NoSQL データ プロバイダーは、プロジェクション、フィルター処理、および並べ替え演算子を実装しますが、結合処理はサポートしません。
  • Azure Cosmos DB for NoSQL では 1 つの列でのみフィルター処理できます。

参照

外部データ ソースからのデータを含む仮想テーブルの作成および編集

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。