关键字： KingbaseES、人大金仓、sql函数、hex、unhex
函数调研
mysql8 hex函数调研
语法：hex(arg);
功能：将一个字符串或数字转换为十六进制格式的字符串。
其中参数arg分为两种：字符串参数str，数字参数N。
- 对于字符串参数str，hex返回str的十六进制字符串，其中str中每个字符的每个字节的编码以两个十六进制数字表示。
- 对于数字参数N分为两种情况：N为整数时，若超出bigint最大范围，则输出7FFFFFFFFFFFFFFF，若未超出hex将N值的十六进制字符串表示将10进制数以16进制形式显示；N为小数时，会先将N四舍五入为整数再进行hex函数执行。
- 若参数是其他类型，会先转化为字符串然后按字符串进行处理。
mysql8 unhex函数调研
语法：unhex(arg);
功能：将参数种每对十六进制数字转换为该数字表示的字符。
其中参数arg分为两种：字符串参数str，数字参数N。
- 对于字符串参数str，将参数中的每对字符解释为十六进制数字，并将其为该数字所表示的字节。返回类型为binary。
- 参数字符串中的字符必须合法的十六进制数字：“0”…“9”，“A”…“F”，“a”…”f”,如果参数遇到任何非十六进制数字，则返回NULL；
- 对于数值参数N，不接受小数，负数形式参数，返回null，只允许参数为正整数，将N转为字符串处理；
- 对于其他类型参数，返回NULL
推导分析
mysql hex测试用例
| 函数 | 用例 | 结果 |
|---|---|---|
| hex(str) | select hex(''); | 空 |
| select hex(' '); | 20 | |
| select hex(null); | null | |
| select hex('aaa'); | 616161 | |
| select hex('111'); | 313131 | |
| select hex('1a1'); | 316131 | |
| select hex('*'); | 2A | |
| select hex('M'); | 4D | |
| select hex('M^1'); | 4D5E31 | |
| select hex('给'); | E7BB99 | |
| select hex('2023-08-16 00:00:00'); | 323032332D30382D31362030303A30303A3030 | |
| select hex(to_date('2023-08-16 00:00:00','%Y-%m-%d')); | 323032332D30382D31362030303A30303A3030 | |
| select hex('09:30:00'); | 30393A33303A3030 | |
| select hex(time('09:30:00')); | 30393A33303A3030 | |
| select hex('hello'); | 68656C6C6F | |
| select hex(cast('hello' as binary)); | 68656C6C6F | |
| select hex(cast('10' as double)); | A | |
| select hex(10); | A | |
| hex(N) | select hex(12); | C |
| select hex(12.5); | D | |
| select hex(12.3); | C | |
| select hex(12.8); | D | |
| select hex(-12); | FFFFFFFFFFFFFFF4 | |
| select hex(-12.2); | FFFFFFFFFFFFFFF4 | |
| select hex(-12.5); | FFFFFFFFFFFFFFF3 | |
| select hex(123a); | 报错 | |
| select hex(100000000000000000000000000); | 7FFFFFFFFFFFFFFF，warning | |
mysql unhex测试用例
| 函数 | 用例 | mysql结果 |
|---|---|---|
| unhex（） | --skip-binary-as-hex | |
| select unhex(-6161); | Null，warning | |
| select unhex(123.123); | Null，warning | |
| select unhex(-123.123); | Null，warning | |
| select unhex('6161'); | aa | |
| select unhex(6161); | aa | |
| select unhex('6161.6262'); | Null，warning | |
| select unhex('asd'); | Null，warning | |
| select unhex(346); | F | |
| select unhex('346'); | F | |
| select unhex(''); | 空 | |
| select unhex(' '); | Null，warning | |
| select unhex(null); | Null | |
| 不加—skip-binary-as-hex | ||
| select unhex(-6161); | Null，warning | |
| select unhex(123.123); | Null，warning | |
| select unhex(-123.123); | Null，warning | |
| select unhex('6161'); | 0x6161 | |
| select unhex(6161); | 0x6161 | |
| select unhex('6161.6262'); | Null，warning | |
| select unhex('asd'); | Null，warning | |
| select unhex(346); | 0x0346 | |
| select unhex('346'); | 0x0346 | |
| select unhex(''); | 0x | |
| select unhex(' '); | Null，warning | |
| select unhex(null); | Null | |
| select unhex(now()); | Null，warning | |
| select unhex(cast('hello' as binary)); | NULL | |
hex功能
1、 函数定义：text hex(text str)
函数功能：将str中每个字符对应的字节以十六进制数字表示。
- 如果参数是null则返回null，若为’’则返回null；
- 支持中文传参；
- 如果参数为其他类型，数据库会先将其转换为字符串类型再进行函数转化功能；
函数主要属性：
- proname：hex
- pronamespace：8000（sys）
- prokind：f（普通函数）
- proisstrict：t
- provolatile：i
- proparallel：s
2、 函数定义：text hex(numeric val)
函数功能：将val十进制数计算机中的字节表示以十六进制的字符串显示。
- 如果参数是null则返回null；
- 接受参数为小数，会先将小数四舍五入成整数；
- 参数支持负数。
函数主要属性：
- proname：hex
- pronamespace：8000（sys）
- prokind：f（普通函数）
- proisstrict：t
- provolatile：i
- proparallel：s
unhex功能
- 函数定义：binary unhex(text str)；
函数功能：把十六进制格式的字符串返回binary类型的值。
- 参数字符串中的字符必须合法的十六进制数字：“0”…“9”，“A”…“F”，“a”…”f”,如果参数遇到任何非十六进制数字，则返回NULL；
- 参数输入null传出null；
- 参数若为整数类型，将其转换字符串进行处理。
- 其他类型则返回NULL。
实现函数
3.1 unhex函数
| Plsql:create function sys.unhex(text)returns binaryas declarea varchar;result varchar;beginif $1 is null thenreturn null;elseresult := concat('0x',$1);return result::binary;end if;end; language plpgsql;//c语言实现Datumunhex(KDB_FUNCTION_ARGS){text *val = KDB_GETARG_TEXT_P(0);Binary *res = NULL;text *temp = NULL;temp = (DatumGetTextP(DirectFunctionCall2(textcat,(Datum)cstring_to_text("0x"),PointerGetDatum(val))));res = DatumGetVarBinaryP(DirectFunctionCall3(binaryin,PointerGetDatum(TextDatumGetCString(temp)),ObjectIdGetDatum(InvalidOid),Int32GetDatum(-1)));KDB_RETURN_BINARY_P(res);} |
|---|
-
- 3.2 hex函数
| create or replace function sys.hex(numeric)returns textas select upper(to_hex($1::bigint)); language sql;CREATE OR REPLACE FUNCTION hex(int4)RETURNS textAS select hex($1::numeric)LANGUAGE SQL;CREATE OR REPLACE FUNCTION hex(double)RETURNS textAS select hex($1::numeric)LANGUAGE SQL;CREATE OR REPLACE FUNCTION hex(timestamp)RETURNS textAS select hex($1::text)LANGUAGE SQL;CREATE OR REPLACE FUNCTION hex(time)RETURNS textAS select hex($1::text)LANGUAGE SQL;-- 参数为文本create function sys.hex(text)returns textas select upper(encode($1::bytea,'hex')); language sql; |
|---|
参考资料
《KingbaseES SQL 语言参考手册》
