Azure Cosmos DB v2 (ベータ版)

まとめ

Item 説明
リリース状態 一般公開
製品 Power BI (データセット)
サポートされている認証の種類 フィード キー

注意

Azure Cosmos DB V2 コネクタのリリースが遅延しています。 Azure Cosmos DB V1 コネクタの使用を継続することをお勧めします。

前提条件

サポートされる機能

  • インポート
  • DirectQuery

Azure Cosmos DB への接続

Azure Cosmos DB データに接続するには:

  1. Power BI Desktop を起動します。

  2. [ホーム] タブで [データを取得] を選びます。

  3. 検索ボックスに「Cosmos DB v2」と入力します。

  4. [Azure Cosmos DB v2] を選び、 [接続] を選びます。

    [Azure Cosmos DB v2] を選びます。

  5. [Azure Cosmos DB v2] 接続ページの [Cosmos Endpoint](Cosmos エンドポイント) に、使用する Azure Cosmos DB アカウントの URI を入力します。 [データ接続モード] では、次の一般的なガイドラインに従って、ご自身のユース ケースに適したモードを選びます。

    • 小さいデータセットの場合は、 [インポート] を選びます。 インポート モードを使用する場合、Power BI は Cosmos DB と連携して、視覚化で使用するデータセット全体の内容をインポートします。

      注意

      [インポート] モードを適切に設定するには、 [Advanced Passdown](高度な引き渡し)[PBI Mode](PBI モード) の両方の詳細設定オプションを 0 に設定する必要があります。 詳細情報: 「詳細設定オプションを使用して接続する

    • 大きなデータセットの場合は、 [DirectQuery] を選びます。 DirectQuery モードでは、データはワークステーションにダウンロードされません。 視覚化を作成または操作するときに、Microsoft Power BI は Cosmos DB と連携して基になるデータ ソースを動的に照会し、常に最新のデータが表示されるようにします。 詳細情報: 「Power BI Desktop の DirectQuery

      注意

      [DirectQuery] モードを適切に設定するには、 [Advanced Passdown](高度な引き渡し)[PBI Mode](PBI モード) の両方の詳細設定オプションを 1 に設定する必要があります。 詳細情報: 「詳細設定オプションを使用して接続する

    Cosmos エンドポイントのエントリと、DirectQuery に設定されたデータ接続モードを表示している接続ダイアログ ボックスの画像。

  6. [OK] を選択します。

  7. データソース認証を構成するプロンプトで、アカウント キーを入力します。 次に、 [接続](Connect) を選択します。

    認証方法を選びます。

    データ カタログ、データベース、テーブルが [ナビゲーター] ダイアログ ボックスに表示されます。

    [ナビゲーター] ダイアログ ボックスにデータが表示されます。

  8. [表示オプション] ペインで、使用するデータセットのチェック ボックスをオンにします。

  9. データセットをインポートする前に変換する場合は、ダイアログ ボックスの下部に移動し、 [データの変換] を選びます。 この選択により、Power Query エディターが開き、使用するデータ セットをフィルター処理して絞り込むことができます。 また、渡された引数を変更することで、コネクタ オプションを微調整することもできます。

    Power Query エディターの接続引数。

  10. それ以外の場合は、 [Load](読み込み) を選びます。 読み込みが完了したら、視覚化を作成できます。 [DirectQuery] を選んだ場合、Power BI では、要求した視覚化について Cosmos DB にクエリが発行されます。

詳細設定オプションを使用して接続する

Power Query Desktop では、必要に応じてクエリに追加できる詳細設定オプションのセットが用意されています。

接続情報を入力します。

次の表に、Power Query Desktop で設定できるすべての詳細設定オプションを示します。

