再利用可能な Power BI アセットを作成する

この演習では、セマンティックモデルとレポートの開発をサポートする再利用可能な資産を作成します。これらの資産には、Power BI のプロジェクトとテンプレートのファイルが含まれます。

注: この演習では、Fabric ライセンスは必要なく、Power BI または Power BI ライセンスを使用した Microsoft Fabric 環境で完了できます。

この演習の所要時間は約 30 分です。

開始する前に

この演習を開始するには、Web ブラウザーを開き、次の URL を入力して zip フォルダーをダウンロードする必要があります。

https://github.com/MicrosoftLearning/mslearn-fabric/raw/refs/heads/main/Allfiles/Labs/16b/16-reusable-assets.zip

zip ファイルを C:\Users\Student\Downloads\16-reusable-assets フォルダーに抽出します。

新しい Power BI プロジェクトを作成する

このタスクでは、レポートを Power BI プロジェクトファイル (.pbip) として保存します。 Power BI プロジェクトファイルでは、ソース管理を使用するフラットファイルにレポートとセマンティックモデルの詳細が格納されます。 Visual Studio Code を使用して、これらのファイルを変更したり、Git により変更を追跡したりできます。

16-reusable-assets フォルダー内の 16-Starter-Sales Analysis.pbix ファイルを開きます。
[ファイル] > - [オプションと設定] > - [オプション] > - [プレビュー機能] を選択して、[TMDL 形式を使用してセマンティックモデルを保存する] オプション、[OK] の順に選択します。

すると、現在プレビュー機能である表形式モデル定義言語 (TMDL) を使用してセマンティックモデルを保存するオプションが有効になります。 Power BI Desktop の再起動を求められた場合は、演習を続行する前に再起動してください。
[名前を付けて保存] を選択し、ファイルに名前を付けるときにドロップダウンメニューの矢印を選択して、ファイルの種類を選択します。
.pbip ファイル拡張子を選択し、レポートの名前を選択して、忘れにくいフォルダーに保存します。
Power BI Desktop ウィンドウの上部で、レポート名の横に “(Power BI プロジェクト)” が表示されていることに注意してください。
Power BI Desktop を閉じて、メッセージが表示されたら変更を保存します。
Power BI Desktop を再度開き、保存した .pbip ファイルを開きます。
TMDL 形式を使用するようにプロジェクトにアップグレードを求められたら、[アップグレード] を選択して、セマンティックモデルの表形式モデル定義言語形式を有効にします。

このアップグレードは、TMDL 形式を使用してセマンティックモデルを格納するために必要です。これにより、次の手順で .tmdl ファイルを確認できます。
ファイルを保存します。

Power BI プロジェクトファイルの詳細を確認する

Power BI Desktop の変更が .tmdl ファイルにどのように反映されるかを見てみましょう。

デスクトップからファイルエクスプローラーを使用して、.pbip ファイルを保存したフォルダーに移動します。
次のアイテムが表示されるはずです。
- YourReport.pbip ファイル
- YourReport.Report フォルダー
- YourReport.SemanticModel フォルダー
- .gitignore Git Ignore ソースファイル

レポートに新しいテーブルを追加する

セマンティックモデルには必要なすべてのデータが揃っていないため、このタスクでは新しいテーブルを追加します。

Power BI Desktop で、[データを取得] - [Web] に移動して、新しいデータを追加します。
接続すると、[Web から] ダイアログボックスがポップアップ表示されます。 [基本] ラジオボタンは選択したままにします。 URL パスとして次のファイルパスを入力します。

C:\Users\Student\Downloads\16-reusable-assets\us-resident-population-estimates-2020.html
[HTML Tables] - [Table 2] のボックスを選択し、[データの変換] を選択して次に進みます。
新しい Power Query エディターウィンドウが、Table 2 のデータプレビューが表示されて開きます。
テーブル 2 の名前を「US Population」（米国の人口）に変更します。
STATE の名前を「State」(州) に、NUMBER の名前を「Population」(人口) に変更します。
[RANK] 列を削除します。
[閉じて適用] を選択して、変換されたデータをセマンティックモデルに読み込みます。
潜在的なセキュリティリスクのダイアログボックスが表示された場合は、[OK] を選択します。
ファイルを保存します。
メッセージが表示された場合は、Power BI レポートの拡張形式にアップグレードしないでください。

リレーションシップの作成

このタスクでは、Power BI Desktop でレポートに変更を加え、フラットな .tmdl ファイルの変更を確認します。

