Power BI Report Builder でリアルタイムのOkta のデータを Power BI Service に可視化

CData Power BI Connector は、Microsoft Power BI とのセルフサービス統合を提供します。CData Power BI Connector for Okta を使用すると、Power BI レポートをリアルタイムのOkta のデータにリンクできます。スケジュール更新やオンデマンド更新を設定することで、ダッシュボードを通じてOkta のデータを監視し、分析がリアルタイムのOkta のデータを反映するようにできます。この記事では、Power BI Connector を使用して Microsoft Power BI Desktop でリアルタイムのOkta のデータを可視化する方法を詳しく説明します。

DSN の作成と設定

Power BI Connector をインストールすると、Power BI がデータソースに接続するために使用する CData PBI Okta という名前の DSN（データソース名）が作成されます。必要な接続プロパティを入力して DSN を設定します。

Microsoft ODBC データソースアドミニストレーターを使用して、新しい DSN を作成するか、既存の DSN を設定（および名前変更）できます。スタートメニューから「ODBC データソース」と入力します。Power BI Desktop のインストールに対応するビット数（32 ビットまたは 64 ビット）の ODBC アドミニストレーターを実行してください。

Okta に接続するには、Domain 接続文字列プロパティをお使いのOkta ドメインに設定します。 Okta はOAuth およびOAuthJWT 認証をサポートしています。

OAuth認証

OAuth で認証するには、AuthScheme をOAuth に設定する必要があります。また、カスタムOAuth アプリケーションを作成する必要があります。

カスタムOAuth アプリケーションの作成

Okta アカウントから：

1. 管理者アカウントでOkta のデベロッパーエディションにサインインします。
2. Admin Consoleで、Applications > Applications に移動します。
3. Create App Integration をクリックします。
4. Sign-in method は、OIDC - OpenID Connect を選択します。
5. Application type は、Web Application を選択します。
6. カスタムアプリケーションの名前を入力します。
7. Grant TypeをAuthorization Code に設定します。トークンを自動的に更新したい場合は、Refresh Token もチェックしてください。
8. コールバックURL を設定します。
   • デスクトップアプリケーションやヘッドレスマシンでは、http://localhost:33333 または任意の別のポート番号を使用します。ここで設定したURI が、CallbackURL プロパティになります。
   • Web アプリケーションの場合、コールバックURL を信頼できるリダイレクトURL に設定します。このURL は、アプリケーションへのアクセスが許可されたことを示すトークンを伴ってユーザーが戻ってくるWeb 上の場所です。
9. Assignments セクションで、Limit access to selected groups を選択してグループを追加するか、グループの割り当ては一旦スキップします。
10. OAuth アプリケーションを保存します。
11. アプリケーションのGeneral タブに、アプリケーションのClient Id とClient Secret が表示されます。後で使用できるように、これらを記録してください。Client Id はOAuthClientId の設定に使用し、Client Secret はOAuthClientSecret の設定に使用します。
12. Assignments タブを確認し、アプリケーションにアクセスする必要のあるすべてのユーザーがアプリケーションに割り当てられていることを確かめます。
13. Okta API Scopes タブで、OAuth アプリケーションに付与するスコープを選択します。これらのスコープは、アプリが読み取り可能なデータを決定します。そのため、特定のビューに対するスコープを付与しないと、そのビューに対するクエリを実行する権限がドライバーに付与されません。各ビューに必要なスコープを確認するには、ヘルプドキュメントのデータモデル > ビュー のビュー固有のページを参照してください。

OAuth 認証の詳細や、OAuthJWT 認証については、ヘルプドキュメントを参照してください。

Okta のデータの取得

データソースの設定が完了したら、以下の手順に従って Okta テーブルからデータセットにデータを読み込みます。

読み込むテーブルとビューを選択

1. Power BI Report Builder を開き、Blank Report を選択します。
2. Data Sources -> Add Data Source をクリックします。
3. Connection Type で ODBC を選択し、「Build」をクリックします。
4. 「Use user or system data source name」をクリックし、CData PBI Okta Sys を選択します。
5. Connection Properties で Test Connection をクリックし、接続が成功することを確認します。
6. Data Source Properties ウィンドウで Test Connection をクリックし、OK をクリックします。
7. データソースの設定が完了したら、DataSets を設定します。DataSets -> Add Dataset をクリックします。先ほど設定したデータソースを選択し、Query Designer をクリックします。
8. レポートを生成するテーブルの SQL コマンドを入力し、「Run」（!）をクリックします。テーブル名は DSN の CData Connection Manager の Metadata タブで確認できます。
9. 「Validate Query」をクリックします。ウィンドウの左側にカラム名が表示されます。これで、用途に応じて任意のレポートを生成できます。

データビジュアライゼーションの作成

Okta のデータを Power BI Report Builder に読み込んだ後、Fields ペインからキャンバスにフィールドをドラッグして、レポートビューでデータビジュアライゼーションを作成できます。以下の手順に従ってチャートを作成します：

1. Insert -> Chart -> Insert Chart に移動し、Chart Type を選択して OK をクリックします。
2. Values、Category Groups、Series Groups を選択します。Filters ペインにフィールドをドラッグすることで、ページ、レポート、または単一のビジュアライゼーションにフィルターを適用できます。フィールド値でフィルターするには、Filters ペインに表示されている値の1つを選択します。

PowerBI.com でデータ更新を設定

Power BI Gateway を使用して自動データ更新を設定するには、以下の手順に従います。ゲートウェイにより、Power BI クラウドサービスがお使いのマシンの DSN に接続できるようになります。

ゲートウェイモードの選択

