文档中心

二进制函数

最近更新时间：2024.01.22 17:18:38

首次发布时间：2024.01.22 17:18:38

本文介绍日志服务支持的二进制函数语法及常见场景的使用示例。

函数列表

说明

在日志服务分析语句（SQL 语句）中，需要使用单引号（''）包裹代表字符串的字符，无符号包裹或被双引号（""）包裹的字符为字段名或列名。例如'time' 代表字符串，time 或 "time" 代表字段名或列名。

函数名称	函数语法	说明
FROM_BASE64 函数	FROM_BASE64(KEY)	将 BASE64 编码的字符串解码为二进制类型。
FROM_BASE64URL 函数	FROM_BASE64URL(KEY)	使用 URL 安全字符将 BASE64 编码的字符串解码为二进制类型。
FROM_HEX 函数	FROM_HEX(KEY)	将十六进制类型转化成二进制类型。
LENGTH 函数	LENGTH(KEY)	计算二进制类型字符串的长度。
MD5 函数	MD5(KEY)	对二进制类型字符串进行 MD5 编码。
TO_BASE64 函数	TO_BASE64(KEY)	对二进制类型字符串进行BASE64编码。
TO_BASE64URL 函数	TO_BASE64URL(KEY)	使用 URL 安全字符将二进制类型字符串进行BASE64编码。
TO_HEX 函数	TO_HEX(KEY)	将二进制类型转化成十六进制类型。
SHA1 函数	SHA1(KEY)	对二进制类型字符串进行 SHA1 加密。
SHA256 函数	SHA256(KEY)	对二进制类型字符串进行 SHA256 加密。
SHA512 函数	SHA512(KEY)	对二进制类型字符串进行 SHA512 加密。

FROM_BASE64 函数

FROM_BASE64 函数用于将 BASE64 编码的字符串解码为二进制类型。

函数语法

语法格式
```
FROM_BASE64(KEY)
```
参数说明
参数
说明
KEY
字段、表达式，值为 Binary 类型。
返回值说明
返回值为 Varbinary 类型。

参数	说明
KEY	字段、表达式，值为 Binary 类型。

函数示例

场景
将 BASE64 编码的字符串解码为二进制类型后，再转换为十六进制字符串。
检索和分析语句
```
* | SELECT TO_HEX(FROM_BASE64('c2xz'))
```
检索和分析结果

FROM_BASE64URL 函数

FROM_BASE64URL 函数使用 URL 安全字符将 BASE64 编码的字符串解码为二进制类型。

函数语法

语法格式
```
FROM_BASE64URL(KEY)
```
参数说明
参数
说明
KEY
字段、表达式，值为 Binary 类型。
返回值说明
返回值类型为 Varbinary 类型。

参数	说明
KEY	字段、表达式，值为 Binary 类型。

函数示例

场景
使用 URL 安全字符将 BASE64 编码的字符串解码为二进制类型。

检索和分析语句

* | SELECT TO_HEX(FROM_BASE64URL('c2xz'))

检索和分析结果

FROM_HEX 函数

FROM_HEX 函数将十六进制类型转化成二进制类型。

函数语法

语法格式
```
FROM_HEX(KEY)
```
参数说明
参数
说明
KEY
字段、表达式，值为 Binary 类型。
返回值说明
返回值类型为 Varbinary 类型。

参数	说明
KEY	字段、表达式，值为 Binary 类型。

函数示例

场景
将十六进制类型字符串（D74D）转换为二进制类型。
检索和分析语句
```
* | SELECT FROM_HEX('D74D')
```
检索和分析结果

LENGTH 函数

LENGTH 函数用于计算二进制类型字符串的长度。

函数语法

语法格式
```
LENGTH(KEY)
```
参数说明
参数
说明
KEY
字段、表达式，值为 Binary 类型。
返回值说明
返回值类型为 Binary 类型。

参数	说明
KEY	字段、表达式，值为 Binary 类型。

函数示例

场景
计算 '00101000' 的长度。
检索和分析语句
```
* | SELECT LENGTH('00101000')
```
检索和分析结果

