次の方法で共有

Fabric API を使用した展開パイプラインの自動化

  • [アーティクル]

Microsoft Fabric の展開パイプライン ツールを使うと、チームは、Fabric コンテンツのための効率的で再利用可能なリリース プロセスを構築できます。

重要

この機能はプレビュー中です。

展開パイプラインの Fabric REST API を使用して、Fabric を組織の自動化プロセスに統合します。 API を使用して実行できることの例をいくつか次に示します。

  • Azure DevOps や GitHub Actions などの使い慣れた DevOps ツールに、Fabric を統合します。

  • 特定の日時にパイプラインによるデプロイが自動的に実行されるようにスケジュールします。

  • 複数のパイプラインを同時にデプロイします。

  • パイプラインのデプロイに応じてカスケードします。 パイプライン間で接続されているコンテンツがある場合、一部のパイプラインが他より先にデプロイされるようにできます。

前提条件

展開パイプライン API を使用するには、次の前提条件が必要です。

  • 展開パイプラインを使用する必要がある同じ前提条件。
  • Fabric サービス用の Microsoft Entra トークン。 API 呼び出しの承認ヘッダーでそのトークンを使用します。 トークンを取得する方法については、「Fabric API のクイック スタート」を参照してください。

PowerShell なしで REST API を使用できますが、この記事のScriptでは PowerShell を使用します。 スクリプトを実行するには、次のプログラムをインストールする必要があります。

デプロイ パイプラインの API 関数

デプロイ パイプラインの Fabric REST API では、次の機能を実行できます。

他の Fabric REST API 呼び出しを使用して、関連する操作を完了することもできます。

PowerShell の例

以下の PowerShell スクリプトを使って、いくつかの自動化プロセスを実行する方法を理解できます。 PowerShell サンプルのテキストを表示またはコピーするには、このセクションのリンクを使用します。

  • すべてデプロイ

    次の情報を指定します。

    • パイプライン名
    • ソース ステージ名
    • ターゲット ステージ名
    • デプロイに関する注意事項 (省略可能)

  • 選択的デプロイ

    次の情報を指定します。

    • パイプライン名
    • ソース ステージ名
    • ターゲット ステージ名
    • 展開する項目 (項目の表示名と項目の種類)
    • デプロイに関する注意事項 (省略可能)

考慮事項と制限事項

展開パイプライン API を使用する場合は、次の制限事項を考慮してください。

  • 展開パイプラインに適用されるすべての制限事項は、API を使用する場合に適用されます。 詳細については、「展開パイプラインのベスト プラクティス」を参照してください。

  • データフローは現在サポートされていません。 データフローを使用しているお客様は、Power BI API を使用できます。

  • サービス プリンシパルは、Power BI 項目でのみサポートされます。

  • Power BI API で使用できるデプロイ オプションすべてが Fabric で使用できるわけではありません。 次の API は、Fabric のデプロイ ステージ コンテンツ API では使用できません。

    • allowPurgeData
    • allowTakeOver
    • allowSkipTilesWithMissingPrerequisites

    これらの API のいずれかが必要な場合は、Power BI API を使用してデプロイします。 ただし、これらの API は Power BI 項目でのみ機能します。

関連するコンテンツ