Extensibility ツールキットには、データ アプリケーションを可能な限りシンプルにファブリックに導入するように設計された一連の機能が導入されています。 これらの機能を使用すると、開発者は最小限の労力で豊富で統合されたエクスペリエンスを構築できます。 Extensibility Toolkit を使用すると、フロントエンドから直接 Fabric API に簡単にアクセスしたり、Fabric 内で項目定義 (状態) を保持したり、標準化された項目作成フローを使用したり、iFrame の緩和とパブリック API のサポートを通じてセキュリティと相互運用性の向上を利用したりできます。 さらに、組み込みの CI/CD サポートを使用して開発ライフサイクルを合理化し、デプロイとテストの自動化を容易にします。 次のセクションでは、主要な機能の概要と、それらをワークロードに組み込む方法に関するガイダンスを示します。
標準アイテム作成エクスペリエンス
項目の作成は、プロセスをユーザーにガイドする専用の Fabric コントロールによって標準化されます。 このコントロールを使用すると、ユーザーはアイテムが作成されるワークスペースを選択し、秘密度ラベルを割り当て、その他の関連する設定を構成できます。 この標準化されたエクスペリエンスを使用することで、アイテム作成の複雑さを自分で処理したり、プロセスの将来の変更について心配したりする必要がなくなります。 さらに、このアプローチにより、アイテムの作成をワークロード ページ内に直接表示できるため、シームレスで統合されたユーザー エクスペリエンスが提供されます。
項目の 作成方法に関するガイドを 使用して、その実装方法を理解します。
フロントエンド API のサポート
Extensibility Toolkit を使用すると、フロントエンド アプリケーション内で直接 Microsoft Entra On-Behalf-Of (OBO) トークンを取得できるため、Entra で保護された API に安全にアクセスできます。 この機能を使用すると、Microsoft Fabric サービスと深く統合できます。たとえば、OneLake でデータを読み取って格納したり、他の Fabric 項目を作成して操作したり、Livey API を介して Spark を処理エンジンとして使用したりできます。 詳細については、 Microsoft Entra のドキュメント、 OneLake のドキュメント、 Fabric REST API、および Fabric の Spark を参照してください。
Microsoft Entra Token の入手方法ガイドを使用して、実装方法を理解します。 また、「 Fabric API にアクセスする方法」ガイド を使用して、Fabric と対話する方法を理解します。
Fabric での項目定義 (状態) の格納
この機能を使用すると、アイテムのメタデータ (アイテムの構成など)、その他の関連情報を、エンド ユーザーに表示されない非表示フォルダー内の OneLake に直接格納できます。 データは、パブリック API と CI/CD プロセスによって適用されるのと同じ形式を使用して格納されるため、異なる統合ポイント間の一貫性と相互運用性が確保されます。 パブリック API と CI/CD での形式とその使用方法の詳細については、次のセクションで説明します。
アイテム定義を格納する方法を使用して、その実装方法を理解します。
定義に格納する内容
状態は、アイテムが削除または他の場所にコピーされた場合に、復元に必要なすべての情報を保持するものとして考えてください。 これには、OneLake に格納されるデータ自体は含まれません ( OneLake での項目データの格納を参照)。
実用的な例を次に示します。
- ノートブック項目: 状態には、ノートブックのコード、セルの順序、および使用する実行エンジン (Spark、SQL など) などのメタデータが格納されます。 ノートブックによって処理された実データは、状態に格納されません。
- ファイル エディター項目: 状態にはファイルの内容自体は格納されず、代わりにエディター構成 (配色、オートコンプリート設定、フォント サイズ、その他のユーザー設定など) が格納されます。
- インストーラーまたはオーケストレーター項目: アイテムが他のコンポーネント (データベースやコンピューティング リソースなど) をインストールまたはプロビジョニングする場合、状態には、作成した項目への参照 (ID、URI) が保持されている必要があります。 これにより、ワークロードで状態を確認したり、後で管理したりできます。
構成、メタデータ、および参照に重点を置くことで、アイテムの状態が移植可能で軽量で、復元や移行が簡単であることを確認できます。
OneLake に項目データを格納する
すべてのアイテムには、開発者が構造化データと非構造化データを格納できる独自の Onelake 項目フォルダーが付属しています。 Lakehouse と同様に、アイテムには、Delta または Iceberg 形式でデータを格納できる Table フォルダーと、非構造化データを格納できる Files フォルダーがあります。
Item にデータを格納する方法を使用して、実装方法を理解します。
ショートカット データ
すべてのアイテムが持つ独自の Onelake フォルダーと同様に、ショートカットを操作することもできます。 Public Shortcut API ワークロード開発者は、OneLake の単一コピー機能へとアイテムを組み込むために、アイテムからまたはアイテム内でさまざまなショートカットの種類を作成できます。
ショートカットを作成する方法を使用して、その実装方法を理解します。
CRUD 項目 API のサポート
ユーザーは、標準 の Fabric Item Rest API を使用して、コンテンツを含むアイテムを作成、更新、および削除できます。 この自動有効化により、コア Fabric 項目と同じ方法でワークロード項目との統合がはるかに簡単になり、相互運用性が合理化され、堅牢な統合を構築するために必要な労力が削減されます。
CI/CD のサポート
注
Extensibility Toolkit の CI/CD サポートは現在開発中です。 以下で説明する機能は計画された機能であり、リリース前に変更される可能性があります。
すべての項目に対する CI/CD のサポートは、お客様からの最も高い質問の 1 つです。 この機能を使用すると、すべての項目がすぐに CICD に参加し、特定のロジックや操作を実装する必要はありません。 つまり、標準の Azure Pipelines とツールを使用して、ワークロードのデプロイ、テスト、更新を自動化できます。 項目の形式と API は、CI/CD プロセスと完全に互換性を持つよう設計されており、環境全体で一貫した信頼性の高いエクスペリエンスを確保します。 CI/CD との統合の詳細については、 Fabric CICD のドキュメントを参照してください。
アイテム CRUD 通知 API
注
Extensibility Toolkit の CRUD 通知 API のサポートは現在開発中です。 以下で説明する機能は計画された機能であり、リリース前に変更される可能性があります。
ワークロードが Item CRUD イベントに参加する必要がある場合があります。 項目は UX を介してプラットフォーム上に直接作成されるため、パブリック API または CI/CD ワークロード所有者は、それらのエントリポイントに対して新しい項目がいつ作成されるかを制御できません。 既定では、 アイテムは状態 を Fabric に格納するため、アイテムの変更について通知を受ける必要はありません。 ただし、ワークロードが CRUD フローに参加する必要がある場合もあります。 これは主に、項目のインフラストラクチャをプロビジョニングまたは構成する必要がある場合です (データベースなど)。 これらのシナリオでは、パートナーは、Fabric がすべてのイベントで呼び出す Crud 通知 API を実装できます。 このシナリオでは、ワークロード開発者はAPIが到達可能であることを確認しなければ、ファブリック操作が失敗することになります。
ファブリック スケジューラ
注
Extensibility Toolkit のファブリック スケジューラのサポートは現在開発中です。 以下で説明する機能は計画された機能であり、リリース前に変更される可能性があります。
Fabric では、ワークロードのジョブ スケジューリングがサポートされています。 この機能を使用すると、開発者は、ユーザーが UX の前にいなくても通知を受け取り、実行する必要があるジョブに基づいて動作するワークロードを構築できます (たとえば、Onelake のデータをコピーします)。 パートナーは、API を実装し、この機能に参加するようにワークロードを構成する必要があります。
iFrame のリラクゼーション
開発者は、より多くの iFrame 属性を要求して、ファイルのダウンロードや外部 Web サイトの開きなどの高度なシナリオを可能にすることができます。 この機能を使用すると、ワークロードは、ダウンロードの開始や、現在の Fabric 資格情報を使用した外部 API へのユーザーの接続など、より広範なブラウザー機能を必要とするアクションを実行する前に、明示的な同意をユーザーに求めることができます。 ワークロード構成でこれらの要件を指定することで、ユーザーに通知され、必要なアクセス許可を付与できることを確認できます。これにより、セキュリティとユーザーの信頼を維持しながら、外部システムとのシームレスな統合が可能になります。
iFrame をリラックスさせる方法を使用して、実装方法を理解します。
注
この機能を有効にするには、ユーザーが、基本的なワークロード機能に必要な標準の Fabric スコープを超えて、緩和スコープに対してより多くの Microsoft Entra 同意を付与する必要があります。
機能の制限事項
プライベート リンク
Private Link がテナントレベルまたはワークスペース レベルで有効になっている場合、すべてのワークロードは消費と開発のためにブロックされます。