Data Transformer 関数

このページでは、Application Integration で使用できる Data Transformer Script タスク用に事前定義された追加の Jsonnet 関数について説明します。

次の事前定義された関数を使用するには、スクリプトに functions ライブラリをインポートする必要があります。functions ライブラリをインポートすると、標準の Jsonnet 関数と事前定義された Data Transformer 関数の両方を使用できます。

Jsonnet 標準関数の詳細については、Jsonnet 標準ライブラリをご覧ください。

配列関数

Average

構文 

avg(arr)
説明 配列内のすべての値の平均値を計算します。
入力パラメータ arr: 入力配列。
戻り値の型 DOUBLE
出力 配列内のすべての値の平均値を返します。

Contains

構文 

contains(arr, elem)
説明 指定した要素の配列内での出現数を確認します。
入力パラメータ arr: 入力配列。

elem: 検索する配列要素。
戻り値の型 BOOLEAN
出力 一致が見つかった場合は TRUE を返し、見つからなかった場合は FALSE を返します。

Max Array

構文 

maxArray(arr)
説明 配列の最大値を見つけます。
入力パラメータ arr: 入力配列。
戻り値の型 入力配列のデータ型。
出力 配列の最大値を返します。

Min Array

構文 

minArray(arr)
説明 配列内の最小値を見つけます。
入力パラメータ arr: 入力配列。
戻り値の型 入力配列のデータ型。
出力/> 配列の最小値を返します。

Remove

構文 

remove(arr, elem)
説明 指定された要素を配列から削除します。
入力パラメータ arr: 入力配列。

elem: 削除する配列要素。
戻り値の型 入力配列のデータ型。
出力 指定された要素を削除した後、更新された配列を返します。

Remove At

構文 

removeAt(arr, index)
説明 配列の指定されたインデックスにある要素を削除します。
入力パラメータ arr: 入力配列。

index: 削除する要素の配列インデックス。
戻り値の型 入力配列のデータ型。
出力 指定された要素を削除した後、更新された配列を返します。

Sum

構文 

sum(arr)
説明 配列内のすべての値を合計します。
入力パラメータ arr: 入力配列。
戻り値の型 入力配列のデータ型。
出力 配列内のすべての要素の合計を返します。

集計関数

XNOR

構文 

xnor(a, b)
説明 指定されたブール値の論理 XNOR 演算を行います。
入力パラメータ a: ブール値。

b: ブール値。
戻り値の型 BOOLEAN
出力 指定された 2 つのブール値の XNOR を返します。

Xor

構文 

xor(a, b)
説明 指定されたブール値の論理 XOR 演算を行います。
入力パラメータ a: ブール値。

b: ブール値。
戻り値の型 BOOLEAN
出力 指定された 2 つのブール値の XOR を返します。

ハッシュ関数

SHA1

構文 

sha1(str)
説明 Secure Hash Algorithm 1（SHA-1）アルゴリズムを使用して、入力 STRING の暗号ハッシュを計算します。
入力パラメータ str: 入力文字列。
戻り値の型 BYTES
出力 160 ビット（20 バイト）のハッシュ値を返します。

SHA256

構文 

sha256(str)
説明 Secure Hash Algorithm 256（SHA-256）アルゴリズムを使用して、入力 STRING の暗号ハッシュを計算します。
入力パラメータ str: 入力文字列。
戻り値の型 BYTES
出力 256 ビット（32 バイト）のハッシュ値を返します。

SHA512

構文 

sha512(str)
説明 Secure Hash Algorithm 512（SHA-512）アルゴリズムを使用して、入力 STRING の暗号ハッシュを計算します。
入力パラメータ str: 入力文字列。
戻り値の型 BYTES
出力 512 ビット（64 バイト）のハッシュ値を返します。

SHA3

構文 

sha3(str)
説明 Secure Hash Algorithm 3（SHA-3）アルゴリズムを使用して、入力 STRING の暗号ハッシュを計算します。
入力パラメータ str: 入力文字列。
戻り値の型 BYTES
出力 512 ビット（64 バイト）のハッシュ値を返します。

