Data Transformer Script タスク

Data Transformer Script タスクを使用すると、カスタム Jsonnet テンプレートを作成、編集、評価して、統合でデータ マッピングを実行できます。

Application Integration のデータ マッピングの詳細については、データ マッピングの概要をご覧ください。

Data Transformer Script タスクを構成する

Data Transformer Script タスクを統合に追加する手順は次のとおりです。

  1. Google Cloud コンソールで [Application Integration] ページに移動します。

    Application Integration に移動

  2. ナビゲーション メニューで [統合] をクリックします。

    [統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。

  3. 既存の統合を選択するか、[統合の作成] をクリックして新しい統合を作成します。

    新しい統合を作成する場合:

    1. [統合の作成] ペインで名前と説明を入力します。
    2. 統合のリージョンを選択します。
    3. 統合用のサービス アカウントを選択します。統合のサービス アカウントの詳細は、統合ツールバーの [統合の概要] ペインでいつでも変更または更新できます。
    4. [作成] をクリックします。

    統合エディタで統合が開きます。

  4. 統合エディタのナビゲーション バーで、[タスク] をクリックして、使用可能なタスクとコネクタのリストを表示します。
  5. [Data Transformer Script] 要素をクリックして、統合エディタに配置します。
  6. デザイナーの [Data Transformer Script] 要素をクリックして、[Data Transformer Script] タスク構成ペインを表示します。
  7. [Open Data Transformer Script editor] をクリックします。
  8. Data Transformer Script エディタが開き、コメント付きのデフォルトの Jsonnet テンプレート サンプルが表示されます。
  9. Jsonnet コードを記述し、完了したらエディタを閉じます。変更は自動的に保存されます。

Data Transformer Script エディタの使用

Data Transformer Script エディタを使用して、統合変数にアクセスし、変数の割り当てを実行して、統合で変数を追加または変更できます。Data Transformer Script エディタには、スクリプト エクスペリエンスを向上させる次の機能が用意されています。

  • コードを読みやすくし、構造を認識しやすくするための構文/コードのハイライト表示、インデント、行番号付け。
  • スクリプト コードの概要が表示され、簡単なナビゲーションに役立つミニマップ。
  • クリックしてコピーするオプション。スクリプト コードをクリップボードにコピーします。

エディタを開くには、[Data Transformer Script] タスク構成ペインに移動して、[Open Data Transformer Script Editor] をクリックします。

Data Transformer Script エディタは、デフォルトで functions をインポートします。これは、Application Integration のデータ マッピング用の Jsonnet 関数のセットを含む事前定義のカスタム ライブラリです。使用可能なカスタム関数の詳細については、Data Transformer 関数をご覧ください。

次の図は、Data Transformer Script エディタのサンプル レイアウトを示しています。

Data Transformer Script エディタを示す画像 Data Transformer Script エディタを示す画像

統合変数にアクセスする

Data Transformer Script エディタから既存の統合変数を読み取るには、事前定義された functions ライブラリの extVar 関数を使用します。

例: Data Transformer Script エディタを使用して既存の統合変数の読み取りと更新を行う

Jsonnet スクリプト

local f = import "functions"; // Import predefined Data Transformer function library

local str1 = f.extVar("inputVar1"); // Access integration input variable "Inputstr1" with value "Hello"
local str2 = f.extVar("inputVar2"); // Access integration input variable "Inputstr2" with value "World"
{
  OutputVar: str1 + " " + str2 + "!", // Write to Jsonnet output variable "OutputVar"
  "output-str-var": str1 + " Integration " + str2 + "!", // Write to Jsonnet output variable "output-str-var"
}

出力

Data Transformer Script の例を示す画像 Data Transformer Script の例を示す画像

Jsonnet の使用方法のリファレンス

Jsonnet は純粋な関数型言語であり、プログラムは式で構成されます。これらの式の作成方法については、Jsonnet 式をご覧ください。

割り当てと上限

Data Transformer Script タスクに適用される使用量上限については、使用量上限をご覧ください。

次のステップ