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

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

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

前提条件

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

Fabric の前提条件

Git 統合機能にアクセスするには、次のいずれかが必要です。

• Power BI Premium ライセンス。 Power BI Premium ライセンスでは、すべての Power BI アイテムのみがサポートされます。
• Fabric の容量。 サポートされているすべての Fabric 項目を使用するには、Fabric 容量が必要です。 お持ちでない場合は、無料試用版にサインアップしてください。

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

• ユーザーは Fabric 項目を作成できる
• ユーザーはワークスペースのアイテムをGitリポジトリと同期できる
• GitHub ユーザーのみ: ユーザーは、ワークスペース項目を GitHub リポジトリと同期できる

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

Git の前提条件

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

Azure DevOps

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

GitHub

• アクティブな GitHub アカウント。 GitHub アカウントを作成します。

• 次の個人アクセス トークンの 1 つ。

  • コンテンツリポジトリのアクセス許可に基づく読み取りおよび書き込みアクセス許可を持つ詳細なトークン (推奨)。

    

    このトークンを GitHub Enterprise で使用するには、次の手順に従ってください。

  • リポジトリ スコープが有効になっている GitHub クラシック トークンを作成します。

    

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

Power BI の前提条件

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

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

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

   

   Note

   ブランチが新しい場合は、作成と同期を求めるメッセージが表示されます。

2. .rdl ファイルをサービスのワークスペースにアップロードします。 OneDrive または Sharepoint はまだサポートされていません。

   

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

   

3. [ソース管理] を選択します。 ソース管理ウィンドウで、ファイルを選択してコミットします。

   

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

   

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

   

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

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

考慮事項と制限事項

• ページ分割されたレポートをサービスに発行/アップロードし、git を使用します。 git でファイルを開始した場合、ページ分割されたレポートは表示されません。

• git からページ分割されたレポートを削除する場合は、.rdl レポートだけでなく、フォルダー全体 を削除します。

• Git でページ分割されたレポートの名前を変更しても機能しません。 ただし、Power BI サービスで .rdl の名前を変更すると機能します。 ページ分割されたレポートの名前を変更する場合は、git からページ分割されたレポートを削除し、フォルダー全体を削除して、新しい名前の .rdl を含めてフォルダーを再作成する必要があります。

• ページ分割されたレポートは、別のワークスペースに移動しても、元のデータセットに接続されたままです。 ページ分割されたレポートを別のワークスペースに移動する場合は、Power BI Report Builder でデータセットを更新し、ページ分割されたレポートを Power BI サービスに再発行します。

次のステップ

• Git 統合の概要