ノートブックのソース管理とデプロイ
この記事では、Microsoft Fabric のノートブックに対する Git 統合とデプロイ パイプラインのしくみを説明します。 リポジトリへの接続の設定、ノートブックの管理、さまざまな環境へのデプロイを行う方法について説明します。
ノートブック Git 統合
Fabric ノートブックは、 Azure DevOps とのソース管理のための Git 統合を提供します。 Git 統合では、ノートブックのバックアップとバージョン管理、必要に応じた前段階への復帰、Git ブランチを使用した共同作業または単独作業、およびノートブックのコンテンツのライフサイクルを完全に Fabric 内で管理できます。
重要
この機能はプレビュー段階にあります。
接続を設定する
ワークスペース設定から、変更をコミットして同期するためのリポジトリへの接続を簡単に設定できます。 接続を設定するには、「Git 統合での作業開始」を参照してください。 接続すると、ノートブックを含む項目が [ソース管理] パネルに表示されます。
ノートブック インスタンスを Git リポジトリに正常にコミットすると、リポジトリ内にノートブック フォルダー構造が表示されます。
これで、pull request の作成など、今後の操作を実行できるようになります。
Git でのノートブックの表現
次の画像は、リポジトリ内の各ノートブック項目のファイル構造の例です。
ノートブック項目を Git リポジトリにコミットすると、ノートブック コードは標準の .ipynb ファイルではなく、ソース コード形式に変換されます。 たとえば、PySpark ノートブックでは notebook-content.py ファイルに変換します。 この方法によって、組み込みの差分機能を使用して簡単にコード レビューできるようになります。
項目コンテンツ ソース ファイルでは、メタデータ (既定のレイクハウスおよびアタッチされた環境を含む)、マークダウン セル、およびコード セルが保持され、区別されます。 この方法は、Fabric ワークスペースに同期して戻すときの正確なリカバリをサポートします。
Git に同期する場合、ノートブックのセル出力は含まれません。
Note
- 現時点では、 Notebook リソース内のファイルはリポジトリにコミットされていません。 これらのファイルのコミットは、今後のリリースでサポートされます。
- リポジトリから Fabric ワークスペースに同期すると、アタッチされた環境がノートブックに保持されます。 現時点では、ワークスペース間参照環境はサポートされていません。 ノートブックを実行するには、新しい環境またはワークスペースの既定の設定に手動でアタッチする必要があります。
- リポジトリから Fabric ワークスペースに同期すると、既定のレイクハウス ID がノートブックに保持されます。 既定のレイクハウスを使用してノートブックをコミットする場合は、新しく作成されたレイクハウス項目を手動で参照する必要があります。 詳細については、「レイクハウス Git 統合」を参照してください。
デプロイ パイプライン内のノートブック
デプロイ パイプラインを使用して、開発、テスト、運用などのさまざまな環境にノートブック コードをデプロイすることもできます。 この機能を使用すると、軽量のローコード操作で開発プロセスを合理化し、品質と一貫性を確保し、手動エラーを削減できます。 また、デプロイ ルールを使用して、ノートブックの既定のレイクハウスの変更など、デプロイ時のノートブックの動作のカスタマイズもできます。
重要
この機能はプレビュー段階にあります。
デプロイ パイプラインを使用してノートブックのデプロイを完了するには、次の手順に従います。
新しいデプロイ パイプラインを作成するか、既存のデプロイ パイプラインをオープンします。 詳細については、「デプロイ パイプラインの概要」を参照してください。
デプロイの目標に応じて、ワークスペースをさまざまなステージに割り当てます。
次の例に示すように、さまざまなステージ間でノートブックを含む項目を選択、表示、比較します。
[デプロイ] を選択して、開発、テスト、運用の各ステージにノートブックをデプロイします。
(省略可能)[デプロイ規則] を選択して、デプロイ プロセスのデプロイ規則を作成できます。 デプロイ規則のエントリは、デプロイ プロセスのターゲット ステージにあります。
Fabric は、デプロイ規則を使用してデプロイするときに、各ノートブック インスタンスにおいて既定のレイクハウスのパラメーター化をサポートします。 ターゲットの既定のレイクハウスを指定するには、[ソース レイクハウスと同じ]、[N/A] (既定のレイクハウスではない)、および [その他のレイクハウス] の 3 つのオプションが使用できます。
この規則を設定すると、セキュリティで保護されたデータの分離を実現できます。 ノートブックの既定のレイクハウスは、デプロイ時にターゲットとして指定したレイクハウスに置き換えられます。
Note
ターゲット環境で他のレイクハウスを採用する場合は、レイクハウス ID が必要です。 レイクハウスの ID は、レイクハウスの URL リンクから確認できます。
デプロイ履歴からデプロイの状態をモニターします。