MD5 函数

MD5 函数用于对二进制类型字符串进行 MD5 编码。

函数语法

语法格式
```
MD5(KEY)
```
参数说明
参数
说明
KEY
字段、表达式，值为 Varbinary 类型。
返回值说明
返回值类型为 Varbinary 类型。

参数	说明
KEY	字段、表达式，值为 Varbinary 类型。

函数示例

场景
对二进制类型字符串（1101）进行MD5编码。

检索和分析语句

* | SELECT MD5(FROM_BASE64('1101')) AS MD5

检索和分析结果

TO_BASE64 函数

TO_BASE64 函数用于对二进制类型字符串进行 BASE64 编码。

函数语法

语法格式
```
TO_BASE64(KEY)
```
参数说明
参数
说明
KEY
字段、表达式，值为 Binary 类型。
返回值说明
返回值类型为 Varchar 类型。

参数	说明
KEY	字段、表达式，值为 Binary 类型。

函数示例

场景
对二进制类型字符串（10）进行 BASE64 编码。

检索和分析语句

* | SELECT  TO_BASE64(FROM_BASE64('10')) AS base64

检索和分析结果

TO_BASE64URL 函数

TO_BASE64URL 函数使用 URL 安全字符对二进制类型字符串进行 BASE64 编码。

函数语法

语法格式
```
TO_BASE64URL(KEY)
```
参数说明
参数
说明
KEY
字段、表达式，值为 Binary 类型。
返回值说明
返回值类型为 varchar 类型。

参数	说明
KEY	字段、表达式，值为 Binary 类型。

函数示例

场景
使用URL安全字符对二进制类型字符串（100）进行 BASE64 编码。

检索和分析语句

* | SELECT  TO_BASE64URL(FROM_BASE64('100'))

检索和分析结果

TO_HEX 函数

TO_HEX 函数用于将二进制类型转化成十六进制类型。

函数语法

语法格式
```
TO_HEX(KEY)
```
参数说明
参数
说明
KEY
字段、表达式，值为 Binary 类型。
返回值说明
返回值类型为 Varchar 类型。

参数	说明
KEY	字段、表达式，值为 Binary 类型。

函数示例

场景
将二进制类型字符串（100）转化成十六进制类型。
检索和分析语句
```
* | SELECT TO_HEX(FROM_BASE64('100'))
```
检索和分析结果

SHA1 函数

SHA1 函数用于对二进制类型字符串进行 SHA1 加密。

函数语法

语法格式
```
SHA1(KEY)
```
参数说明
参数
说明
KEY
字段、表达式，值为 Binary 类型。
返回值说明
返回值类型为 Varbinary 类型。

参数	说明
KEY	字段、表达式，值为 Binary 类型。

函数示例

场景
对二进制类型字符串（1101）进行SHA1加密。

检索和分析语句

* | SELECT SHA1(FROM_BASE64('1101')) AS SHA1

检索和分析结果

SHA256 函数

SHA256 函数用于对二进制类型字符串进行 SHA256 加密。

函数语法

语法格式
```
SHA256(KEY)
```
参数说明
参数
说明
KEY
字段、表达式，值为 Binary 类型。
返回值说明
返回值类型为 Varbinary 类型。

参数	说明
KEY	字段、表达式，值为 Binary 类型。

函数示例

场景
对二进制类型字符串（1101）进行SHA256加密。

检索和分析语句

* | SELECT SHA256(FROM_BASE64('1101')) AS SHA256

检索和分析结果

SHA512 函数

SHA512 函数用于对二进制类型字符串进行 SHA512 加密。

函数语法

语法格式
```
SHA512(KEY)
```
参数说明
参数
说明
KEY
字段、表达式，值为 Binary 类型。
返回值说明
返回值类型为 Varbinary 类型。

参数	说明
KEY	字段、表达式，值为 Binary 类型。

函数示例

场景
对二进制类型字符串（1101）进行 SHA512 加密。

检索和分析语句

* | SELECT SHA512(FROM_BASE64('1101')) AS SHA512

检索和分析结果