プレビュー — Data Transformer Script task

この機能には、サービス固有の利用規約の「一般的なサービス規約」の「pre-GA サービス規約」が適用されます。 pre-GA の機能は「現状有姿」で利用できますが、サポートが制限される場合があります。 詳しくは、リリース ステージの説明をご覧ください。

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. 統合のリージョンを選択します。
      注: [リージョン] プルダウンには、Google Cloud プロジェクトにプロビジョニングされたリージョンのみが表示されます。新しいリージョンをプロビジョニングするには、[リージョンを有効にする] をクリックします。詳細については、新しいリージョンを有効にするをご覧ください。
   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 エディタでは、デフォルトで、Application Integration でのデータ マッピングに使用する Jsonnet 関数のセットを含む事前定義されたカスタム ライブラリ functions がインポートされます。使用可能なカスタム関数の詳細については、Data Transformer 関数をご覧ください。

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

統合変数にアクセスする

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

注意: Jsonnet では、識別子名の一部にハイフン（-）を使用できません。たとえば、変数名や関数名が考えられます。変数名の一部としてハイフン（-）を使用する場合は、次の例に示すように、変数を二重引用符で囲む必要があります。

例: 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 関数（プレビュー）を見る