この記事では、Microsoft Fabric のユーザー データ関数に対して Git 統合とデプロイ パイプラインがどのように機能するかについて説明します。 Git 統合を使用すると、Fabric ワークスペースをリポジトリ ブランチと同期させ、ユーザー データ関数のバージョン管理、ブランチとプル要求を使用した共同作業、Azure DevOps などの任意の Git ツールでのコードの操作を行うことができます。
Git 統合の 基本的な概念で Git と Microsoft Fabric ワークスペースを統合するプロセスの詳細について説明します。
接続を設定する
ワークスペースの設定から、変更をコミットして同期するためのリポジトリへの接続を簡単に設定できます。 接続を設定するには、「 Git 統合の概要」を参照してください。 接続すると、ユーザー データ関数を含む項目が [ソース管理 ] ウィンドウに表示されます。
ユーザー データ関数項目を Git リポジトリに正常にコミットすると、リポジトリにユーザー データ関数フォルダーが表示されます。 プル要求の作成など、今後の操作を実行できるようになりました。
Git でのユーザー データ関数の表現
次の図は、リポジトリ内の各ユーザー データ関数項目のファイル構造の例を示しています。
フォルダー構造には、次の要素が含まれています。
.platform:
.platformファイルには、次の属性が含まれています。
- version: システム ファイルのバージョン番号。 この数値は、下位互換性を有効にするために使用されます。 アイテムのバージョン番号が異なる場合があります。
- logicalId: アイテムとそのソース管理表現を表す、自動的に生成されたクロスワークスペース識別子。
-
type:
UserDataFunctionは、ユーザー データ関数項目を定義する型です。 - displayName: 項目の名前を表します。 ユーザー データ関数項目の名前が変更されると、この displayName が更新されます。
definitions.json: このファイルは、接続、ライブラリなどのすべてのユーザー データ関数項目定義を、ユーザー データ関数項目のプロパティの表現として共有します。
function-app.py: このファイルは関数コードです。 ユーザー データ関数項目に対して行ったコード変更はすべて、このファイルを使用してリポジトリに同期されます。 さまざまな Git 操作を実行して、コード開発サイクルを管理できます。
resources: フォルダーには、このアイテム内の接続、ライブラリ、関数などのすべてのメタデータを含む functions.json ファイルが含まれています。 このファイルは手動で更新しないでください 。
functions.jsonを使用すると、Fabric はワークスペース内のユーザー データ関数項目を作成または再作成できます。
フォルダー構造とシステム ファイルの詳細など、Git 統合の詳細については、 Git 統合のソース コード形式に関するページを参照してください。
デプロイ パイプラインのユーザー データ関数
デプロイ パイプラインを使用して、開発、テスト、運用など、さまざまな環境にユーザー データ関数をデプロイできます。 デプロイ パイプラインは、開発プロセスを合理化し、品質と一貫性を確保し、軽量でコードの少ない操作で手動エラーを減らすのに役立ちます。
注
すべての接続とライブラリは、他の環境で作成された新しいユーザー データ関数項目に追加されます。
デプロイ パイプラインを使用してユーザー データ関数をデプロイするには:
新しいデプロイ パイプラインを作成するか、既存のデプロイ パイプラインを開きます。 詳細については、「 デプロイ パイプラインの概要 」を参照してください。
デプロイの目標に応じて、異なるステージにワークスペースを割り当てます。
さまざまなステージ間でユーザー データ関数項目を含む項目を選択、表示、比較します。
[ デプロイ] を選択して、テスト環境にユーザー データ関数項目をデプロイします。 このデプロイの変更の詳細を提供するメモを追加できます。 同様に、開発、テスト、運用の各段階で変更をプッシュできます。
デプロイ履歴からデプロイの状態を監視します。