Git を使用してワークスペースを管理します (プレビュー)

  • [アーティクル]

この記事では、Microsoft Fabric の Git 統合ツールにおける次の基本タスクについて説明します。

始める前に、Git 統合の概要を読んでおくことをお勧めします。

重要

この機能はプレビュー段階にあります。

前提条件

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

Azure DevOps の前提条件

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

Fabric の前提条件

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

  • Power BI Premium ライセンス。 Power BI Premium ライセンスでは、すべての Power BI アイテムのみがサポートされます。
  • Fabric の容量。 サポートされているすべての Fabric 項目を使用するには、Fabric 容量が必要です。

さらに組織の管理者は、管理ポータルから [ユーザーは Fabric アイテムを作成できます] テナント スイッチを有効にする必要があります。

Fabric スイッチが有効になっているスクリーンショット。

ワークスペースを Azure Repos に接続する

ワークスペース管理者のみがワークスペースを Azure Repos に接続できますが、一度接続すると、アクセス許可を持つすべてのユーザーがワークスペースで作業できます。 管理者でない場合は、管理者に連絡して、接続の支援をしてもらってください。 ワークスペースを Azure Repos に接続するには、次の手順に従います。

  1. Power BI にサインインし、接続するワークスペースに移動します。

  2. [ワークスペース設定] に移動します

    上部に [ワークスペース設定] アイコンが表示されたワークスペースのスクリーンショット。

    Note

    [ワークスペース設定] アイコンが表示されない場合は、省略記号 (3 つのドット) を選択してから、[ワークスペース設定] を選択します。 省略記号から表示されたワークスペース設定リンクを含むワークスペースのスクリーンショット。

  3. [Git 統合] を選択します。 Fabric にサインインした Microsoft Entra ユーザーに登録されている Azure Repos アカウントに自動的にサインインします。

    Git 統合が選択されたワークスペース設定ウィンドウのスクリーンショット。

  4. ドロップダウン メニューから、接続するブランチに関する以下の詳細情報を指定します。

    Note

    ワークスペースは、一度に 1 つのブランチおよびフォルダーにのみ接続できます。

    • 組織
    • プロジェクト
    • Git リポジトリ
    • ブランチ (このドロップダウン メニューを使用して既存のブランチを選択する、または [+ 新しいブランチ] を選択して新しいブランチを作成します。一度に接続できるブランチは 1 つだけです)。
    • フォルダー (ブランチ内の既存のフォルダーを選択するか、名前を入力して新しいフォルダーを作成します。フォルダーを選択しない場合、コンテンツはルート フォルダーに作成されます。一度に 1 つのフォルダーのみに接続できます。)

  5. [接続と同期] を選択します。

初期同期中に、ワークスペースまたは Git ブランチが空の場合、コンテンツは空ではない場所から空の場所にコピーされます。 ワークスペースと Git ブランチの両方にコンテンツがある場合、同期をどちらの方向に行うかを尋ねられます。 この初期同期の詳細については、「接続と同期」を参照してください。

接続すると、ワークスペースにソース管理に関する情報が表示され、ユーザーは接続されたブランチ、ブランチ内の各項目の状態、最後の同期時刻を表示できます。

[ソース管理] アイコンおよびその他の Git 関連情報のスクリーンショット。

ワークスペースと Git ブランチの同期を保つには、ワークスペースで行った変更をすべて Git ブランチにコミットし、誰かが Git ブランチに新しいコミットを作成するたびにワークスペースを更新します。

Git に変更をコミットする

Git フォルダーに正常に接続したら、通常どおりワークスペースを編集します。 保存した変更はワークスペースにのみ保存されます。 準備ができたら、変更を Git ブランチにコミットすることも、変更を元に戻して前の状態に戻すこともできます。 コミットの詳細については、こちらをご覧ください。

