次の方法で共有

Microsoft Fabric Git 統合とは

この記事では、Git バージョン管理と Microsoft Fabric アプリケーション ライフサイクル管理 (ALM) ツールを統合する方法について開発者に説明します。

注

Git 統合の一部の項目はプレビュー段階です。 詳細については、 サポートされている項目の一覧を参照してください。

Microsoft Fabricでの Git 統合により、開発者は開発プロセス、ツール、ベスト プラクティスを Fabric プラットフォームに直接統合できます。 Fabric で開発している開発者は、次のことができます。

  • 作業のバックアップとバージョン管理を行う
  • 必要に応じて前のステージに戻す
  • Git ブランチを使用して他のユーザーと共同作業する、または単独で作業する
  • 使い慣れたソース管理ツールの機能を適用して、Fabric アイテムを管理する

ソース管理との統合は、ワークスペース レベルで行われます。 開発者は、ワークスペース内で開発したアイテムを 1 つのプロセスでバージョン管理し、すべてのアイテムを完全に表示できます。 サブフォルダーを含むワークスペース構造は、Git リポジトリに保持されます。

サポートされている項目 一覧を参照してください。

Git 統合のネットワーク セキュリティ

Microsoft Fabricのワークスペース レベルのセキュリティでは、管理者が個々のワークスペースの受信保護と送信保護の両方を構成できるようにすることで、データのaccessとネットワーク接続をきめ細かく制御できます。 これらの制御により、機密データは信頼されたネットワーク境界内に保持され、Git 統合などの CI/CD ツールと統合されます。 詳細については、「継続的インテグレーション/継続的デプロイのネットワーク セキュリティ」を参照してください。

プライバシーに関する情報

Git 統合を有効にする前に、次のプライバシー ステートメントを確認してください。

サポートされている Git プロバイダー

次のGitプロバイダーがサポートされています。

サポートされているアイテム

現在、次のアイテムが Git 統合をサポートしています。

ワークスペースまたは Git ディレクトリにサポートされていないアイテムがある場合でも接続できますが、サポートされていないアイテムは無視されます。 これらは保存も同期もされませんが、削除もされません。 これらはソース control panelに表示されますが、コミットまたは更新することはできません。

考慮事項と制限事項

一般的な Git 統合の制限事項

  • Fabric の認証方法は、少なくとも Git の認証方法と同程度に強力である必要があります。 たとえば、Git で多要素認証が必要な場合、Fabric でも多要素認証が必要になります。
  • 現時点では、Analysis Services に接続されている Power BI データセットはサポートされていません。
  • 1 つの成果物でワークスペース ID を使用して Git にコミットした場合、同じ ID に接続されているワークスペースでのみ更新 (ファブリック ワークスペースに戻す) ことができます。 ブランチ アウトなどの機能にも影響するため、注意してください。
  • サブモジュールはサポートされていません。
  • ソブリンクラウドはサポートされていません。
  • ワークスペースに何百もの項目が含まれている場合は、小さなartifactsセットに分割することを検討してください。 各セットは、個別のワークスペースに配置し、異なる Git ブランチにリンクするか、異なるフォルダーに編成された単一のブランチに接続する必要があります。
  • Azure DevOps は、有効な IP 条件付きAccess ポリシー検証 が有効になっている場合はサポートされません。
  • ワークスペースと Git リポジトリが 2 つの異なる地理的リージョンにある場合、テナント管理者は 複数の地理的なエクスポートを有効にする必要があります。
  • 組織で conditional access を構成している場合は、認証が想定どおりに機能するように、Power BI Serviceに同じconditions setがあることを確認します。
  • 次のコミット サイズ制限が適用されます。
    • Azure DevOps コネクタとサービス プリンシパルを使用して 25 MB。
    • 既定のシングル サインオン (SSO) Microsoft Entra ID アカウントを使用し、125 MB を Azure DevOps コネクタとユーザー プリンシパルで管理します。

GitHub Enterprise の制限事項

一部のGitHub Enterprise のバージョンと設定はサポートされていません。 次に例を示します。

  • custom domainを持つエンタープライズ サーバー GitHubは、インスタンスがパブリックにアクセスできる場合でもサポートされていません
  • プライベート ネットワークでホストされているエンタープライズ サーバーのGitHub
  • IP 許可リスト

Azure DevOpsからGitHub Enterpriseへの移行に関する考慮事項

チームで Fabric Git Integration を使用し、Azure DevOps から GitHub Enterprise への移行を評価する場合は、検証テストを実行して Git 統合機能が影響を受けないようにすることをお勧めします。 Fabric Git Integration は、基になる Git プロバイダー API に依存します。これは、前述のように、Azure DevOps と GitHub Enterprise の機能と制限が異なります。

ワークスペースの制限事項

  • 接続、切断、ブランチの追加など、Git Repo への接続を管理できるのは、ワークスペース管理者だけです。
    接続すると、アクセス許可を持つすべてのユーザーがワークスペースで作業できるようになります。
  • テンプレート アプリがインストールされているワークスペースを Git に接続することはできません。
  • MyWorkspace は Git プロバイダーに接続できません。
  • ワークスペースには、最大 1,000 個のアイテムを含めることができます。 Git ブランチに 1,000 を超える項目が含まれている場合、ワークスペースへのコンテンツの同期は失敗します。 この制限を回避するには、artifactsをより小さなセットに分割することを検討してください。 各セットは、個別のワークスペースに配置し、異なる Git ブランチにリンクするか、単一のブランチ内の異なるフォルダーに編成する必要があります。 詳細については、 ワークスペース項目の制限に従ってください。

