このトピックでは、バイナリ関数の構文について説明します。 このトピックでは、関数の使用方法の例も示します。
次の表に、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型。
- 返されたバイナリ数値が非表示文字の場合は、to_hex関数を使用して数値を16進数に変換できます。
- 返された2進数が可視文字の場合は、from_utf8関数を使用して数値をUTF-8文字列に変換できます。
例
Base64エンコードされた文字列を2進数に変換し、さらに2進数を16進数に変換します。
- クエリ文
* | SELECT to_hex(from_base64('c2xz'))
- クエリと分析結果
from_base64url関数
from_base64url関数は、URL予約文字を使用してBase64-encoded文字列をバイナリ数に変換するために使用されます。
構文
from_base64url(x)
パラメーター
パラメーター | 説明 |
---|---|
x | このパラメーターの値はバイナリ型です。 |
戻り値のデータ型
- 返されたバイナリ数値が非表示文字の場合は、to_hex関数を使用して数値を16進数に変換できます。
- 返された2進数が可視文字の場合は、from_utf8関数を使用して数値をUTF-8文字列に変換できます。
例
URL予約文字を使用して、Base64-encoded文字列をバイナリ数に変換します。
- クエリ文
* | SELECT to_hex(from_base64url('c2xz'))
- クエリと分析結果
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_hex関数
from_hex関数は、16進数を2進数に変換するために使用されます。
構文
from_hex(x)
パラメーター
パラメーター | 説明 |
---|---|
x | このパラメーターの値はvarbinary型です。 |
戻り値のデータ型
varbinary型。
例
16進数D74Dを2進数に変換します。
- クエリ文
* | SELECT from_hex('D74D')
- クエリと分析結果
長さ関数
長さ関数は、2進数の長さを計算するために使用される。
構文
長さ (x)
パラメーター
パラメーター | 説明 |
---|---|
x | このパラメーターの値はバイナリ型です。 |
戻り値のデータ型
The bigint type.
例
regionフィールド値の長さを計算します。
- クエリ文
* | SELECTの長さ ('00101000')
- クエリと分析結果
md5関数
md5関数は、2進数のMD5ハッシュ値を計算するために使用されます。
構文
md5(x)
パラメーター
パラメーター | 説明 |
---|---|
x | このパラメーターの値はvarbinary型です。 |
戻り値のデータ型
varbinary型。
例
バイナリ数1101のMD5ハッシュ値を計算します。
- クエリ文
* | SELECT MD5(from_base64('1101')) AS md5
- クエリと分析結果
to_base64関数
to_base64関数は、バイナリ数値をBase64-encoded文字列に変換するために使用されます。
構文
to_base64(x)
パラメーター
パラメーター | 説明 |
---|---|
x | このパラメーターの値はバイナリ型です。 |
戻り値のデータ型
varcharタイプ。
例
バイナリ数10をBase64-encoded文字列に変換します。
- クエリ文
* | SELECT to_base64(from_base64('10')) AS base64
- クエリと分析結果
to_base64url関数
to_base64url関数は、URL予約文字を使用してバイナリ数値をBase64-encoded文字列に変換するために使用されます。
構文
to_base64url(x)
パラメーター
パラメーター | 説明 |
---|---|
x | このパラメーターの値はバイナリ型です。 |
戻り値のデータ型
varcharタイプ。
例
URL予約文字を使用して、バイナリ番号100をBase64-encoded文字列に変換します。
- クエリ文
* | SELECT to_base64url(from_base64('100'))
- クエリと分析結果
to_hex関数
to_hex関数は、2進数を16進数に変換するために使用されます。
構文
to_hex(x)
パラメーター
パラメーター | 説明 |
---|---|
x | このパラメーターの値はバイナリ型です。 |
戻り値のデータ型
varcharタイプ。
例
2進数100を16進数に変換します。
- クエリ文
* | SELECT to_hex(from_base64('100'))
- クエリと分析結果
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)
- クエリと分析結果
sha1関数
sha1関数は、2進数のSHA-1ハッシュ値を計算するために使用されます。
構文
sha1(x)
パラメーター
パラメーター | 説明 |
---|---|
x | このパラメーターの値はバイナリ型です。 |
戻り値のデータ型
varbinary型。
例
2進数1101のSHA-1ハッシュ値を計算します。
- クエリ文
* | SELECT sha1(from_base64('1101')) AS sha1
- クエリと分析結果
sha256関数
sha256関数は、2進数のSHA-256ハッシュ値を計算するために使用されます。
構文
sha256(x)
パラメーター
パラメーター | 説明 |
---|---|
x | このパラメーターの値はバイナリ型です。 |
戻り値のデータ型
varbinary型。
例
2進数1101のSHA-256ハッシュ値を計算する。
- クエリ文
* | SELECT sha256(from_base64('1101')) AS sha256
- クエリと分析結果
sha512関数
sha512関数は、2進数のSHA-512ハッシュ値を計算するために使用されます。
構文
sha512(x)
パラメーター
パラメーター | 説明 |
---|---|
x | このパラメーターの値はバイナリ型です。 |
戻り値のデータ型
varbinary型。
例
2進数1101のSHA-512ハッシュ値を計算する。
- クエリ文
* | SELECT sha512(from_base64('1101')) AS sha512
- クエリと分析結果
xxhash64関数
xxhash64関数は、2進数のxxhash64ハッシュ値を計算するために使用されます。
構文
xxhash64(x)
パラメーター
パラメーター | 説明 |
---|---|
x | このパラメーターの値はバイナリ型です。 |
戻り値のデータ型
varbinary型。
例
2進数10のxxhash64ハッシュ値を計算します。
- クエリ文
* | SELECT xxhash64(from_base64('10'))
- クエリと分析結果