Microsoft Fabric Git 統合の概要

  • [アーティクル]

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

Note

Git 統合の一部の項目はプレビュー段階です。 詳しくは、「サポートされているアイテム」の一覧をご覧ください。

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

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

ソース管理との統合は、ワークスペース レベルで行われます。 開発者は、ワークスペース内で開発したアイテムを 1 つのプロセスでバージョン管理し、すべてのアイテムを完全に表示できます。 現在、いくつかのアイテムのみがサポートされていますが、一覧のサポートされているアイテムは増え続けています。

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

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

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

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

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

現在、次のアイテムがサポートされています。

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

考慮事項と制限事項

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

  • Fabric の認証方法は、少なくとも Git の認証方法と同程度に強力である必要があります。 たとえば、Git で多要素認証が必要な場合、Fabric でも多要素認証が必要になります。
  • 現時点では、Analysis Services に接続されている Power BI データセットはサポートされていません。
  • テンプレート アプリがインストールされているワークスペースを Git に接続することはできません。
  • ソブリン クラウドはサポートされていません。
  • Azure DevOps アカウントは、Fabric ワークスペースを使用しているのと同じユーザーに登録する必要があります。
  • ワークスペースと Git リポジトリが 2 つの異なる地理的リージョンにある場合、テナント管理者はクロス geo エクスポートを有効にする必要があります。
  • コミットのサイズ制限は 125 MB です。

GitHub Enterprise の制限

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

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

  • Git Repo への接続 (接続、切断、ブランチの追加など) は、ワークスペース管理者のみが管理できます。
    接続すると、アクセス許可を持つすべてのユーザーがワークスペースで作業できるようになります。
  • ワークスペース フォルダー構造は、Git リポジトリに反映されません。 フォルダー内のワークスペース項目は、ルート ディレクトリにエクスポートされます。

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

  • ブランチ名の最大長は 244 文字です。
  • ファイル名の完全パスの最大長は 250 文字です。 これらより長い名前は失敗します。
  • 最大ファイル サイズは 25 MB です。
  • レポートまたはデータセットは、Git 統合を使用してデプロイすると、サービスから .pbix としてダウンロードできなくなります。
  • Git でフォルダーに名前を付けるとき、アイテムの表示名のタイプの前に論理 ID (Guid) がプレフィックスとして追加されます。
    • 256 文字を超える場合
    • 末尾が . またはスペースの場合
    • 次のいずれかの文字が含まれる場合: " / : < > \ * ? |

ブランチ アウトの制限事項

  • ブランチ アウトには、アクセス許可テーブル に記載されているアクセス許可が必要です。
  • このアクションには使用可能な容量が必要です。
  • ワークスペース と ブランチの名前付けの制限事項 はすべて新しいワークスペースにブランチ アウトするときに適用されます。
  • ブランチ アウトすると、新しいワークスペースが作成され、元のワークスペースの設定はコピーされません。 すべての設定または定義を調整して、新しいワークスペースが組織のポリシーを満たしていることを確認します。
  • 新しいワークスペースでは、Git でサポートされている項目 のみを使用できます。
  • 関連するブランチの一覧には、表示するアクセス許可を持つブランチとワークスペースのみが表示されます。
  • Git 統合 を有効にする必要があります。

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

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

関連するコンテンツ