メインコンテンツへスキップ

[AVANT Cruise] Freighterオプションで提供されるパイプラインを即時実行するにはどうしたらよいでしょうか。

AVANT Cruise の Freighterオプションで提供されるデータ連携を行うためのパイプラインを、スケジュール実行ではなく即時実行するには、どのようにしたらよいでしょうか。

回答

AVANT Cruise Freighterオプションでは、パイプラインを即時実行するためのサンプルスクリプトを提供しています。このサンプルスクリプトを利用することで、手動実行やお客様管理のジョブコントローラーから実行することができます。

サンプルスクリプトを利用するための事前準備

    1. 製品出荷時に提供される以下情報をご用意ください。
        • AVANT Cruise 設定シート／データレイク情報
          • テナントID
          • サービスプリンシパル アプリケーションID
          • サービスプリンシパル シークレット
        • AVANT Cruise Freighterオプション設定シート
          • リソースグループ名
          • DataFactory名
          • パイプライン名
    2. 提供するサンプルスクリプトは、Windows OS上のPowerShellを利用して実行されます。また、実行にはAzure PowerShellが必要です。以下のURLを参照し、インストールください。 

サンプルスクリプトの概要

このスクリプトでは、パイプラインを起動し、処理が完了するまで待機します。

【サンプルバッチファイル構成】

　Script-FreighterScripts.zip
　├PipelineGoSpl.bat
　└PipelineGoSpl.ps1

【利用手順】

    1. Script-FreighterScripts.zip を任意のフォルダで展開する。
    2. PipelineGoSpl.bat をメモ帳などのテキストエディタで開く。
    3. PipelineGoSpl.bat 中の以下の変数を設定する。
        • prmTenantId ：テナントID
        • prmSvPv ：サービスプリンシパル アプリケーションID
        • prmSvSc ：サービスプリンシパル シークレット
        • prmRGName ：リソースグループ名
        • prmDFName ：DataFactory名
        • prmPlName ：パイプライン名
    4. PipelineGoSpl.batを保存する。
    5. コマンドプロンプトを起動し、PipelineGoSpl.batを実行する。

【実行結果】

PipelineGoSpl.bat を実行し、パイプライン実行中は定期的に「InProgress」と表示されます。パイプライン処理完了時には「Succeed」と表示されスクリプトが終了します。

PipelineGoSpl.bat が正常終了した場合には、リターンコード 0を返します。パイプライン処理が失敗した場合、および キャンセルされた場合には例外が発行され リターンコードは 0 以外の例外条件に応じたコードが返されます。

関連記事