変更を Git ブランチにコミットするには、次の手順に従います。

  1. ワークスペースに移動します。

  2. [ソース管理] アイコンを選びます。 このアイコンは、コミットされていない変更の数を示します。 コミットする変更が 2 つあることを示す、数字 2 が付いたソース管理アイコンのスクリーンショット。

  3. [ソース管理] ペインの [変更] タブを選択します。 変更したすべての項目を含むリストが表示され、項目が新規、変更済み、競合、削除済みのいずれであるかを示すアイコンが表示されます。

  4. コミットする項目を選択します。 すべての項目を選択するには、上部のボックスにチェックを入れます。

  5. ボックスにコメントを追加します。 コメントを追加しない場合は、既定のメッセージが自動的に追加されます。

  6. [コミット] を選択します。

    コミットする 2 つの変更が選択されたソース管理ウィンドウのスクリーンショット。

変更がコミットされると、コミットされた項目はリストから削除され、ワークスペースは同期先の新しいコミットを指すようになります。

コミットする変更がないことを示すソース管理ウィンドウのスクリーンショット。

コミットが正常に完了すると、選択した項目の状態が [未コミット] から [同期済み] に変わります。

Git からワークスペースを更新する

接続された Git ブランチに新しい変更をコミットすると、関連するワークスペースに通知が表示されます。 [ソース管理] ペインを使用して、最新の変更、マージ、または元に戻す作業をワークスペースに取り込み、ライブ項目を更新します。 更新に関する詳細をご覧ください。

ワークスペースを更新するには、次の手順に従います。

  1. ワークスペースに移動します。
  2. [ソース管理] アイコンを選びます。
  3. [ソース管理] ペインの [更新] タブを選択します。 前回の更新以降にブランチで変更されたすべての項目のリストが表示されます。
  4. [すべて更新] を選択します。

[更新] タブが開き、[すべて更新] ボタンが選択されているソース管理ペインのスクリーンショット。

更新が正常に完了すると、項目のリストが削除され、ワークスペースは同期先の新しいコミットを指すようになります。

ワークスペースが正常に更新されたことを示すソース管理ウィンドウのスクリーンショット。

更新が正常に完了すると、項目の状態が [同期済み] に変わります。

Git からワークスペースを切断する

ワークスペース管理者のみが Azure Repos からワークスペースを切断できます。 管理者ではない場合は、切断について管理者に問い合わせてください。 管理者がリポジトリを切断する場合は、次の手順に従います。

  1. [ワークスペース設定] に移動します

  2. [Git 統合] を選択します

  3. [ワークスペースの切断] を選択します

    ワークスペースの切断オプションがあるワークスペース設定画面のスクリーンショット。

  4. もう一度 [切断] を選択して確認します。

    切断するかどうかを確認するワークスペース設定画面のスクリーンショット。

アクセス許可

ワークスペースに対して実行できるアクションは、ワークスペースと Azure DevOps の両方で使用できるアクセス許可によって異なります。 アクセス許可の詳細については、「アクセス許可」を参照してください。

考慮事項と制限事項

  • Git へのコミット プロセス中に、Fabric サービスは、項目定義の一部ではない項目フォルダー内のファイルをすべて削除します。 項目フォルダー内にない無関係なファイルは削除されません。

  • 変更をコミットした後、自分が加えなかった予期しない変更が項目に加えられる場合があります。 これらの変更は意味的には重要ではなく、いくつかの理由で発生する可能性があります。 次に例を示します。

    • 項目定義ファイルを手動で変更します。 これらの変更は有効ですが、エディターを使用して行った場合とは異なる可能性があります。 たとえば、Git でセマンティック モデル列の名前を変更し、この変更をワークスペースにインポートすると、次回セマンティック モデルに変更をコミットするときに、bim ファイルが変更済みとして登録され、変更された列が columns 配列の後ろにプッシュされます。 これは、bim ファイルを生成する AS エンジンが名前変更された列を配列の最後にプッシュするためです。 この変更は項目の動作には影響しません。

    • CRLF 改行を使用するファイルをコミットする。 このサービスでは LF (ライン フィード) 改行を使用しています。 CRLF 改行を含む項目ファイルが Git リポジトリにある場合、サービスからコミットすると、これらのファイルは LF に変更されます。 たとえば、デスクトップでレポートを開いた場合は、.pbip プロジェクトを保存し、CRLF を使用して Git にアップロードします。

  • これらのアクションで問題が発生した場合は、Git 統合機能の制限を必ず確認してください。

関連するコンテンツ