GraphQL のデータをPower BI Service にインポートしてビジュアライズ

加藤龍彦
デジタルマーケティング

CData Connect AI を使用してGraphQL のOData フィードを作成し、Power BI Service でカスタムレポートを作成します。

Power BI を使えば、企業のデータを豊富なビジュアルに変換して収集および整理することができるため、重要なことだけに集中できます。CData Connect AI と組み合わせると、ビジュアライゼーションやダッシュボード用にGraphQL のデータにアクセスできます。この記事では、CData Connect AI を使用してGraphQL のOData フィードを生成し、GraphQL のデータをPower BI にインポートして、Power BI サービスのGraphQL のデータに関するレポートを作成する方法について説明します。

Connect AI を構成する

Power BI online でGraphQL のデータを操作するには、Connect AI からGraphQL に接続し、コネクションにユーザーアクセスを提供してGraphQL のデータのOData エンドポイントを作成する必要があります。

GraphQL に接続したら、目的のテーブルのOData エンドポイントを作成します。

（オプション）新しいConnect AI ユーザーの追加

必要であれば、Connect AI 経由でGraphQL に接続するユーザーを作成します。

ユーザーページに移動し、 Invite Users をクリックします。
新しいユーザーのE メールアドレスを入力して、 Send to invite the user をクリックします。
ユーザーページからユーザーを確認および編集できます。

パーソナルアクセストークンの追加

OAuth 認証をサポートしていないサービス、アプリケーション、プラットフォーム、またはフレームワークから接続する場合は、認証に使用するパーソナルアクセストークン（PAT）を作成できます。きめ細かなアクセス管理を行うために、サービスごとに個別のPAT を作成するのがベストプラクティスです。

Connect AI アプリの右上にあるユーザー名をクリックし、User Profile をクリックします。
User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
PAT の名前を入力して Create をクリックします。
パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。

Connect AI からGraphQL に接続

CData Connect AI では、簡単なクリック操作ベースのインターフェースでデータソースに接続できます。

Connect AI にログインし、 Add Connection をクリックします。
Add Connection パネルから「GraphQL」を選択します。
必要な認証プロパティを入力し、GraphQL に接続します。
GraphQL サービスのURL を指定する必要があります。ドライバーは2種類の認証をサポートします。
- Basic: AuthScheme をBasic に設定。GraphQL サービスのUser とPassword を指定する必要があります。
- OAuth 1.0 & 2.0: 詳しい説明は、ヘルプドキュメントのOAuth セクションを参照してください。
Create & Test をクリックします。
Edit GraphQL Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。

Connect AI にGraphQL OData エンドポイントを追加する

GraphQL に接続したら、目的のテーブルのOData エンドポイントを作成します。

OData ページに移動し、 Add to create new OData endpoints をクリックします。
GraphQL コネクション（例：GraphQL1）を選択し、Next をクリックします。
使用するテーブルを選択し、Confirm をクリックします。

接続とOData エンドポイントが構成されたら、Power BI online からGraphQL のデータに接続できるようになります。

Power BI Desktop からデータセットを公開する

Connect AI にOData エンドポイントを追加すると、OData 接続を使用してPower BI Desktop にデータセットを作成し、そのデータセットをPower BI サービスに公開できます。

Power BI を開いて「データを取得」-->「詳細」とクリックし、OData フィードを選択して「接続」をクリックします。

URL をConnect AI インスタンスのBase URL（例： https://cloud.cdata.com/api/odata/service）に設定し、「OK」をクリックします。
ユーザー名 とパスワード を上記のユーザー名とPAT に設定します。
設定を適用するレベルとして、フルのBase URL（https://cloud.cdata.com/api/odata/service）を選択します。
「ナビゲーター」ダイアログでテーブルを選択し、ビジュアライズします。
「読み込み」をクリックしてPower BI にデータをプルします。
「リレーションシップ」タブで選択したエンティティ間の関連を定義します。
「ホーム」メニューから「発行」をクリックして「ワークスペース」を選択します。