このトピックでは、バイナリ関数の構文について説明します。 このトピックでは、関数の使用方法の例も示します。

次の表に、Log Serviceでサポートされているバイナリ関数を示します。

重要
  • 分析ステートメントで文字列を使用する場合は、文字列を単一引用符 ('') で囲む必要があります。 二重引用符 (") で囲まれていない、または囲まれている文字列は、フィールド名または列名を示します。 例えば、 'status' はステータスの文字列を示し、status または "status" はステータスログフィールドを示します。
  • varbinaryはバイナリ文字型で、varcharは可変長文字型です。
機能構文説明
from_base64関数from_base64(x) Base64-encoded文字列を2進数に変換します。
from_base64url関数from_base64url(x) URL予約文字を使用して、Base64-encoded文字列をバイナリ番号に変換します。
from_big_endian_64関数from_big_endian_64(x) ビッグエンディアンモードのバイナリ数値をbigint値に変換します。
from_hex関数from_hex(x) 16進数を2進数に変換します。
長さ関数長さ (x) 2進数の長さを計算します。
md5関数md5(x) 2進数のMD5ハッシュ値を計算します。
to_base64関数to_base64(x) バイナリ数値をBase64-encoded文字列に変換します。
to_base64url関数to_base64url(x) URL予約文字を使用して、バイナリ番号をBase64-encoded文字列に変換します。
to_hex関数to_hex(x) 2進数を16進数に変換します。
to_big_endian_64関数to_big_endian_64(x) bigint値をビッグエンディアンモードで2進数に変換します。
sha1関数sha1(x) 2進数のSHA-1ハッシュ値を計算します。
sha256関数sha256(x) バイナリ数のSHA-256ハッシュ値を計算します。
sha512関数sha512(x) バイナリ数のSHA-512ハッシュ値を計算します。
xxhash64関数xxhash64(x) 2進数のxxhash64ハッシュ値を計算します。

from_base64関数

from_base64関数は、Base64エンコードされた文字列を2進数に変換するために使用します。

構文

from_base64(x)

パラメーター

パラメーター説明
xこのパラメーターの値はバイナリ型です。

戻り値のデータ型

varbinary型。

重要 varbinary型の戻り値には非表示の文字が含まれ、Base64-encoded形式で表示されます。
  • 返されたバイナリ数値が非表示文字の場合は、to_hex関数を使用して数値を16進数に変換できます。
  • 返された2進数が可視文字の場合は、from_utf8関数を使用して数値をUTF-8文字列に変換できます。

例

Base64エンコードされた文字列を2進数に変換し、さらに2進数を16進数に変換します。

  • クエリ文
    * | SELECT to_hex(from_base64('c2xz'))
  • クエリと分析結果from_base64

from_base64url関数

from_base64url関数は、URL予約文字を使用してBase64-encoded文字列をバイナリ数に変換するために使用されます。

構文

from_base64url(x)

パラメーター

パラメーター説明
xこのパラメーターの値はバイナリ型です。

戻り値のデータ型

varbinary型。
重要 varbinary型の戻り値には非表示の文字が含まれ、Base64-encoded形式で表示されます。
  • 返されたバイナリ数値が非表示文字の場合は、to_hex関数を使用して数値を16進数に変換できます。
  • 返された2進数が可視文字の場合は、from_utf8関数を使用して数値をUTF-8文字列に変換できます。

例

URL予約文字を使用して、Base64-encoded文字列をバイナリ数に変換します。

  • クエリ文
    * | SELECT to_hex(from_base64url('c2xz'))
  • クエリと分析結果from_base64

from_big_endian_64関数

from_big_endian_64関数は、ビッグエンディアンモードの2進数をbigint値に変換するために使用されます。

構文

from_big_endian_64(x)

パラメーター

パラメーター説明
xこのパラメーターの値はバイナリ型です。

戻り値のデータ型

bigint型。

例

ビッグエンディアンモードのバイナリ数10をbigint値に変換します。

  • クエリ文
    * | SELECT from_big_endian_64(to_big_endian_64 (10))
  • クエリと分析結果from_big_endian_64

from_hex関数

from_hex関数は、16進数を2進数に変換するために使用されます。

構文

from_hex(x)

パラメーター

パラメーター説明
xこのパラメーターの値はvarbinary型です。

戻り値のデータ型

varbinary型。

例

16進数D74Dを2進数に変換します。

  • クエリ文
    * | SELECT from_hex('D74D')
  • クエリと分析結果from_hex

長さ関数

長さ関数は、2進数の長さを計算するために使用される。

構文

長さ (x)

パラメーター

パラメーター説明
xこのパラメーターの値はバイナリ型です。

戻り値のデータ型

The bigint type.

例

regionフィールド値の長さを計算します。

  • クエリ文
    * | SELECTの長さ ('00101000')
  • クエリと分析結果length

md5関数

md5関数は、2進数のMD5ハッシュ値を計算するために使用されます。

構文

md5(x)

パラメーター

パラメーター説明
xこのパラメーターの値はvarbinary型です。

戻り値のデータ型

varbinary型。

例

バイナリ数1101のMD5ハッシュ値を計算します。

  • クエリ文
    * | SELECT MD5(from_base64('1101')) AS md5
  • クエリと分析結果MD5

to_base64関数

to_base64関数は、バイナリ数値をBase64-encoded文字列に変換するために使用されます。

構文

to_base64(x)

パラメーター

パラメーター説明
xこのパラメーターの値はバイナリ型です。

戻り値のデータ型

varcharタイプ。

例

バイナリ数10をBase64-encoded文字列に変換します。

  • クエリ文
    * | SELECT to_base64(from_base64('10')) AS base64
  • クエリと分析結果to_base64

to_base64url関数

to_base64url関数は、URL予約文字を使用してバイナリ数値をBase64-encoded文字列に変換するために使用されます。

構文

to_base64url(x)

パラメーター

パラメーター説明
xこのパラメーターの値はバイナリ型です。

戻り値のデータ型

varcharタイプ。

例

URL予約文字を使用して、バイナリ番号100をBase64-encoded文字列に変換します。

  • クエリ文
    * | SELECT to_base64url(from_base64('100'))
  • クエリと分析結果 to_base64url

to_hex関数

to_hex関数は、2進数を16進数に変換するために使用されます。

構文

to_hex(x)

パラメーター

パラメーター説明
xこのパラメーターの値はバイナリ型です。

戻り値のデータ型

varcharタイプ。

例

2進数100を16進数に変換します。

  • クエリ文
    * | SELECT to_hex(from_base64('100'))
  • クエリと分析結果to_hex

to_big_endian_64関数

to_big_endian_64関数は、bigint値をビッグエンディアンモードで2進数に変換するために使用されます。

構文

to_big_endian_64(x)

パラメーター

パラメーター説明
xこのパラメーターの値はbigint型です。

戻り値のデータ型

varbinary型。

例

bigint値0をビッグエンディアンモードで2進数に変換します。

  • クエリ文
    * | SELECT to_big_endian_64 (0)
  • クエリと分析結果to_big_endian_64

sha1関数

sha1関数は、2進数のSHA-1ハッシュ値を計算するために使用されます。

構文

sha1(x)

パラメーター

パラメーター説明
xこのパラメーターの値はバイナリ型です。

戻り値のデータ型

varbinary型。

例

2進数1101のSHA-1ハッシュ値を計算します。

  • クエリ文
    * | SELECT sha1(from_base64('1101')) AS sha1
  • クエリと分析結果sha1

sha256関数

sha256関数は、2進数のSHA-256ハッシュ値を計算するために使用されます。

構文

sha256(x)

パラメーター

パラメーター説明
xこのパラメーターの値はバイナリ型です。

戻り値のデータ型

varbinary型。

例

2進数1101のSHA-256ハッシュ値を計算する。

  • クエリ文
    * | SELECT sha256(from_base64('1101')) AS sha256
  • クエリと分析結果sha256

sha512関数

sha512関数は、2進数のSHA-512ハッシュ値を計算するために使用されます。

構文

sha512(x)

パラメーター

パラメーター説明
xこのパラメーターの値はバイナリ型です。

戻り値のデータ型

varbinary型。

例

2進数1101のSHA-512ハッシュ値を計算する。

  • クエリ文
    * | SELECT sha512(from_base64('1101')) AS sha512
  • クエリと分析結果sha512

xxhash64関数

xxhash64関数は、2進数のxxhash64ハッシュ値を計算するために使用されます。

構文

xxhash64(x)

パラメーター

パラメーター説明
xこのパラメーターの値はバイナリ型です。

戻り値のデータ型

varbinary型。

例

2進数10のxxhash64ハッシュ値を計算します。

  • クエリ文
    * | SELECT xxhash64(from_base64('10'))
  • クエリと分析結果xxhash64