JSON 関数

Object Remove Key

構文 

objectRemoveKey(obj, key)
説明 JSON オブジェクトからプロパティを削除します。
入力パラメータ obj: 入力 JSON オブジェクト。

key: 削除する JSON プロパティ。
戻り値の型 JSON
出力 指定されたプロパティとその対応する値を削除した後に更新された JSON オブジェクト。

数学関数

Is Decimal

構文 

isDecimal(num)
説明 指定された数値が小数かどうかを確認します。
入力パラメータ num: 入力数値。
戻り値の型 BOOLEAN
出力 数値が小数の場合は TRUE、それ以外の場合は FALSE を返します。

Is Even

構文 

isEven(num)
説明 指定された数値が偶数かどうかを確認します。
入力パラメータ num: 入力数値。
戻り値の型 BOOLEAN
出力 数値が偶数の場合は TRUE、それ以外の場合は FALSE を返します。

Is Integer

構文 

isInteger(num)
説明 指定された数値が整数かどうかを確認します。
入力パラメータ num: 入力数値。
戻り値の型 BOOLEAN
出力 数値が整数の場合は TRUE、それ以外の場合は FALSE を返します。

Is Odd

構文 

isOdd(num)
説明 指定された数値が奇数かどうかを確認します。
入力パラメータ num: 入力数値。
戻り値の型 BOOLEAN
出力 数値が奇数の場合は TRUE、それ以外の場合は FALSE を返します。

Random Number

構文 

randomNumber(lowerBound, upperBound)
説明 指定した範囲の間のランダムな実数を生成します。
入力パラメータ lowerBound: 下限値（この値を含む）。デフォルト値は 0 です。

upperBound: 上限値（この値を含まない）。デフォルト値は 1 です。
戻り値の型 実数。
出力 lowerBound と upperBound の間のランダムな実数を返します。

Round

構文 

round(input)
説明 数値を最も近い整数に四捨五入します。
入力パラメータ 入力: 四捨五入する値。
戻り値の型 INTEGER
戻り値 最も近い四捨五入された整数を返します。

文字列関数

Equals Ignore Case

構文 

equalsIgnoreCase(str1, str2)
説明 文字列の大文字と小文字を区別せずに、指定された 2 つの文字列値を比較します。
入力パラメータ str1: 入力文字列。

str2: 入力文字列。
戻り値の型 BOOLEAN
出力 指定された値が既存の値と一致する（大文字と小文字は区別しません）場合は TRUE、一致しない場合は FALSE を返します。

Is Empty

構文 

isEmpty(str)
説明 指定された文字列の長さが 0 であるかどうかを確認します。
入力パラメータ str: 入力文字列。
戻り値の型 BOOLEAN
出力 文字列が空の場合は TRUE、それ以外の場合は FALSE を返します。

Match

構文 

match(str, regexp)
説明 文字列と正規表現を照合した結果を取得します。
入力パラメータ str: 入力文字列。

regexp: re2 正規表現。
戻り値の型 ARRAY
出力 正規表現 regexp と一致する str のすべての部分文字列の配列を返します。一致がない場合は、空の配列を返します。

Trim

構文 

trim(str)
説明 指定した文字列の先頭と末尾のスペースをすべて削除します。
入力パラメータ str: 入力文字列。
戻り値の型 STRING
出力 先頭と末尾の空白文字を削除して、文字列のコピーを返します。

タイムスタンプ関数

Date Format

構文 

dateFormat(timestamp, format_string, timezone, current_format)
説明 タイムスタンプを指定された format_string に従ってフォーマットします。
入力パラメータ timestamp: 入力タイムスタンプ。

format_string: 新しいタイムスタンプ形式。新しいタイムスタンプ形式文字列の作成に使用できる形式設定要素のリストについては、サポートされているタイムスタンプ形式設定要素をご覧ください。