エクスプローラーで、YourReport.SemanticModel ファイルフォルダーを見つけます。
定義フォルダーを開き、さまざまなファイルがあることを確認します。
メモ帳で relationships.tmdl ファイルを開き、9 つのリレーションシップが記載されていることを確認します。ファイルを閉じます。
Power BI Desktop に戻り、リボンの [モデリング] タブにアクセスします。
[リレーションシップの管理] を選択し、9 つのリレーションシップがあることを確認します。
新しいリレーションシップを次のように作成します。
- リレーションシップ元: State-Province がキー列である「Reseller」(リセラー)
- リレーションシップ先: State がキー列である「US Population」(米国の人口)
- カーディナリティ: 多対一 (*:1)
- クロスフィルターの方向: 両方
ファイルを保存します。
relationships.tmdl ファイルに戻り、新しいリレーションシップが追加されたことを確認します。

フラットファイルでのこれらの変更は、バイナリである .pbix ファイルとは異なり、ソース管理システムで追跡できます。

メジャーとビジュアルをレポートに追加する

このタスクでは、メジャーとビジュアルを追加してセマンティックモデルを拡張し、そのメジャーをビジュアルで使用します。

Power BI Desktop で、[データ] ペインに移動し、”売上” テーブルを選択します。
コンテキストの [テーブルツール] リボンにある [新しいメジャー] を選択します。

数式バーに次のコードを入力してコミットします。

 Sales per Capita =
 DIVIDE(
     SUM(Sales[Sales]),
     SUM('US Population'[Population])
 )

新しい [Sales per Capita] (1 人当たりの売上) メジャーを見つけて、キャンバスにドラッグします。
Sales | Sales と US Population | State と US Population | Population フィールドを同じビジュアルにドラッグします。

“このラボでは、フィールドを参照するために簡略表記を使用します。次のようになります。Sales | Unit Price。この例では、Sales はテーブル名、Unit Price はフィールド名です。”
ビジュアルを選択し、テーブルに変更します。
“1 人当たりの売上” データと人口データの書式に一貫性がないことを確認します。
[データ] ペインで各フィールドを選択し、書式と小数点以下の桁数を変更します。
- 1 人当たりの売上: 通貨 | 小数点以下 4 桁
- 人口: 整数 | コンマ区切り | 小数点以下 0 桁
ヒント: 誤って間違ったテーブルにメジャーを作成した場合は、前の画像に示すように、[ホーム] テーブルを簡単に変更できます。
ファイルを保存します。

注:テーブルは、4 つの列と正しく書式設定された数値を含む次の図のようになるはずです。
メモ帳を開く
ファイルを開きます: C:\Users\Student\Downloads\16-Starter-Sales Analysis.SemanticModel\definition\tables\Sales.tmdl

次のようにメジャーが追加されたことを確認できる 163 行目付近のコードを見つけます。

    
     measure 'Sales per Capita' =
                
             DIVIDE(
                 SUM(Sales[Sales]),
                 SUM('US Population'[Population])
             )
         formatString: \$#,0.0000;(\$#,0.0000);\$#,0.0000
         lineageTag: c95a1828-af50-484b-8310-64614fe2504b
    
         annotation PBI_FormatHint = {"currencyCulture":"en-US"}

メモ帳を閉じます。
Power BI Desktop を閉じます。変更を保存する必要はありません。

再利用可能な Power BI テンプレート (PBIT) を作成する

演習のこの次のパートの目標は、Power Query パラメーター (この場合は Region パラメーター) を使用して、Power BI テンプレート (PBIT ファイル) のデータからレポートロジックを分離する方法を示すことです。小さなレポートを作成し、どの地域のデータを読み込むかを制御するパラメーターを定義してから、レポートを再利用可能なテンプレートとしてエクスポートします。テンプレートを再度開くと、ユーザーは地域の値を選択するだけで、対応するデータセットがレポートによって自動的に読み込まれます。これにより、テンプレートによって、同じデータモデルの複数のバリエーションにわたるスケーラブルで標準化されたレポートがどのように可能になるかが示されます。

地域の売上データを調べる

エクスプローラーを開き、地域のデータが格納されているフォルダーに移動します。これは、C:\Users\student\Downloads\16-reusable-assets\data のようになります。このフォルダー内には、次の 2 つの CSV ファイルがあります。
- region-north.csv
- region-south.csv
各ファイルを開き (メモ帳、Excel、または任意のテキストエディターを使用できます)、内容を調べます。データの構造、使用可能な列、および 2 つの地域のデータセットの類似性を確認します。北と南の地域に注目してください。この知識は、Power BI が後で読み込む内容と、Region パラメーターを使用してそれらを切り替える方法を理解するのに役立ちます。

