バイナリ関数 ​

Binaryは、生バイト用のWEL型です。ファイルコンテンツを処理する場合、暗号化関数がダイジェストを返す場合、システムがJSONフィールド内でbase64エンコードされたデータを送信する場合に表示されます。

バイナリ関数は、バイトをJSONで安全なテキスト表現に変換します。また、生バイトを測定およびスライスします。

Base64 ​

Base64は、生バイトをJSONフィールドまたはURLに埋め込むための標準的な方法です。

encode_base64 ​

バイトをbase64文字列としてエンコードします。

encode_base64(binary, mode)

encode_base64(Binary('ABC'))

QUJD

decode_base64 ​

base64文字列をバイトにデコードします。パディングが欠落していても許容します。

decode_base64(text, mode)

decode_base64('QUJD')

0x"414243"

16進数 ​

Hexは各バイトを2文字で表し、サイズと引き換えに人間が読みやすくします。

encode_hex_string ​

バイトを、1バイトあたり2文字の16進数文字列に変換します。

Hexはbase64より多くの領域を必要としますが、人間が読みやすい表現を提供します。チェックサムとダイジェストでは、一般的にこの形式が使用されます。

encode_hex_string(binary, mode)

encode_hex_string(Binary('ABC'))

414243

decode_hex_string ​

16進数文字列をバイトに変換します。モードが'strict'でない限り、先頭の0xまたは末尾のhを取り除きます。

decode_hex_string(text, mode)

decode_hex_string('414243')

0x"414243"

Quoted-printable ​

Quoted-printableは、メール本文などの主にASCIIテキスト向けのMIMEエンコーディングです。

encode_quoted_printable ​

RFC 2045で定義されているMIME quoted-printableとして、76列のソフト改行を使用してバイトをエンコードします。

メール本文では、コンテンツの大部分がASCIIで、コンパクトさよりも読みやすさが重要な場合にquoted-printableを使用します。

encode_quoted_printable(binary)

encode_quoted_printable(Binary('a=b'))

a=3Db

decode_quoted_printable ​

MIME quoted-printableテキストをバイトにデコードします。

decode_quoted_printable(text)

decode_quoted_printable('a=3Db')

0x"613D62"

測定とスライス ​

次の関数は、テキストとして解釈せずに、生バイト範囲を直接測定および抽出します:

byte_length ​

バイト数を返します。

byte_lengthは文字数ではなく、バイト数を返します。 lengthはテキスト内のコードポイントをカウントし、grapheme_lengthは代わりにユーザーが認識する文字（書記素クラスタ）をカウントします。 ASCII以外では、この3つが異なる場合があります。

byte_length(binary)

byte_length(Binary('ABC'))

3

byte_slice ​

オフセットと長さに基づいて、連続したバイトを抽出します。

byte_slice(binary, offset, length)

byte_slice(Binary('ABCDEF'), 1, 3)

0x"424344"

ユースケース: ファイルを添付してチェックサムを記録 ​

宛先は、JSONフィールド内のbase64エンコードされたファイルコンテンツと、16進数形式のSHA-256チェックサムを想定しています。バイナリ関数を使用してファイルをエンコードし、チェックサムを計算します:

入力

{
  "filename": "note.txt",
  "content": "ABC"
}

Formula

let bytes = Binary(_.content)
do {
  filename: _.filename,
  size_bytes: byte_length(bytes),
  content_base64: encode_base64(bytes),
  sha256: hex_sha256(bytes)
}

出力

{
  "filename": "note.txt",
  "size_bytes": 3,
  "content_base64": "QUJD",
  "sha256": "b5d4045c3f466fa91fe2cc6abe79232a1a57cdf104f7a26e716e0a1e2789df78"
}

let … doはコンテンツを一度だけバイトに変換し、3つの派生フィールドはすべて同じ値を読み取ります。

関連情報 ​

• エンコーディング関数: 名前付き文字エンコーディングを使用してバイトをテキストに変換します。
• 暗号化関数: Binaryを返すダイジェストとHMAC値を生成します。
• ランダム関数: ソルト用にrandom_bytesを生成します。
• データ型: Binary型の詳細情報。