timezone: 指定された入力タイムスタンプのタイムゾーン。デフォルト値は UTC です。

current_format: 指定された入力タイムスタンプの解析に使用される形式。デフォルト値は E（エポック）です。
戻り値の型 STRING
出力 指定された format_string に基づいて入力 timestamp を変換した後、新しい文字列を返します。

サポートされているタイムスタンプ形式設定要素

次の表に、dateFormat() 関数でサポートされる形式設定要素を示します。

形式設定要素 説明 例
YYYY 4 桁の年。 2023
YY 年の最後の 2 桁。 23
MMMM タイトルケースの月の名前。 March
MMM タイトルケースの月の名前の略称。 Mar
MM 01 ～ 12 の月。 03
M 1 ～ 12 の月。 3
DDDD タイトルケースの曜日。 Monday
DDD 曜日の略称。 Mon
DD 01 ～ 31 日。 06
D 1 ～ 31 の日。 6
HH 24 時間形式の時刻（00 ～ 23）。 15
hh 12 時間形式の時刻（01 ～ 12）。 03
h 12 時間形式の時刻（1 ～ 12）。 3
mm 分（00 ～ 59）。 04
m 分（0 ～ 59）。 4
ss 秒（00 〜 59）。 08
s 秒（0 ～ 59）。 8
FFFFFFFFF ゼロを含む、指定された桁の右側に 9 桁の小数秒。 00.123456789
FFFFFFFF ゼロを含む、指定された桁の右側に 8 桁の少数秒。 00.12345678
FFFFFFF ゼロを含む、指定された桁の右側に 7 桁の小数秒。 00.1234567
FFFFFF ゼロを含む、指定された桁の右側に 6 桁の小数秒。 00.123456
FFFFF ゼロを含む、指定された桁の右側に 5 桁の小数秒。 00.12345
FFFF ゼロを含む、指定された桁の右側に 4 桁の小数秒。 00.1234
FFF ゼロを含む、指定された桁の右側に 3 桁の小数秒。 00.123
FF ゼロを含む、指定された桁の右側に 2 桁の小数秒。 00.12
F ゼロを含む、指定された桁の右側に 1 桁の小数秒。 00.1
fffffffff 9 桁の小数秒。 987654321
ffffffff 8 桁の小数秒。 98765432
fffffff 7 桁の小数秒。 9876543
ffffff 6 桁の小数秒。 987654
fffff 5 桁の小数秒。 98765
ffff 4 桁の小数秒。 9876
fff 3 桁の小数秒。 987
ff 2 桁の小数秒。 98
f 1 桁の小数秒。 9
tt 正午インジケーター（朝または夕）。フォーマット時は AM または PM。 PM
t 短縮正午インジケーター（朝たは夕）。フォーマット時は、A または P。 P
K タイムゾーン名。 PST
kk ±xx:xx のタイムゾーン形式。 -8:00:00
k ±xxxx 形式のタイムゾーン形式。 -8000

Is Leap Year

構文 

isLeapYear(year)
説明 指定された年がうるう年かどうかを確認します。
入力パラメータ year: 入力年（実数）。
戻り値の型 BOOLEAN
出力 年がうるう年の場合は TRUE、それ以外の場合は FALSE を返します。

Now In Millis

構文 

nowInMillis()
説明 統合の現在の Unix エポック時間をミリ秒単位で返します。
入力パラメータ なし
戻り値の型 INT64
出力 現在の Unix エポック時間をミリ秒単位で返します。

ユーティリティ関数

UUID

構文 

uuid()
説明 ランダムな Universally Unique Identifier（UUID）を STRING として返します。返される STRING は 32 個の 16 進数で構成され、5 つのグループがハイフンで区切られた 8-4-4-4-12 形式になります。この 16 進数は RFC 4122 セクション 4.4 に準拠し、122 個のランダムなビットと 6 個の固定ビットを表します。返される STRING はすべて小文字です。
入力パラメータ なし
戻り値の型 STRING
出力 生成された UUID を文字列形式で返します。

推奨事項