Microsoft Fabricにおけるデプロイメントプランとは何ですか? (プレビュー)

Microsoft Fabricのデプロイメントプランは、デプロイメント操作に明示的なアイテムの順序や自動アクションを追加するワークスペースアイテムです。 計画を使って特定の順序でアイテムを展開しましょう。 また、ノートブックやデータパイプライン、その他サポートされているアイテムを展開の前後に実行することもできます。

展開計画は以下の展開ツールで動作します:

• Git の統合
• デプロイメントパイプライン
• 対応REST API

本記事における デプロイメントツール とは、これらサポートされているツールのいずれかを指します。 プランを単体で実行するわけではありません。 デプロイツールで作業を開始するときにアタッチします。

デプロイメントプランを使うタイミング

次の場合に展開計画を活用してください:

デプロイメントツールの標準的な順序だけで十分で、アクションが不要であれば、デプロイメントプランは必要ありません。

展開計画の構成要素

展開計画には以下の構成要素が含まれます:

サポートされたアクションタイプおよびアクション動作については 、デプロイメント計画アクションを参照してください。

展開計画の仕組み

各展開操作は以下の3つの入力を組み合わせています:

• 選択品:作戦のために選ばれた品物。
• 展開計画:それらの項目に関連する明確な順序と行動。
• Fabric 系譜:Fabricがアイテム間で検出する依存関係。

展開範囲を決定する

展開ツールは、発生源、ターゲット、作戦中のアイテムを決定します。 プランを添付しても、その選択が取って代わるわけではありません。 デプロイグループに属さない選択されたアイテムは、ツールの標準動作でデプロイされます。

プランを添付しても参照する項目を自動的に選択するわけではありません。 選択展開面で、展開したい項目を選択し、そのアクションを実行する際に計画のアクションに必要な項目がターゲットワークスペースで利用可能であることを確認しましょう。

展開計画はアイテムの展開と行動を管理します。 ワークスペースレベルの設定、例えばワークスペースのアイデンティティ、接続、ゲートウェイバインディング、Spark設定は展開しません。 アクションがその設定に依存する前に、ターゲットワークスペースを設定してください。

展開命令を解決する

Fabricは、展開グループ間の明示的な依存関係と、リネージから検出された依存関係を組み合わせています。 プランは系譜が表さない順序を追加できますが、Fabricが検出する依存関係を除去することはできません。

選択された項目、プラン依存関係、リネージュ、ランタイムアクションがどのように連携して動作するかを示す詳細なシナリオについては、 デプロイメントプランの例を参照してください。

デプロイメントグループとアクションを実行します

各展開グループごとに、Fabricは事前展開アクションを実行し、グループのアイテムをデプロイし、その後ポストデプロイアクションを実行します。 グループやアクション間の依存関係がその順序を決定します。 項目の計画ファイル内の位置はその順序を決めるものではありません。

プランの添付は任意です。 計画がなければ、選択した展開ツールは標準的な動作を繰り返します。

展開計画を添付してください

サポートされるGit統合操作を使う際にプランを添付したり、デプロイメントパイプラインを通じてコンテンツをデプロイしたり、サポートされたREST APIを呼び出したりすることができます。 添付はその操作にのみ適用されます。 サポートサーフェスおよびプラン選択の動作については、「 展開計画の添付」を参照してください。

デプロイメント計画の作成とバージョン

デプロイメントプランキャンバスでプランを作成し、デプロイメントグループを追加し、その順序を定義し、アクションを設定します。 手順については「 展開計画の作成」をご覧ください。

デプロイメントプランはワークスペース項目です。 ワークスペースが Git に接続されている場合は、プランが参照している項目と一緒にそのプランをコミットして、そのプランを CI/CD プロセスで進められるようにします。

操作が失敗した場合

項目やアクションが失敗すると操作は停止し、完了した作業をロールバックしません。 障害の挙動や解決手順については 、「デプロイメント計画のトラブルシューティング」をご覧ください。

考慮事項と制限事項

一般的な展開計画の制限

• 1つのプランで1つの実行で複数のワークスペースに展開することはできません。
• 展開作業には1つの展開計画しか付与できません。

プランの添付に関する制限

• プラン添付は現在の作業にのみ適用されます。 将来のデプロイメントのデフォルトプランを設定したり、プラン自体をスケジュール設定することはできません。 展開ツールがオペレーションをスケジュールする場合、そのオペレーションは実行のたびにプランを添付しなければなりません。
• 単一アイテムのインポート操作に計画を付けることはできません。
• fabric-cicdライブラリは展開計画をサポートしていません。

展開中の制限事項

• 独立した展開グループを並行して展開することはできません。
• 失敗した展開はロールバックされません。 すでに展開されたアイテムはターゲットワークスペースに残り、後のアイテムはデプロイされません。

計画行動の制限

• サポートされたアイテムおよびジョブタイプの組み合わせのみが、デプロイ前またはデプロイ後のアクションとして実行できます。 アクション として実行できるアイテムタイプをご覧ください。
• 同じDataflow Gen2の項目をプラン内の複数のアクションで使うことはできません。 リフレッシュジョブは一度に複数回しか実行できないため、2回目の発生を追加するとキャンバスが警告し、2回目の発生はデプロイ中にブロックされます。
• ユーザーデータ関数アクションから 512 KB を超えるデータを返すことはできません。 大きな出力は切り捨てられます。 それでも行動は成功します。
• アクションがデータを供給しているサービスの処理が追いつくまで、そのアクションを待たせることはできません。 アクション自体が終了したときにアクションが完了するため、生成されたデータがクエリ可能になる前に次のアクションが開始されます。
• デプロイメントプランを使って 、デプロイメント中に変数ライブラリ のアクティブ値セットを変更することはできません。 変数参照は、ターゲットワークスペースですでに有効になっている値セットを基準に解決されます。 新しく作成されたターゲットワークスペースでは、別の値セットを選択して保存するまで デフォルトが 有効です。 詳細は 変数ライブラリCI/CDを参照してください。

計画作成の制限

• 展開グループに複数のアイテムを追加することはできません。
• キャンバスは自動レイアウトのみをサポートしています。

展開計画のサイズ制限

これらの制限のいずれかを超えるプランは、保存された際に却下されます。 この制限は計画が保存されるたびに適用されるため、キャンバス、REST API、Gitからのプル、外部ツールのすべてに適用されます。

関連するコンテンツ

• 展開計画を作成する
• 展開計画の例
• Microsoft FabricにおけるCI/CDの紹介
• Git 統合の概要
• デプロイ パイプラインの概要
• Fabric CI/CDワークフローを選択してください
• クロスワークスペース展開における依存関係バインディングの理解