こんにちは、Power BI サポート チームの中川です。
Power BI では、デプロイパイプライン（配置パイプライン）を利用することで、レポートの開発・テスト・本番環境への展開をスムーズに管理することができます。
また、配置ルールを利用することで、ステージごとに異なるデータソースを設定できるため、開発ステージではダミーデータを使用し、テストや本番ステージでは本番に近いデータを用いた検証が可能になります。
これにより、本番環境への影響を抑えたレポートの修正・テストを行うことができ、品質の向上と運用の効率化を図ることができます。
本ブログでは、 SQL Server を例に、開発・テスト環境で異なるデータを取得する方法を中心に、デプロイパイプラインの利用方法についてご紹介いたします。
重要
本記事は弊社公式ドキュメントの公開情報を元に構成しておりますが、
本記事編集時点と実際の機能に相違がある場合がございます。
最新情報につきましては、参考情報として記載しておりますドキュメントをご確認ください。
目次
デプロイパイプラインについて
デプロイパイプラインは、既定では開発（Development）、テスト（Test）、本番（Production）の 3つのステージを基にして作業を行います。各ステージはワークスペースに紐づけられており、必要に応じてステージを追加、削除することも可能です。ステージ数は 2 個から 10 個に設定できます。
特徴
デプロイパイプラインには以下のような特徴があります。
- 簡単なデプロイ操作
- ボタン操作で各ステージ間のコンテンツのコピーや差分の確認が可能です。
- 配置ルールの設定
- 各ステージで異なるデータソースを設定できるため、環境ごとに動作を検証できます。
- デプロイ履歴
- デプロイ履歴からデプロイ先や日時、項目などが確認できます。
アイテムペア設定
アイテムペア設定とは、デプロイパイプラインの 1つのステージにあるアイテムを、隣接するステージにある同じアイテムと関連付けるプロセスです。アイテムペア設定を行う操作をペアリングと呼びます。
意図しない重複やデプロイの失敗を防ぐためには、ペアリングの仕組みを理解することが重要になりますので簡単に紹介します。
ペアリングのポイント
- 手動でペアリングはできない
- 自動的にペアリングが行われます。
- ペアリングの規則に従う以外は、項目を手動でペアリングする方法はありません。
- 名前変更してもペアリングは解除されない
- ペアリングされたアイテムは、名前を変更してもペアのままです。
- そのため、異なる名前でもペアリングされている場合があります。
- ペアリングされていないアイテムは単独で表示される
- ペアリングされていない場合、同じ名前・種類でも重複してコピーされ、単独の行として表示されます。
以下は、開発ステージとテストステージで、それぞれのセマンティックモデルをもとに新規にレポートを作成した場合の、テストステージの画面です。
下から2行はペアリングされていないため、単独の行として表示されています。
新しいＵＩ
現在は新しいユーザーインターフェイス（UI）が利用可能となっています。新しい UI は元の UI と機能は同じであり、元の UI でできることは、新しい UI でも行うことができます。
新しい UI の主な変更点として、ステージを選択するとそのステージに関連するすべての操作を一箇所で行えるようになっています。また、デプロイ対象のアイテムを検索、フィルター、ソートする機能などが含まれています。
本記事では、新しい UI を使用して操作をご紹介しています。ただし、新しい UI は現在プレビュー段階のため、動作に不具合等が生じる可能性があります。その場合は、旧 UI に戻して試していただくことを推奨します。
前提条件・制限事項
デプロイパイプラインではいくつかの前提条件や制限事項がございます。
要件
デプロイパイプラインを作成・管理するには、以下の条件を満たす必要があります。
- Fabric 容量 または Premium ライセンス（Per Capacity または Per User）を所有していること
- Fabric ワークスペースの管理者 であること
サポートされているアイテム
デプロイパイプラインでデプロイ可能なコンテンツには、レポート、ダッシュボード、セマンティックモデルの他にも、 Fabric アイテムも含まれます。
現在、 Fabric アイテムの多くはプレビュー段階にあります。
プレビュー機能は今後変更される可能性があるため、利用時には注意いただきますようお願いいたします。
デプロイ時にコピーされるデータ
デプロイ時には、レポートのビジュアルやデータソース（配置ルール）の定義などのメタデータがコピーされますが、実際のデータや資格情報はコピーされません。
そのため、各ステージで適切なデータソースへの接続設定と更新を行う必要があります。
配置ルール作成手順 データソースの規則
本セクションでは、デプロイパイプラインを作成した後の配置ルール「データソース規則」を設定する方法についてご紹介いたします（手順 7 - デプロイ規則を作成する）。
前提として、以下の公開情報の手順 1～6 までの別のステージにコンテンツにデプロイが完了している状態を想定しています。
手順 1～6 の詳細については、公開情報をご確認ください。
Note
参考情報：展開パイプライン (Fabric のアプリケーション ライフサイクル管理 (ALM) ツール) の使用を開始する - Microsoft Fabric | Microsoft Learn
前提となる環境
デプロイパイプラインの「データソース規則」 を設定することで、各ステージ（開発、テスト）で異なるデータソース を使用します。
本手順では、以下の環境を想定しています。
サーバー名とデータベースが異なり、スキーマ名とテーブル名が同一です。
| ステージ | サーバー名 | データベース名 | スキーマ名 | テーブル名 |
|---|---|---|---|---|
| 開発 | deployment-pipelines-server-dev.database.windows.net | deployment-pipelines-db-dev | salesLT | salesData |
| テスト | deployment-pipelines-server-test.database.windows.net | deployment-pipelines-db-test | salesLT | SalesData |
データの違いは以下の通りです。
開発データ
| SalesID | ProductName | Quantity | SalesDate |
|---|---|---|---|
| 1 | Test Product A | 10 | 2025-01-01 |
| 2 | Test Product B | 20 | 2025-01-02 |
テストデータ
| SalesID | ProductName | Quantity | SalesDate |
|---|---|---|---|
| 1 | Real Product A | 100 | 2025-01-01 |
| 2 | Real Product B | 200 | 2025-01-02 |
| 3 | Real Product C | 300 | 2025-01-03 |
| 4 | Real Product D | 400 | 2025-01-04 |
開発のステージのレポートと各ステージのパイプライン
開発ステージのレポート
開発ステージのパイプライン
テストステージのパイプライン
作成手順
テストステージへアクセス
a. Power BI サービスにアクセスし、対象のデプロイパイプラインを開く。
b. テストステージを開く。配置ルールの設定を開く
a. テストステージの「配置ルール」ボタンをクリック。
b. 対象のセマンティックモデルを選択。データソース規則の作成
a. 「データソースの規則」を選択。
b. 「規則の追加」ボタンをクリックして、新しいルールを作成。テストステージ用のデータソースを設定
a. テストステージ用のサーバー名とデータベース名を設定し、保存する。
コンテンツの再デプロイ
a. 開発ステージからテストステージへ再デプロイする。テストステージの資格情報の設定
a. テストステージのセマンティックモデルの資格情報を確認。
b. 次のようなメッセージが表示されている場合、テストステージ用の資格情報を設定する。
「データソースへの接続をテストできませんでした。資格情報をもう一度お試しください。」
セマンティックモデルの更新と動作確認
a. テストステージのセマンティックモデルを更新して、データを取得。
b. テストステージのレポートが、テストステージ用のデータを反映していることを確認。
なお、配置ルールでサポートされているデータソース については、以下のリンクを参照してください。
Note
配置ルール作成手順 パラメーターの規則
前のセクションではサーバー名とデータベース名が異なる場合の例を紹介しましたが、スキーマ名やテーブル名が異なるケースもあります。本セクションでは、その場合の対応方法を紹介します。
以下のように、 スキーマ名とテーブル名も異なる状況を想定します。
| ステージ | サーバー名 | データベース名 | スキーマ名 | テーブル名 |
|---|---|---|---|---|
| 開発 | deployment-pipelines-server-dev.database.windows.net | deployment-pipelines-db-dev | dev | salesDataDev |
| テスト | deployment-pipelines-server-test.database.windows.net | deployment-pipelines-db-test | test | SalesDataTest |
デプロイパイプラインでは「パラメーター規則」が使用できますので、 Power BI Desktop でパラメーターを作成し、詳細エディターでそのパラメーターを参照するように修正します。
なお、 Power BI でのパラメーターの作成方法の詳細は以下のブログをご参照ください。
以下は、作成したパラメーターと詳細エディターの画面です。
[注意] パラメーターの規則を使う場合、パラメーターが Text型である必要があります。
パラメーターの作成完了後、開発ステージへの発行、テストステージへデプロイし、デプロイパイプラインのテストステージの「配置ルール」から「パラメーターの規則」を次のように設定します。
なお、これら以外の手順は「データソースの規則」と同様のため割愛します。
おわりに
この記事では、デプロイパイプライン（配置パイプライン）の概要と、配置ルールの作成手順についてご説明しました。
デプロイパイプラインを利用することで、異なる環境間での一貫性を保ったデプロイが可能となり、手動操作のミスを減らすことができます。また、配置ルールを活用することで、環境ごとの設定を柔軟に管理できるため、効率的な開発・テスト・本番運用が実現できます。
本ブログが皆様の業務効率化にお役立ていただければ幸いです。
以上、本ブログが少しでも皆様のお役に立てますと幸いでございます。
アンケートご協力のお願い
Japan CSS Support Power BI Blog では、作成する記事やブログの品質向上を目的に、匿名回答でのアンケートを実施しております。
ユーザー様のご意見・ご要望を参考に今後もお役に立てるブログを目指してまいりますので、ぜひご協力いただけますと幸いでございます。
※ 所要時間は1分程度となります。
【ご協力のお願い】Microsoft Japan CSS Power BI Blog ご利用に関するアンケート
※本情報の内容（添付文書、リンク先などを含む）は、作成日時点でのものであり、予告なく変更される場合があります。