はじめに
このガイドは、「Power BI: データを Power BI に読み込む」チェーン テンプレートをスムーズに導入できるよう支援することを目的としています。Power BI ワークスペースに新しいデータを読み込んだり、既存のデータを更新したり、データを削除したりする場合でも、このテンプレートがその作業を支援します。このドキュメントでは、Power BIの設定権限やアプリケーションAPIの権限の設定手順、および「Chain Template」を使用することによるさまざまなメリットについて、わかりやすく解説しています。このガイドに従うことで、スムーズかつ効率的な導入プロセスを確保でき、Power BI でのデータ処理作業をより簡単かつ効果的に行うことができます。
前提条件
チェーン
データ
- データが記載されたCSVファイルが必要です (CSVファイルにはバイト順マーク(BOM)が含まれていてはなりません)
- 列名とそれぞれのデータ型のリストは不可欠です
Power BI のセットアップに関する追加情報
- そのユーザーアカウントが、のPower BI Pro ライセンス以上を保有しており、Azureアカウントに変更を加える権限を持っていることを確認してください。
- のAzureポータルにサインインしてください
- ページの右上隅にあるアカウントを選択し、「」の Microsoft Entraテナントを選択してください。
- 「」アプリの登録から「 」を選択します。
-
- 「アプリ登録」で、「の新規登録」を選択します。
-
- 次のフィールドに塗りつぶしの色を入力します:
- 名前 - アプリケーションに名前を付けます
- 対応するアカウントの種類 - アプリケーションを利用できるユーザーを選択してください
- 次のフィールドに塗りつぶしの色を入力します:
-
- 「」を選択し、「 」を登録してください。アプリの登録が完了すると、そのアプリの概要ページに移動します
- 概要ページで、アプリケーション(クライアント ID)とテナント ID を確認し、この情報を安全な場所に保管してください。Workiva を Power BI に接続する際に、これらの情報が必要になります。
Power BI の API 権限
- 右側のパネルから、Power BI アプリケーションのアクセス権限を調整します
- 展開 管理
- APIの権限設定に移動する
- 以下のAPI権限が選択されていることを確認してください。
- 以下のAPI権限が選択されていることを確認してください。
リダイレクトURI
- 右側のパネルから、Power BI アプリケーションのアクセス権限を調整します
- 展開 管理
- 「認証」に移動する
| フィールド | 値 |
|---|---|
| Azure URI | https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback |
| フィールド | 値 |
|---|---|
| Azure URI | https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback |
| フィールド | 値 |
|---|---|
| Azure URI | https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback |
| フィールド | 値 |
|---|---|
| Azure URI | https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback |
Power BI のアクセス許可の設定が完了したら、「からPower BIへのコネクタ」 を参照し、Power BI コネクタの設定を行ってください。
チェーンの展開
「Power BI: Power BIへのデータ読み込み( )」は、[テンプレート] 画面の [Workiva Chains] セクションにあります。
検索方法はこうだ:
- チェーンビルダーで、テンプレートタブに移動
- 上部のメニューからWorkiva チェーン を選択する。
- 「」を検索します。Power BI:Power BIへのデータ読み込み 右上の「Chain Template」をクリックして、テンプレートを開きます。
テンプレートが見つかったら、を使用して、以下に挙げるランタイム入力に基づき、 をワークスペースに合わせて設定してください。
注: テンプレートからチェーンを作成する方法の詳細については、の「チェーンの作成と管理」( )の記事をご覧ください。
メモ:この統合ユーザーには、コネクタが実行するコマンド(操作対象のスプレッドシートやワークスペースのオーナーなど)に対する適切な権限が必要です。
ランタイム入力
| ランタイム入力 | 説明 | フィールドのタイプ | 必要ですか? |
| PBI ワークスペース ID | これは、Power BI ワークスペース ID を格納するための変数です。IDは、個人のPBIワークスペースとは別のワークスペース用です。URLの「/group/」の後にあります。 | テキストフィールド | はい |
| PBI データセット ID | これは、既存のPBIデータセットIDを格納する変数です。これはPBI内の、URLの「/datasets/」の後にあります。これは、新しいデータで更新するか、削除したいデータセットです。 | テキストフィールド | いいえ |
| PBI テーブル名 | これは、Power BI でデータを追加したいデータセット内のテーブルの名前です。 | テキストフィールド | はい |
| データファイル | Power BIに取り込みたいCSVファイル。 | ファイルフィールド | いいえ |
| 既存のデータセットに追加/新規作成/削除 |
Power BI の既存のデータセットに追加するか、読み込むための新しいデータセットを作成するか、あるいはデータセットを削除するかを選択します。 オプション
|
ドロップダウンフィールド | はい |
チェーンについてさらに詳しく
チェーンプロセスを効果的に運用し、成果が出始めるためには、関連するPower BIワークスペースをChains内のそれぞれの変数と整合させる必要があります。
のPower BIにおいて、テーブルIDをそれぞれのランタイム入力に設定する方法は以下の通りです:Power BIへのデータ読み込み チェーン
- 有効化済みの「」の「Power BI: データを Power BI に読み込む」 チェーンに移動します。
- コマンドをダブルクリックして、ランタイム入力を編集します
- 「Runtime Inputs」コマンド内の、Power BI にあるそれぞれのテーブル ID およびワークスペース ID を更新してください
注: ご注意ください。このテンプレートを使用するには、パイプラインのダウンストリームにある「Command」に追加のユーザーを指定する必要があります。
「データセットの作成」コマンドでは、ユーザーはチェーンの実行を続行する前に、データセットの列とそれぞれのデータ型を入力・設定する必要があります。
- コマンドをダブルクリックして、「データセットの作成」を編集します
- [列] で [追加] を選択し、列の「名前」と「データ型」を入力します。
注: 先に進む前に、最初の「CHANGE_ME」という列を必ず置き換えてください。各コマンドで許可される列数は70列までです。70列を超えるテーブルは、Power BI内で再結合する必要があります。
トラブルシューティング
以下のステップは、チェーンテンプレートに関する問題のトラブルシューティングに使用できます:
チェーン実行エラー
バイト順マーク(BOM)を含むCSVファイル
Power BI コマンドでは、BOM を含む CSV ファイルを読み込んで処理することができません。BOM を削除するには、以下のトラブルシューティングのヒントをご覧ください:
Visual Studio Code (VS Code) については:
- VS CodeでCSVファイルを開いてください。
- ウィンドウの右下隅に表示されているエンコーディングをクリックしてください(「UTF-8 with BOM」と表示されている場合があります)。
- ドロップダウンメニューが表示されます。「UTF-8」を選択してください。通常、これをすると、次回の保存時にBOMが削除されます。「ファイル」>「名前を付けて保存」を選択し、エンコードのドロップダウンメニューで「UTF-8」が選択されていることを確認する必要があるかもしれません。
用 Notepad++ (Windows):
- CSVファイルをNotepad++で開いてください。
- 上部のツールバーにある「エンコーディング」メニューを選択してください。
- 「BOMなしのUTF-8に変換」を選択します。
- ファイルを保存します(「ファイル」>「保存」)。