Git とページ分割されたレポートの統合

2025-05-21

適用対象: Power BI サービス Power BI Report Builder Power BI Desktop

この記事では、ページ分割されたレポートを発行し、Git ワークスペースとの同期を維持する手順について説明します。開発者は、開発プロセス、ツール、ベストプラクティスを適用できます。

前提条件

Git を Microsoft Fabric ワークスペースに統合するには、Fabric と Git の両方に対して次の前提条件を設定する必要があります。

Fabric の前提条件

Git 統合機能にアクセスするには、Fabric 容量が必要です。サポートされているすべての Fabric 項目を使用するには、Fabric 容量が必要です。お持ちでない場合は、無料試用版にサインアップしてください。既に Power BI Premium 容量を持っているお客様は、その容量を使用できますが、特定の Power BI SKU は、Power BI 項目のみをサポートします。

さらに、管理ポータルから次のテナントスイッチを有効にする必要があります。

ユーザーは Fabric 項目を作成できる
ユーザーはワークスペースのアイテムをGitリポジトリと同期できる
ワークスペースを作成する (新しいワークスペースに分岐する場合のみ)。
ユーザーは、ワークスペース項目を GitHub リポジトリと同期できます:GitHub ユーザーのみ

これらのスイッチは、組織の設定に応じて、テナント管理者、容量管理者、またはワークスペース管理者が有効にすることができます。

Git の前提条件

現在、Git 統合は Azure DevOps と GitHub でサポートされています。 Fabric ワークスペースと Git 統合を使用するには、Azure DevOps または GitHub で次のものが必要です。

Azure DevOps
GitHub

Fabric ワークスペースを使用している同じユーザーに登録されているアクティブな Azure アカウント。無料アカウントを作成します。

Git と Microsoft Fabric の統合については、「Git 統合の概要」を参照してください。

Power BI の前提条件

「Power BI サービスで改ページ対応レポートを作成する方法の概要」の「前提条件」セクションを参照してください。

改ページ対応レポートを GitHub に追加する

「ワークスペースを Azure リポジトリに接続する」の指示に従って、ワークスペースを Git リポジトリに接続します。

注

ブランチが新しい場合は、作成と同期を求めるメッセージが表示されます。
.rdl ファイルをサービスのワークスペースにアップロードします。 OneDrive または Sharepoint はまだサポートされていません。

ファイルをアップロードすると、レポートと Git の状態は "コミットされていない"、"ソース管理" と表示されます。
[ソース管理] を選択します。ソース管理ウィンドウで、ファイルを選択してコミットします。

ファイルをコミットすると、Git の状態は "同期" に変わります。

.rdl ファイルと 2 つの .json ファイルを含むフォルダーが Git リポジトリに表示されます。リポジトリを更新する必要がある場合があります。

GitHub に保存されている改ページ対応レポートを編集する

Power BI Report Builder のローカル Git リポジトリから .rdl ファイルを開きます。
目的の編集を行います。
変更をコミットし、リモートリポジトリにプッシュします。
main ブランチへの PR を作成します。
承認されると、PR は main ブランチにマージされます。
main ブランチから、変更した変更を関連するワークスペースに適用します。

考慮事項と制限事項

ページ分割されたレポートをサービスに発行/アップロードし、git を使用します。 git でファイルを開始した場合、ページ分割されたレポートは表示されません。
git からページ分割されたレポートを削除する場合は、.rdl レポートだけでなく、フォルダー全体 を削除します。
Git でページ分割されたレポートの名前を変更しても機能しません。ただし、Power BI サービスで .rdl の名前を変更すると機能します。ページ分割されたレポートの名前を変更する場合は、git からページ分割されたレポートを削除し、フォルダー全体を削除して、新しい名前の .rdl を含めてフォルダーを再作成する必要があります。
ページ分割されたレポートは、別のワークスペースに移動しても、元のデータセットに接続されたままです。ページ分割されたレポートを別のワークスペースに移動する場合は、Power BI Report Builder でデータセットを更新し、ページ分割されたレポートを Power BI サービスに再発行します。

次のステップ

Git 統合の概要