ブランチとフォルダーの制限事項

  • ブランチ名の最大長は 244 文字です。
  • ファイル名の完全パスの最大長は 250 文字です。 これより長い名前は失敗します。
  • 最大ファイル サイズは 25 MB です。
  • フォルダー構造は、最大 10 レベルの深さまで維持されます。
  • Git 統合を使用してレポート/データセットをデプロイした後、サービスから .pbix としてレポート/データセットをダウンロードすることはお勧めしません。結果は信頼できないためです。 Power BI Desktop を使用して、レポート/データセットを .pbix としてダウンロードすることをお勧めします。
  • 項目の表示名にこれらの特性のいずれかが含まれている場合、Git フォルダーの名前は論理 ID (Guid) に変更され、次のように入力されます。
  • フォルダーを含むワークスペースを Git に接続する場合、その フォルダー構造 が異なる場合は、Git リポジトリに変更をコミットする必要があります。

ディレクトリ名の制限事項

  • Git リポジトリに接続するディレクトリの名前には、次の名前付け制限があります。

    • ディレクトリ名の先頭または末尾をスペースまたはタブにすることはできません。
    • ディレクトリ名には、次の文字を含めることはできません: "/:<>\*?|

  • アイテム フォルダー (アイテム ファイルを含むフォルダー) には、次の文字を含めることはできません: ":<>\*?|。 フォルダーの名前をこれらの文字のいずれかを含む名前に変更すると、Git はワークスペースに接続または同期できなくなり、エラーが発生します。

分岐の制限事項

  • ブランチ アウトには、アクセス許可テーブル に記載されているアクセス許可が必要です。
  • このアクションには使用可能な容量が必要です。
  • ワークスペース と ブランチの名前付けの制限事項 はすべて新しいワークスペースにブランチ アウトするときに適用されます。
  • 新しいワークスペースでは、Git でサポートされている項目 のみを使用できます。
  • 関連するブランチの一覧には、表示するアクセス許可を持つブランチとワークスペースのみが表示されます。
  • Git 統合 を有効にする必要があります。
  • 分岐すると、新しいブランチが作成され、元のブランチの設定はコピーされません。 すべての設定または定義を調整して、新しい設定が組織のポリシーを満たしていることを確認します。
  • 既存のワークスペースに分岐する場合:
    • ターゲット ワークスペースは Git 接続をサポートしている必要があります。
    • ユーザーは、ターゲット ワークスペースの管理者である必要があります。
    • ターゲット ワークスペースには容量が必要です。
    • ワークスペースにテンプレート アプリを含めることはできません。
  • ワークスペースに分岐すると、Git に保存されていない項目が失われる可能性があることに注意してください。 分岐する前に、保持する必要がある項目をコミットすることをお勧めします。

同期とコミットの制限事項

  • 同期できる方向は一度に 1 つだけです。 同時にコミットと更新をすることはできません。
  • 秘密度ラベルはサポートされていないため、秘密度ラベルを持つアイテムのエクスポートは無効化される可能性があります。 秘密度ラベルのない秘密度ラベルを持つ項目をコミットするには、 管理者にヘルプを依頼してください 。
  • 制限付きアイテムで動作します。 フォルダー内のサポートされていない項目は無視されます。
  • 名前の複製は許可されません。 Power BI で名前の重複が許可されている場合でも、更新、コミット、または元に戻すアクションは失敗します。
  • B2B はサポートされていません。
  • 競合の解決 は、Git で部分的に行われます。
  • Git へのコミット プロセス中に、Fabric サービスは、アイテム定義の一部ではないアイテム フォルダー内のファイルを削除します。 アイテム フォルダーにない無関係なファイルは削除されません。
  • 変更をコミットした後、自分が加えなかった予期しない変更が項目に加えられる場合があります。 これらの変更は意味的には重要ではなく、いくつかの理由で発生する可能性があります。 例:
    • 項目定義ファイルを手動で変更します。 これらの変更は有効ですが、エディターを使用して行った場合とは異なる可能性があります。 たとえば、Git でセマンティック モデル列の名前を変更し、この変更をワークスペースにインポートすると、次回セマンティック モデルに変更をコミットするときに、bim ファイルが変更済みとして登録され、変更された列が columns 配列の後ろにプッシュされます。 これは、bim ファイルを生成する AS エンジンが名前変更された列を配列の最後にプッシュするためです。 この変更は項目の動作には影響しません。
    • CRLF 改行を使用するファイルをコミットする。 このサービスでは LF (ライン フィード) 改行を使用しています。 CRLF 改行を含む項目ファイルが Git リポジトリにある場合、サービスからコミットすると、これらのファイルは LF に変更されます。 たとえば、デスクトップでレポートを開いた場合は、project ファイル (.pbip) を保存し、CRLF を使用して Git にアップロードします。
  • 拡張更新 API を使ってセマンティック モデルを更新すると、更新のたびに Git diff が行われます。

関連するコンテンツ

  • Last updated on