ゲートウェイをインストールする際に、ゲートウェイモードを選択する必要があります：

• Gateway (personal mode)：PowerBI.com への発行とレポートの更新のみが必要な場合は、パーソナルモードでゲートウェイを使用します。ゲートウェイは Windows ユーザーアカウントで実行されます。
• （推奨） Gateway (Standard mode - formerly Enterprise)：ゲートウェイを必要とする他の Azure サービスを使用している場合は、デフォルトゲートウェイを使用します。複数のユーザーがゲートウェイにアクセスする必要がある場合も、デフォルトゲートウェイが必要です。 デフォルトゲートウェイ経由で接続するには、システム DSN が必要です（システム DSN はシステム全体でアクセスできますが、ユーザー DSN は特定のユーザーアカウントに制限されます）。コネクタインストールの最後のステップで設定された CData Power BI Salesforce システム DSN を使用できます。

Gateway (Personal Mode) の設定

パーソナルモードでゲートウェイを介して発行するには、カスタムコネクタにアクセスできるインストール済みゲートウェイが必要です。

1. CData Power BI Connector インストーラーを実行します。まだダウンロードしていない場合は、Power BI Gateway (Personal Mode) をダウンロードしてください。
2. オンプレミスデータゲートウェイ（personal mode）オプションを選択します。
3. ゲートウェイにサインインします。
4. ゲートウェイ設定の Connectors セクションで、「custom data connectors」オプションを有効にします。カスタムデータコネクタの .pqx ファイルへの代替パスもここで指定できます。

   注意：CData Power BI Connector は .pqx ファイルをデフォルトフォルダにインストールします。パス："Your User Home\Documents\Power BI Desktop\Custom Connectors."

Gateway (Standard Mode) の設定

ゲートウェイを介して発行するには、カスタムコネクタにアクセスできるインストール済みゲートウェイと、PowerBI.com から Salesforce 用 DSN への設定済み接続が必要です。

ゲートウェイのセットアップ

以下の手順に従って、お使いのマシンでゲートウェイを設定します：

1. CData Power BI Connector インストーラーを実行します。まだダウンロードしていない場合は、Power BI Gateway (Standard Mode) をダウンロードしてください。
2. オンプレミスデータゲートウェイ（推奨）オプションを選択します。
3. ゲートウェイにサインインします。
4. ゲートウェイに名前を付け、回復キーを指定します。
5. Connectors セクションで、ゲートウェイが CData Power BI Connector を検索するフォルダを選択します。この記事では "C:\Users\PBIEgwService\Documents\Power BI Desktop\Custom Connectors\" を使用します。または、CData Connector の .pqx ファイル（"C:\Users\USERNAME\Documents\Power BI Desktop\Custom Connectors\" にあります）を設定したフォルダにコピーします。

   注意：サービス用に設定されたアカウント（NT SERVICE\PBIEgwService）が、ゲートウェイ用に選択したフォルダにアクセスできる必要があります。必要に応じて、ゲートウェイインストーラーの Service Settings セクションでサービスアカウントを変更できます。

6. Connectors セクションのリストに CData.Okta エントリが表示されていることを確認します。

PowerBI.com から Salesforce データに接続

1. ゲートウェイにデータソースを追加します：PowerBI.com にログインし、Settings メニューから Manage Gateways を選択してゲートウェイを選択します。
2. 「Allow user's custom data connectors to refresh through this gateway cluster」を選択します。
3. Apply をクリックして変更を保存します。
4. ゲートウェイにデータソースを追加するオプションをクリックします。
5. Data Source Settings セクションで、データソースの名前を入力します。Data Source Type メニューで CData Power BI Connector for Okta を選択します。
6. Data Source Name ボックスにシステム DSN を入力します：CData PBI Okta Sys。

PowerBI.com に発行

更新可能なレポートと基になるデータセットを発行できるようになりました。以下の手順に従って発行し、データセットのデータ更新設定を完了します。

1. Power BI Desktop Report Builder で、Home リボンの「Publish」をクリックしてレポートを発行します。
2. PowerBI.com で、レポートがアップロードされるワークスペースを選択し、ファイル名を入力します。
3. 「Open Okta in Power BI」をクリックして、ブラウザの Power BI Service でレポートを開きます。

発生したエラーと解決策

「Unable to render paginated report」のようなエラーメッセージが表示された場合は、以下の手順に従ってエラーを解決できます。

Power BI Service でデータソースを作成

1. 「Update data source credentials」をクリックします。
2. 「Continue」をクリックします。
3. Gateway Connection セクションで、ゲートウェイを使用するオプションを有効にし、ゲートウェイを選択します。データソースをゲートウェイに手動で追加する必要がある場合があります：
   1. Actions 列の下でゲートウェイを展開します。
   2. 「Manually add to gateway」リンクをクリックします。
4. Add to gateway をクリックします（以下のスクリーンショットを参照）。匿名認証はサポートされていないため、Authentication で Basic を選択します。Power BI Service アカウントのユーザー名とパスワードを入力します。
5. データソースが正常に作成されたら、「Maps to」で Connection name を選択し、変更を適用します。
6. Power BI Report Builder に戻り、「Open Okta in Power BI」をクリックします。これで、Power BI Service（Online）で作成したレポートを確認できます。

これで、Power BI Report Builder と CData Power BI Connector を使用して、リアルタイムのOkta のデータ上に構築された Power BI レポートが完成しました。Okta 用 CData Power BI Connector の詳細については、CData Power BI Connector for Okta ページで無料トライアルをダウンロードしてご確認ください。ご質問がある場合は、サポートチームまでお問い合わせください。