Power BI レポートの作成とデータの読み込み

Power BI Desktop を開き、空白のレポートを作成します。
[ホーム] リボンで、[データの取得] を選択し、[テキスト/CSV] を選択します。
C:\Users\Student\Downloads\16-reusable-assets\data\region-north.csv ファイルを読み込みます。
[データの変換] を選択します
クエリの名前を sales に変更します

クエリ設定のスクリーンショット。

Power Query パラメーターを作成する

Power Query で、[ホーム] リボンの [パラメーターの管理] を選択し、[新しいパラメーター] を選択します。

次の値でパラメーターを作成します。

プロパティ	[値]
名前	`Region`.
Type	Text
提案された値	値の一覧
テーブル	north、south
Default Value	north
現在の値	north

Power BI Desktop の [パラメーターの管理] ダイアログのスクリーンショット。

パラメーターを使用するようにクエリを変更する

ユーザーがテンプレートを開いたときに、Power BI で地域を選択できるようにする必要があります。

sales クエリをもう一度選択します。
[表示] リボンで、[詳細エディター] を選択します。

クエリが region-north.csv にハードコーディングされていることに注目してください

 let
     Source = Csv.Document(File.Contents("C:\Users\Student\Downloads\16-reusable-assets\data\region-north.csv"),[Delimiter=",", Columns=5, Encoding=1252, QuoteStyle=QuoteStyle.None]),
     #"Promoted Headers" = Table.PromoteHeaders(Source, [PromoteAllScalars=true]),
     #"Changed Type" = Table.TransformColumnTypes(#"Promoted Headers",{ {"Date", type date}, {"Region", type text}, {"Product", type text}, {"Units", Int64.Type}, {"Revenue", Int64.Type} })
 in
     #"Changed Type"

ハードコーディングされた地域 (north) をパラメーター Region に置き換えます。

 let
     Source = Csv.Document(File.Contents("C:\Users\Student\Downloads\16-reusable-assets\data\region-" & Region & ".csv"),[Delimiter=",", Columns=5, Encoding=1252, QuoteStyle=QuoteStyle.None]),
     #"Promoted Headers" = Table.PromoteHeaders(Source, [PromoteAllScalars=true]),
     #"Changed Type" = Table.TransformColumnTypes(#"Promoted Headers",{ {"Date", type date}, {"Region", type text}, {"Product", type text}, {"Units", Int64.Type}, {"Revenue", Int64.Type} })
 in
     #"Changed Type"

注:Power Query (M 言語) では、テキスト値を引用符 “ “ で囲む必要があります。また、アンパサンド & 演算子を使用してテキスト部分を結合 (連結) する必要があります。

[ホーム] リボンから [閉じて適用] を選択します。

シンプルなレポートを作成する

レポートビューに戻ります。
作成:
- 合計収益を示すカード
- 製品別の収益を示す縦棒グラフ
- すべてのフィールドを示すテーブル
タイトル Regional Sales Report Template を追加します。

レポートはこのようになります。レイアウトについては気にしないでください。

alt text

テンプレートとして保存 (PBIT)

[ホーム] リボンで、[ファイル] > [名前を付けて保存] を選択します。
フォルダーの場所 (例: [ダウンロード]) を選択し、ファイル名を入力します。たとえば、「 regional-sales 」のように指定します。
ファイル拡張子として [PBIT] を選択します。
テンプレートの説明を入力するように求められたら、次のテキストを入力します。
```
 Select your region.
```

テンプレートをテストする

Power BI Desktop を閉じます。変更を保存するように求められたら、[保存しない] を選択できます。
regional-sales.pbit ファイルを開きます。
地域の選択を求めるパラメータープロンプトが表示されるはずです。
ドロップダウンリストから [south] を選択します。
データを読み込み、レポートを開きます。

レポートが south-region の値で正しく開いていることに注目してください。

開かれたレポートの例のスクリーンショット。

これで、完全に再利用可能なパラメーター化されたレポートフレームワークが作成されました。

レポートを閉じます。保存する必要はありません。

クリーンアップ

この演習が無事完了しました。 Power BI のプロジェクトとテンプレートのファイルを作成しました。ワークスペースとすべてのローカルアセットを安全に削除できます。