Denodo
Note
次のコネクタの記事は、このコネクタの所有者であり、Microsoft Power Query コネクタ認定プログラムのメンバーである Denodo によって提供されています。 この記事の内容に関して質問がある場合、またはこの記事に加えてほしい変更がある場合は、Denodo Web サイトにアクセスし、そこにあるサポート チャネルをご利用ください。
まとめ
| 項目 | 説明 |
|---|---|
| リリース状態 | 一般提供 |
| 製品 | Power BI (セマンティック モデル) Power BI (データフロー) ファブリック (データフロー Gen2) |
| サポートされている認証の種類 | Basic Windows |
Note
デプロイ スケジュールにより、またホスト固有の機能があることにより、ある製品に存在する機能が他の製品にはない場合があります。
前提条件
このコネクタを使用するには、Denodo プラットフォームをインストールし、そのサービスを構成して開始しておく必要があります。 ODBC DSN を使用した接続の場合は、ODBC データ ソース アドミニストレーターで接続を正しく構成しておく必要があります。
サポートされる機能
- インポート
- DirectQuery (Power BI セマンティック モデル)
Power Query デスクトップから ODBC データ ソースへの接続
接続するには、以下の手順を実行します。
データに接続するには、ホーム リボンから データの取得 を選択し、 データベース セクションで Denodo を選択します。
選択したデータ ソースに接続するには 2 つの方法があります。
- DSN経由（ODBCデータソース名）
- 接続文字列の使用
[Denodo コネクタ] ダイアログ ボックスの [DSN または接続文字列] セクションで、データ ソース名 (DSN) または 接続文字列 を入力します。 好みの接続の種類に応じて異なります。
![[Denodo コネクタ] ダイアログ。](media/denodo/denodo-connector.png)
Denodo 互換の接続文字列を作成するときは、Driver フィールドを省略する必要があることを考慮する必要があります。これは、コネクタ自体によって接続時に透過的に設定されるためです。
接続文字列には、SERVER、PORT、およびDATABASE の 3 つの必須パラメータが含まれている必要があります。
SERVER=<Server name>;PORT=<Port number>;DATABASE=<Database name>さらに、オプションのパラメータ SSLmode を含めることができます。
SERVER=<Server name>;PORT=<Port number>;DATABASE=<Database name>;SSLmode=<SSL mode>認証は後の手順で構成するため、認証パラメータは省略する必要があります。
Note
接続文字列を記述するときは、次の点を考慮する必要があります。
- 接続文字列は、パラメータ (SERVER、PORT、DATABASE、および SSLMode) の正しい順序を維持する必要があります。
- これらのパラメータの名前は常に同じ方法で記述する必要があります。 たとえば、大文字で記述することを選択した場合は、常に大文字で記述する必要があります。 大文字で書く場合 (単語の最初の文字を大文字で残りの文字を小文字で書く)、常にそのように書かなければなりません。
そうしないと、Power BI がレポート内の異なる Denodo データ セットを同じ Denodo データ ソースに属するものとして認識できなくなり、その結果、それぞれに対して個別の認証資格情報が要求される可能性があります。
2 番目のセクション デバッグ モードを有効にするは、ログ ファイルにトレース情報を追加できるオプションのフィールドです。 これらのファイルは、オプションメニューの 診断タブを使用してアプリケーションでトレースを有効にすると、Power BI Desktop によって作成されます。 デバッグ モードを有効にする のデフォルト値は false であり、このシナリオでは、Denodo Power BI カスタム コネクタからのログ ファイルにトレース データが存在しないことに注意してください。
3 番目のセクション ネイティブ クエリ は、クエリを入力できるオプションのフィールドです。 このクエリ フィールドを使用すると、結果として得られるデータ セットは、テーブルまたはテーブルのセットではなく、クエリの結果になります。
データソースが関連付けられているデータベースのうち 1 つだけを照会するクエリを作成できます。
SELECT title, name FROM film JOIN language ON film.language_id = language.language_id WHERE film.language_id = 1複数のデータベースを照会するクエリを作成する場合は、各テーブルを所有するデータベースをクエリで指定する必要があります。
SELECT i_item_sk, country FROM sakila.country, ewd.itemDenodo コネクタの最後のセクションは データ接続モード で、インポート モードまたは DirectQuery モードを選択できます。
終了したら、 [OK] を選択します。
Denodo Virtual DataPort で使用可能なデータのプレビューを表示するナビゲーター ウィンドウを表示する前に、認証を求められます。 Denodo Power BI カスタム コネクタは、Windows と Basic の 2 つの認証タイプをサポートします。
Windows: Windows 認証の使用を選択すると、Power BI Desktop は Kerberos 認証を使用して Virtual DataPort に接続します。
この場合、次のようになります。
Kerberos 認証は Virtual DataPort サーバーで有効にする必要があります。
データ ソースが接続する Denodo Virtual DataPort データベースは、オプション ODBC/ADO.net 認証タイプ を Kerberos に設定して構成する必要があります。
ODBC ドライバーはオペレーティング システムのチケット キャッシュから Kerberos チケットを要求するため、Power BI Desktop は Windows ドメインで実行されている必要があります。
DSN 設定の [詳細オプション] ページに、認証方法として Kerberos を使用するために必要な設定がすべて含まれていることを確認してください。
![Denodo DSN 構成の [詳細オプション] ページ。](media/denodo/denodo-advanced-options-dsn.png)
基本: この認証の種類では、Virtual DataPort サーバーの資格情報を使用して Power BI Desktop を Virtual DataPort データに接続できます。
完了したら、 接続 を選択します。
ナビゲーター で、データベースから必要なデータを選択し、 読み込みを選択するか、受信データを変更する場合は データの変換 を選択します。
オンプレミス データ ゲートウェイを使用して Power BI サービスから ODBC データ ソースに接続する
接続するには、以下の手順を実行します。
ブリッジとして機能するオンプレミス データ ゲートウェイ (エンタープライズ ゲートウェイ) を構成し、オンプレミス データ (クラウドではなく Power BI Desktop アプリケーション内のデータ) と Power BI サービスの間で迅速かつ安全なデータ転送を提供します。
サインインしてゲートウェイを登録します。 オンプレミス データ ゲートウェイ アプリで、 ステータス タブを選択して、ゲートウェイがオンラインであり、使用できる状態であることを確認します。
![[状態] タブが開いているオンプレミス データ ゲートウェイ。](media/denodo/on-premises-data-gateway.png)
Power BI サービスのゲートウェイ設定ページを使用して、Denodo Power BI カスタム コネクタのデータ ソースを作成します。
データ ソースを作成するには、選択したデータ ソースへの接続方法を指定する必要があります。
- DSNを通じて
- 接続文字列の使用
認証モードも指定する必要があります。 利用可能な認証方法は次のとおりです。
Windows: Windows 認証の使用を選択すると、Power BI サービス は Kerberos 認証を使用して Virtual DataPort に接続します。 必要なもの:
データ ソース設定 で、ユーザー名とパスワードを入力して Kerberos チケットを作成します。
Kerberos 認証は Virtual DataPort サーバーで有効にする必要があります。
データ ソースが接続する Denodo Virtual DataPort データベースは、オプション ODBC/ADO.net 認証タイプ を Kerberos に設定して構成する必要があります。
DSN 設定の [詳細オプション] ページに、認証方法として Kerberos を使用するために必要な設定がすべて含まれていることを確認してください。
基本: この認証の種類を使用すると、Power BI サービスでデータ ソースを作成し、Virtual DataPort サーバーの資格情報を使用して Virtual DataPort データに接続できます。
Windows認証を使用している場合、データソースの詳細設定で、シングルサインオン（SSO）認証スキーマを有効にすることで、Power BIでレポートにアクセスしているユーザーと同じ認証情報を使用して、Denodoで必要なデータにアクセスすることができます。
SSO を有効にするための 2 つのオプションがあります。DirectQuery クエリに Kerberos 経由の SSO を使用、DirectQuery およびインポート クエリに Kerberos 経由の SSO を使用。 DirectQuery ベースのレポートを使用している場合、両方のオプションで Power BI サービスにサインインするユーザーの SSO 資格情報が使用されます。 違いは、インポート ベースのレポートを使用する場合に発生します。 このシナリオでは、前者のオプションはデータ ソース ページ (ユーザー名 フィールドと パスワード フィールド) に入力された資格情報を使用し、後者はデータ セット所有者の資格情報を使用します。
Kerberos ベースの SSO を使用するには、考慮する必要がある特定の前提条件と考慮事項があることに注意することが重要です。 これらの必須要件には次のようなものがあります。
Microsoft Power BI Gateway を実行している Windows ユーザーに対して Kerberos 制約付き委任を有効にする必要があり、ローカル Active Directory 環境と Microsoft Entra ID 環境の両方の構成を、この目的のために Microsoft が提供する手順に従って実行する必要があります。
既定では、Microsoft Power BI ゲートウェイは、SSO 認証操作を実行するときにユーザー プリンシパル名 (UPN) を送信します。 したがって、Denodo Kerberos 認証でログイン識別子として使用する属性を確認し、
userPrincipalNameと異なる場合は、この値に従ってゲートウェイ設定を調整する必要があります。\Program Files\On-premises data gatewayに保存されているMicrosoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.configという Microsoft Power BI ゲートウェイ構成ファイルには、ゲートウェイが実行時にローカルの Microsoft Entra ID ルックアップを実行できるようにするADUserNameLookupPropertyとADUserNameReplacementPropertyという 2 つのプロパティがあります。ADUserNameLookupPropertyでは、Microsoft Entra ID から取得したユーザー プリンシパル名をローカル AD のどの属性に対してマップする必要があるかを指定する必要があります。 したがって、このシナリオでは、ADUserNameLookupPropertyはuserPrincipalNameである必要があります。 ユーザーが見つかると、ADUserNameReplacementProperty値は、偽装ユーザーの認証に使用する属性 (Denodo でログイン識別子として使用する属性) を示します。また、この構成ファイルの変更はゲートウェイ レベルで行われるため、Microsoft Power BI Gateway を介して SSO 認証が行われるソースに影響することも考慮する必要があります。
Denodo コネクタのデータ ソースが作成されたら、Power BI レポートを更新できます。 powerbi.com でレポートを公開するには、次のことを行う必要があります。
- Power BI Desktop でレポートを開きます。
- [ファイル]>[発行]>[Power BI へ発行] の順に選択します。
- レポートをコンピュータに保存します。
- 公開するワークスペースを選択します。
トラブルシューティング
Denodo ビューのフィールドに他のビューとのリレーションが 42 を超える場合のデータのロード。
Power BI にデータ ソースとしてインポートされている Denodo ビューに他のビューとの関係が 42 を超える場合、Power BI はデータ変換ウィンドウにアクセスするときに次のエラーを表示することがあります。
Preview.Error: The type of the current preview value is too complex to display.
このエラーは、Microsoft Power Query プラットフォームの制限が原因で発生します。 これを回避するには、データ変換ウィンドウで失敗したデータ ソース (クエリ) を選択し、表示>詳細エディタで詳細エディタにアクセスします。 次に、M 言語でデータ ソース式を編集し、Denodo.Contents関数呼び出しのoptions 引数に次のプロパティを追加します。
CreateNavigationProperties=false
したがって、呼び出しは次のようになります。
Source = Denodo.Contents(<dsn>, null, [CreateNavigationProperties=false])
このプロパティは、このデータ ソースでアクセスされる Denodo ビューに登録されたリレーションシップからナビゲーション プロパティを生成しようとしないように Power BI に指示します。 したがって、これらの関係の一部を Power BI データ モデルに実際に存在させる必要がある場合は、後でそれらを手動で登録する必要があります。
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示