詳細設定オプション 説明
再試行回数 408 - Request Timeout412 - Precondition Failed、または 429 - Too Many Requests の HTTP リターン コードがある場合に再試行する回数。 既定の再試行回数は 5 です。
Advanced Passdown (高度な引き渡し) 可能な場合は常に引き渡します。 false の場合は 0 に、true の場合は 1 に設定します。 既定値は 1 です。
PBI mode (PBI モード) ODBC ドライバーの動作が PBI フローのサポートに合わせて調整されているかどうかを示します。 false の場合は 0 に、true の場合は 1 に設定します。 既定値は 1 です。
プロトコル タイプ Cosmos DB と交換されるデータの形式。 テキストの場合は 0 に、バイナリ データの場合は 1 に設定します。 既定値は 1 です。
Flag indicating if collection schema is explicitly stated as a document (コレクション スキーマがドキュメントとして明示的に指定されているかどうかを示すフラグ) 詳細情報: 「ドキュメント内のスキーマ
Name of the database containing schema document if explicitly specified (明示的に指定されている場合は、スキーマ ドキュメントを含むデータベースの名前) 詳細情報: 「ドキュメント内のスキーマ
Name of the collection containing schema document if explicitly specified (明示的に指定されている場合は、スキーマ ドキュメントを含むコレクションの名前) 詳細情報: 「ドキュメント内のスキーマ
Name of JSON property to use in looking up the schema document (スキーマ ドキュメントの検索に使用する JSON プロパティの名前) 詳細情報: 「ドキュメント内のスキーマ
Value of the JSON property to use in looking up the schema document (スキーマ ドキュメントの検索に使用する JSON プロパティの値) 詳細情報: 「ドキュメント内のスキーマ
Name of JSON property in schema document containing the collection schema (コレクション スキーマを含むスキーマ ドキュメント内の JSON プロパティの名前) 詳細情報: 「ドキュメント内のスキーマ
Flag to indicate if error should be thrown if trying to sort more columns than composite index limit (複合インデックスの制限よりも多くの列を並べ替えようとした場合に、エラーをスローする必要があるかどうかを示すフラグ) 対象のコレクションに、並べ替えられた列のシーケンスと一致する複合インデックスがあるかどうかを検出します。 既定値は 1 (true) です。
Flag to indicate if assistive experience should interject if optimal composite indices aren't defined for Sort Passdown (並べ替えの引き渡しに最適な複合インデックスが定義されていない場合に、補助エクスペリエンスを取り入れる必要があるかどうかを示すフラグ) ドキュメント内のスキーマ」の 6 つのオプションでエラーを検出するときに、複合インデックス定義の JSON をクリップボードにコピーするかどうかを確認するメッセージを表示します。 その後、クリップボードの内容を Cosmos DB ポータルの複合インデックスの定義に貼り付けることができます。 開発フェーズでは、このオプションを使用します。 既定値は 0 (false) です。
Flag to indicate if all fields in sort clause should be passed down (sort 句のすべてのフィールドを引き渡す必要があるかどうかを示すフラグ) sort 句のすべてのフィールドを引き渡す必要があるかどうかを示します。 そうでない場合は、Power BI レポートで並べ替えられたフィールド、または M で指定された最初のフィールドだけが最適化として渡されます。 並べ替えは、コレクションに対して定義されている複合インデックスに依存します。 現在、Cosmos DB コンテナーには、最大 8 つの複合インデックスを定義できます。 既定値は 0 (false) です。
Rest API Version (REST API バージョン) 使用する REST API のバージョンを設定します。 指定できる値は 2015-12-16 または 2018-12-31 です。 既定値は 2018-12-31 です。 この値は、詳細クエリでのみ設定できます。

ドキュメント内のスキーマ

注意

現時点では、このセクションには予備情報が含まれています。 コネクタが正式にリリースされる前に追加情報が追加されます。

コレクション スキーマがドキュメントとして明示的に指定されているかどうかを示すフラグ (既定値は 0 で、ドキュメントとしてのスキーマはありません)

使用例

  • Name of the database containing schema document if explicitly specified (明示的に指定されている場合は、スキーマ ドキュメントを含むデータベースの名前)
  • Name of the collection containing schema document if explicitly specified (明示的に指定されている場合は、スキーマ ドキュメントを含むコレクションの名前)
  • Name of JSON property to use in looking up the schema document (スキーマ ドキュメントの検索に使用する JSON プロパティの名前)
  • Value of the JSON property to use in looking up the schema document (スキーマ ドキュメントの検索に使用する JSON プロパティの値)
  • Name of JSON property in schema document containing the collection schema (コレクション スキーマを含むスキーマ ドキュメント内の JSON プロパティの名前)

指示、制限事項、既知の問題

現在のバージョンの Azure Cosmos DB v2 データへのアクセスに関連する次の指示、制限事項、既知の問題に注意する必要があります。

手順

  • インポート モードでこのコネクタを使用する場合は、 [Advanced Passdown](高度な引き渡し)[PBI Mode](PBI モード) の両方を 0 (ADVANCED_PASSDOWN="0"、PBI_MODE="0") に設定します。
  • レポート開発者モードが有効 (REPORT_DEVELOPER_MODE_ON="1") になっている Power BI サービスでレポートを発行しないでください。
  • DirectQuery モードで新しい大きなコレクションを操作する場合は、次のベスト プラクティスを使用します。
    • レポート開発者モードを一時的に有効 (REPORT_DEVELOPER_MODE_ON="1") にします。 このモードを有効にすると、Cosmos DB からとても小さなデータセットを読み込むことによって、データ レイアウトを検出できます。
    • 必要な複合インデックスを使用してコレクションを準備し、データ シェイプに関連する有用な Data Engineering の側面を決定したら、通常モード (REPORT_DEVELOPER_MODE_ON="0") に戻り、データセット全体を対象とする Data Engineering アクティビティを開始できます。

制限事項

  • レポートは、基になる Cosmos DB コンテナーで定義されているパーティション キーに対してフィルター処理する必要があります。
  • 複数の列 (FULL_SORTING_ON="1") で並べ替える必要がある場合は、並べ替えが Cosmos DB に委任されることを考慮する必要があります。これにより、複合インデックスの一部でないフィールドは並べ替えられません。
  • PBI Desktop でレポートをデザインするときに、必要な複合インデックスの作成を支援するには、レポート開発者モードを有効 (REPORT_DEVELOPER_MODE_ON="1") にする必要があります。これにより、Cosmos DB コレクションの複合インデックスを指定するときに Cosmos DB ポータルに貼り付けることができる JSON テキストをクリップボードにコピーすることを求めるプロンプトが表示されます。

DirectQuery モードの既知の問題

  • 8 列を超えるレポートは、DirectQuery モードでは機能しません。
  • 集計関数は渡されません。 結果として、COUNT や SUM などを渡す SQL 式は失敗し、数値は表示されません。