12.2. 内置函数

本节主要介绍统一SQL支持原生MySQL数据库中的函数（注：统一SQL不会针对函数入参进行有效性校验，仅做函数语法转换，对于在GaussDB-Oracle库中认定的非法参数即按照目标库自身行为进行处理，如执行失败、报错等）

12.2.1. 时间日期函数

12.2.1.1. YEAR

语法: YEAR(date)
描述: 该函数功能是返回日期的年份。

参数解释

参数	说明
date	指定日期。该参数可以为 text、timestamp 数据类型。

示例

-- 转换前MySQL SQL：
select year(20200101);
+----------------+
| year(20200101) |
+----------------+
| 2020           |
+----------------+

select year('200102');
+----------------+
| year('200102') |
+----------------+
| 2020           |
+----------------+

-- 转换后GaussDB-Oracle SQL：
SELECT unisql.year(20200101);
year
------
2020

SELECT unisql.year('200102');
year
------
2020

12.2.1.2. DAY

语法: DAY(date)
描述: 该函数返回当前会话时区的当前日期

参数解释

参数	说明
date	指定日期。该参数可以为 text、timestamp 数据类型。

示例

-- 转换前MySQL SQL：
select day(20200101);
+---------------+
| day(20200101) |
+---------------+
| 1             |
+---------------+

select day('200102');
+---------------+
| day('200102') |
+---------------+
| 2             |
+---------------+

-- 转换后GaussDB-Oracle SQL：
SELECT unisql.day(20200101);
day
-----
   1

SELECT unisql.day('200102');
day
-----
   2

12.2.1.3. DAYOFWEEK

语法: DAYOFWEEK(time)
描述: 该函数返回星期几

参数解释

参数	说明
time	指定日期。该参数可以为 text、timestamp 数据类型。

示例

-- 转换前MySQL SQL：
select dayofweek(20200101);
+---------------------+
| dayofweek(20200101) |
+---------------------+
| 4                   |
+---------------------+

select dayofweek('200102');
+---------------------+
| dayofweek('200102') |
+---------------------+
| 5                   |
+---------------------+

-- 转换后GaussDB-Oracle SQL：
SELECT unisql.dayofweek(20200101)
dayofweek
-----------
         5

SELECT unisql.dayofweek('200102')
dayofweek
-----------
         4

12.2.1.4. WEEKOFYEAR

语法: WEEKOFYEAR(time)
描述: 该函数返回当前的周数

参数解释

参数	说明
time	指定日期。该参数可以为 text、timestamp 数据类型。

示例

-- 转换前MySQL SQL：
select weekofyear(20200101);
+----------------------+
| weekofyear(20200101) |
+----------------------+
| 1                    |
+----------------------+

select weekofyear('200102');
+----------------------+
| weekofyear('200102') |
+----------------------+
| 1                    |
+----------------------+

-- 转换后GaussDB-Oracle SQL：
SELECT unisql.weekofyear(20200101);
weekofyear
------------
         1

SELECT unisql.weekofyear('200102');
weekofyear
------------
         1

12.2.1.5. DATE_FORMAT

语法: DATE_FORMAT(time, format)
描述: 按照指定的日期格式显示

参数解释

参数	说明
time
format	日期显示格式，该参数为字符串类型，支持清单详见下表

序号	日期时间显示格式	含义
1	%c	月，数值
2	%d	月的天，数值(00-31)
3	%e	月的天，数值(0-31)
4	%f	微秒
5	%H	小时 (00-23)
6	%h	小时 (01-12)
7	%I	小时 (01-12)
8	%i	分钟，数值(00-59)
9	%k	小时 (0-23)
10	%l	小时 (1-12)
11	%M	月名
12	%m	月，数值(00-12)
13	%p	AM 或 PM
14	%r	时间，12-小时（hh:mm:ss AM 或 PM）
15	%S	秒(00-59)
16	%s	秒(00-59)
17	%T	时间，24-小时（hh:mm:ss）
18	%W	星期名
19	%Y	年，4位
20	%y	年，2位

示例

-- 转换前MySQL SQL：
select date_format('2020-01-01 08:13:13', '%Y/%m/%d %h %i %s');
+---------------------------------------------------------+
| date_format('2020-01-01 08:13:13', '%Y/%m/%d %h %i %s') |
+---------------------------------------------------------+
| 2020/01/01 08 13 13                                     |
+---------------------------------------------------------+

-- 转换后GaussDB-Oracle SQL：
SELECT unisql.date_format('2020-01-01 08:13:13', 'YYYY/MM/DD HH MI SS');
   date_format
---------------------
2020/01/01 08 13 13

12.2.1.6. STR_TO_DATE

语法: STR_TO_DATE(date, format)
描述: 将字符串转换为时间值。这是 DATE_FORMAT() 函数的反函数

参数解释

参数	说明
date	指定日期时间，该参数为 text数据类型
format	日期显示格式，支持清单详见DATA_FORMAT一节

警告

date的范围需要与format范围一致，例如date精确到秒，那么format也需要精确到秒

示例

 -- 转换前Oracle SQL：
select str_to_date('2022/09/10 11,13,13', '%Y/%m/%d %h,%i,%s');
+---------------------------------------------------------+
| str_to_date('2022/09/10 11,13,13', '%Y/%m/%d %h,%i,%s') |
+---------------------------------------------------------+
| 2022-09-10 11:13:13                                     |
+---------------------------------------------------------+

-- 转换后GaussDB-Oracle SQL：
SELECT to_date('2022/09/10 11,13,13', 'YYYY/MM/DD HH,MI,SS');
      to_date
---------------------
2022-09-10 11:13:13

12.2.1.7. FROM_UNIXTIME

语法: FROM_UNIXTIME (timestmap1 [, foramt])
描述: 根据 UNIX 时间戳返回时间格式

参数解释

参数	说明
timestmap1	UNIX 时间戳，该参数可以为字符串或整形数据类型。
format	日期显示格式，支持清单详见DATA_FORMAT一节

示例

警告

第二个参数可选，如仅传入第一个参数，则默认时间格式为 %Y-%m-%d %h:%i:%s

-- 转换前MySQL SQL：
select from_unixtime(20220910);
+-------------------------+
| from_unixtime(20220910) |
+-------------------------+
| 1970-08-23 08:55:10     |
+-------------------------+

select from_unixtime(20220910, '%Y/%m/%d %h,%i,%s');
+----------------------------------------------+
| from_unixtime(20220910, '%Y/%m/%d %h,%i,%s') |
+----------------------------------------------+
| 1970/08/23 08,55,10                          |
+----------------------------------------------+

-- 转换后GaussDB-Oracle SQL：
SELECT unisql.from_unixtime(20220910);
   from_unixtime
---------------------
1970-08-23 08:55:10

SELECT unisql.from_unixtime(20220910, 'YYYY/MM/DD HH,MI,SS');
   from_unixtime
---------------------
1970/08/23 08,55,10

12.2.1.8. UNIX_TIMESTAMP

语法: UNIX_TIMESTAMP ([timestmap1])
描述: 根据 UNIX 时间戳返回时间格式

参数解释

参数	说明
timestmap1	日期时间，该参数可以为字符串或timestamp数据类型。

示例

警告

函数入参可选，如果不传入参数，则默认返回当前linux系统时间的unix时间戳
当参数为空或者参数为now()时，转化为GAUSSDB_ORACLE的语法，查询的结果会有5位小数
注意将数据库的时区设置正确

-- 转换前MySQL SQL：
select UNIX_TIMESTAMP('2020-01-01 13:13:13');
+---------------------------------------+
| UNIX_TIMESTAMP('2020-01-01 13:13:13') |
+---------------------------------------+
| 1577855593                            |
+---------------------------------------+

-- 转换后GaussDB-Oracle SQL：
SELECT extract(epoch FROM CAST('2020-01-01 13:13:13' AS timestamp with time zone));
date_part
------------
1577855593

-- 转换前MySQL SQL：
SELECT UNIX_TIMESTAMP(now());
+-----------------------+
| UNIX_TIMESTAMP(now()) |
+-----------------------+
|            1724059253 |
+-----------------------+

-- 转换后GaussDB-Oracle SQL：
SELECT extract(epoch FROM CAST(now() AS timestamp with time zone));
 date_part
------------------
1724059253.43542

12.2.1.9. DATE_ADD

语法: DATE_ADD (timestamp1, interval)
描述: 用于将指定的时间间隔添加到日期或时间值上

参数解释

参数	说明
timestmap1	日期时间，该参数可以为字符串或timestamp数据类型。
interval	时间间隔，该参数为interval类型，支持清单：年（year）/月（month）/星期（week）/日（day）

警告

和mysql的DATE_ADD不同，经统一sql转换执行GaussDB-Oracle的DATE_ADD查询结果返回的是timestamp;

示例

-- 转换前MySQL SQL：
select date_add('20200101', interval 1 day);
+--------------------------------------+
| date_add('20200101', interval 1 day) |
+--------------------------------------+
| 2020-01-02                           |
+--------------------------------------+

select date_add('20200101', interval 1 week);
+---------------------------------------+
| date_add('20200101', interval 1 week) |
+---------------------------------------+
| 2020-01-08                            |
+---------------------------------------+

select date_add('20200101', interval 2.6 day);
+---------------------------------------+
| date_add('20200101', interval 2.6 day)|
+---------------------------------------+
| 2020-01-04                            |
+---------------------------------------+

-- 转换后GaussDB-Oracle SQL：
SELECT unisql.date_add('20200101', 1, 'day');
      date_add
---------------------
2020-01-02 00:00:00

SELECT unisql.date_add('20200101', 1, 'week');
      date_add
---------------------
2020-01-08 00:00:00

SELECT unisql.date_add('20200101', 2.6, 'day')
      date_add
---------------------
2020-01-04 00:00:00

12.2.1.10. DATE_SUB

语法: DATE_SUB (timestamp1, interval)
描述: 用于从指定的日期或时间值中减去一个时间间隔

参数解释

参数	说明
timestmap1	日期时间，该参数可以为字符串或timestamp数据类型。
interval	时间间隔，该参数为interval类型，支持清单：年（year）/月（month）/星期（week）/日（day）

警告

和mysql的DATE_SUB不同，经统一sql转换执行GaussDB-Oracle的DATE_SUB查询结果返回的是timestamp;

示例

-- 转换前MySQL SQL：
select date_sub('20200101', interval 1 day);
+--------------------------------------+
| date_sub('20200101', interval 1 day) |
+--------------------------------------+
| 2019-12-31                           |
+--------------------------------------+

select date_sub('20200101', interval 1 week);
+---------------------------------------+
| date_sub('20200101', interval 1 week) |
+---------------------------------------+
| 2019-12-25                            |
+---------------------------------------+

select date_sub('20200101', interval 2.6 day);
+-------------------------------------------+
| date_sub('20200101', interval 2.6 day)    |
+-------------------------------------------+
| 2019-12-29                                |
+-------------------------------------------+

-- 转换后GaussDB-Oracle SQL：
SELECT unisql.date_sub('20200101', 1, 'day');
      date_sub
---------------------
2019-12-31 00:00:00

SELECT unisql.date_sub('20200101', 1, 'week');
      date_sub
---------------------
2019-12-25 00:00:00

SELECT unisql.date_sub('20200101', 2.6, 'day');
      date_sub
---------------------
2019-12-29 00:00:00

12.2.1.11. CURDATE

语法: CURDATE ()
描述: 以 %y-%m-%d 格式返回当前日期

示例

-- 转换前MySQL SQL：
select curdate();
+------------+
| curdate()  |
+------------+
| 2024-08-12 |
+------------+

-- 转换后GaussDB-Oracle SQL：
SELECT current_date;
      timestamp
---------------------
2024-08-12 12:34:43

12.2.1.12. SYSDATE

语法: SYSDATE ()
描述: 返回此函数执行时的时间，受当前时区设置影响。

示例

-- 转换前MySQL SQL：
select sysdate();
+---------------------+
| sysdate()           |
+---------------------+
| 2024-08-12 08:56:34 |
+---------------------+

-- 转换后GaussDB-Oracle SQL：
SELECT sysdate;
      sysdate
---------------------
2024-08-12 12:35:14

12.2.1.13. TIMESTAMP

语法: TIMESTAMP()
描述: 将日期和时间转换成一个标准的时间戳格式，也可以用于将日期和时间的字符串表示形式转换为时间戳。目前仅适配函数的参数为now();

示例

-- 转换前MySQL SQL：
select timestamp(now()) from dual;
timestamp(now())       |
-----------------------+
2024-08-23 13:20:27.000|

-- 转换后GaussDB-Oracle SQL：
SELECT CAST(now() AS timestamp(0)) FROM sys_dummy
now                    |
-----------------------+
2024-08-23 13:20:27.000|

12.2.2. 条件函数

12.2.2.1. IFNULL

语法: IFNULL (anycompatible1, anycompatible2)
描述: 根据参数是否为空，返回相应的值。

参数解释

参数	说明
anycompatible1	判断该参数是否为null，如果不为null，则返回该参数
anycompatible2	判断第一个参数是否为null，如果为null，则返回该参数

示例

-- 转换前MySQL SQL：
select ifnull(1, 15);
+---------------+
| ifnull(1, 15) |
+---------------+
| 1             |
+---------------+

select ifnull(null, 15);
+------------------+
| ifnull(null, 15) |
+------------------+
| 15               |
+------------------+

-- 转换后GaussDB-Oracle SQL：
SELECT nvl(1, 15);
nvl
-----
   1

SELECT nvl(NULL, 15);
nvl
-----
15

12.2.2.2. IF

语法: IF (expr1, expr2, expr3)
描述: 如果第一个参数为TRUE，则返回第二个参数，否则返回第三个参数。

参数解释

参数	说明
expr1	判断该参数是否为true
expr2	如果expr1为true，则返回expr2
expr3	如果expr1不为true，则返回expr3

示例

-- 转换前MySQL SQL：
SELECT IF(1>2,2,3);
+-------------+
| IF(1>2,2,3) |
+-------------+
| 3           |
+-------------+

-- 转换后GaussDB-Oracle SQL：
SELECT CASE 1>2 WHEN 1 THEN 2 ELSE 3 END;
case
------
   3

12.2.2.3. ISNULL

语法: ISNULL (anycompatible)
描述: 判断是否为null，为null则返回1，非null返回0

参数解释

参数	说明
anycompatible	判断该参数是否为null

示例

create table t1(id text);
insert into t1 values(123), (null), ('a');

-- 转换前MySQL SQL：
select isnull(id) from t1;
+------------+
| isnull(id) |
+------------+
|          0 |
|          1 |
|          0 |
+------------+

select ifnull(null, 15);
+------------------+
| ifnull(null, 15) |
+------------------+
| 15               |
+------------------+

-- 转换后GaussDB-Oracle SQL：
SELECT unisql.isnull(id) FROM t1;
isnull
------
 0
 1
 0

12.2.3. 字符串函数

12.2.3.1. LOCATE

语法: LOCATE (substr, str [, position])
描述: 返回子字符串第一次出现的位置。

参数解释

参数	说明
substr	需要查找的字串，该参数为字符串类型
str	需要被查找的父串，该参数为字符串类型
position	从父串中指定位置开始查找子串（初始值为1），该参数为整形类型，可选参数，不填时默认从父串启示位置开始查找子串

示例

-- 转换前MySQL SQL：
SELECT LOCATE('bar', 'foobarbar', 5);
+-------------------------------+
| LOCATE('bar', 'foobarbar', 5) |
+-------------------------------+
| 7                             |
+-------------------------------+

SELECT LOCATE('bar', 'foobarbar', 1);
+-------------------------------+
| LOCATE('bar', 'foobarbar', 1) |
+-------------------------------+
| 4                             |
+-------------------------------+

-- 转换后GaussDB-Oracle SQL：
SELECT instr('foobarbar', 'bar', 5);
instr
-------
   7

SELECT instr('foobarbar', 'bar', 1);
instr
-------
   4

12.2.3.2. CONVERT

语法: CONVERT (expr, type)

CONVERT (column_name using encoding_format)
描述: 将expr转换为指定的数据类型。

将列数据转换为指定的编码类型。

参数解释

参数	说明
expr	需要被转换类型的值。
type	指定转换的类型，该参数支持singed、unsigned、decimal、float、date、char 数据类型
column_name	列名
encoding_format	指定的编码格式，目前支持utf8，gbk

警告

MySQL与Gaussdb对于char类型在通过cast转换时行为不一致: MySQL类型转换时认为char类型即表示为长字符串类型，而在GaussDB类型转换中认为char类型仅表示单字节字符;

使用cast将值转为singed,值如果是字符那么必须是整型;

使用CONVERT将值转为unsinged,值必须是正整形、正整形字符串和正浮点型，且其值小于等于2^64 - 1;如果值为负数、浮点数字符串和值超过2^64 - 1，源库和目标库表现不一致。

使用CONVERT将列数据转换为指定的编码类型，不支持列的类型有bit、bytea

-- 转换前MySQL SQL：
select convert(123, signed);
+----------------------+
| convert(123, signed) |
+----------------------+
| 123                  |
+----------------------+

select convert('this is a testdb', char);
+-----------------------------------+
| convert('this is a testdb', char) |
+-----------------------------------+
| this is a testdb                  |
+-----------------------------------+

SELECT CONVERT(CAST('2024-08-12' AS CHAR), char) AS converted_result;
+------------------+
| converted_result |
+------------------+
| 2024-08-12       |
+------------------+

SELECT CONVERT(CAST('2024-08-12' AS CHAR(20)), char) AS converted_result;
+------------------+
| converted_result |
+------------------+
| 2024-08-12       |
+------------------+

SELECT convert('1.005',double);
 convert('1.005',double)|
 -----------------------+
                   1.005|

SELECT convert('312',UNSIGNED),convert(0.123,UNSIGNED),convert('18446744073709551615',UNSIGNED);
convert('312',UNSIGNED)|convert(0.123,UNSIGNED)|convert('18446744073709551615',UNSIGNED)|
-----------------------+-----------------------+----------------------------------------+
                    312|                      0|                    18446744073709551615|

WITH cte AS (
 SELECT 1 AS id, 'unisql_test1' AS unisql_name
 UNION ALL
 SELECT 2 AS id, 'unisql_test2' AS unisql_name
 UNION ALL
 SELECT 3 AS id, 'unisql_test3' AS unisql_name
 UNION ALL
 SELECT 4 AS id, 'unisql_test4' AS unisql_name
)
SELECT id, unisql_name
FROM cte
ORDER BY CONVERT(unisql_name USING gbk);
id|unisql_name |
--+------------+
1|unisql_test1|
2|unisql_test2|
3|unisql_test3|
4|unisql_test4|

-- 转换后GaussDB-Oracle SQL：
SELECT CAST(123 AS signed);
int8
------
123

SELECT CAST('this is a testdb' AS varchar);
   varchar
------------------
this is a testdb

SELECT CAST(CAST('2024-08-12' AS char) AS varchar) AS converted_result;
converted_result
------------------
2

SELECT CAST(CAST('2024-08-12' AS char(20)) AS varchar) AS converted_result;
converted_result
------------------
2024-08-12

SELECT CAST('1.005' AS number)
 numeric|
 -------+
   1.005|

SELECT CAST('312' AS decimal(20,0)),CAST(0.123 AS decimal(20,0)),CAST('18446744073709551615' AS decimal(20,0))
numeric|numeric|numeric             |
-------+-------+--------------------+
    312|      0|18446744073709551615|

WITH RECURSIVE cte AS
(SELECT 1 AS id,'unisql_test1' AS unisql_name
UNION ALL SELECT 2 AS id,'unisql_test2' AS unisql_name
UNION ALL SELECT 3 AS id,'unisql_test3' AS unisql_name
UNION ALL SELECT 4 AS id,'unisql_test4' AS unisql_name)
SELECT id,unisql_name FROM cte ORDER BY convert_to(unisql_name, 'gbk')
id|unisql_name |
--+------------+
1|unisql_test1|
2|unisql_test2|
3|unisql_test3|
4|unisql_test4|

12.2.3.3. CAST

语法: CAST (expr AS type)
描述: 将expr转换为指定的数据类型。

参数解释

参数	说明
expr	需要被转换类型的值。
type	指定转换的类型，该参数支持unsigned数据类型

警告

使用CAST将值转为unsinged,值必须是正整形、正整形字符串和正浮点型，且其值小于等于2^64 - 1;如果值为负数、浮点数字符串和值超过2^64 - 1，源库和目标库表现不一致。

示例

-- 转换前MySQL SQL：
SELECT cast('312' as UNSIGNED),cast(0.123 as UNSIGNED),cast('18446744073709551615' as UNSIGNED);
cast('312' as UNSIGNED)|cast(0.123 as UNSIGNED)|cast('18446744073709551615' as UNSIGNED)|
-----------------------+-----------------------+----------------------------------------+
                    312|                      0|                    18446744073709551615|

-- 转换后GaussDB-Oracle SQL：
SELECT CAST('312' AS decimal(20,0)),CAST(0.123 AS decimal(20,0)),CAST('18446744073709551615' AS decimal(20,0))
numeric|numeric|numeric             |
-------+-------+--------------------+
    312|      0|18446744073709551615|

12.2.3.4. CONCAT

语法: CONCAT (str1, str2, ...)
描述: 将入参字符串拼接在一起。

参数解释

参数	说明
str	需要拼接的字符串，该参数为字符串数据类型

示例

-- 转换前MySQL SQL：
select concat('123', 'abcAA', '你好');
+--------------------------------+
| concat('123', 'abcAA', '你好') |
+--------------------------------+
| 123abcAA你好                   |
+--------------------------------+

select concat('123abc');
+------------------+
| concat('123abc') |
+------------------+
| 123abc           |
+------------------+

-- 转换后GaussDB-Oracle SQL：
SELECT concat('123', 'abcAA', '你好');
   concat
--------------
123abcAA你好

SELECT concat('123abc');
concat
--------
123abc

12.2.3.5. GROUP_CONCAT

语法: GROUP_CONCAT([DISTINCT] column_name… [ORDER BY ASC/DESC column_name] [Separator sep_str])
描述: 将来自多个行的列值组合成一个单独的字符串，每个值之间可以用分隔符隔开。

参数解释

参数	说明
column_name	需要拼接的字符串列，该参数为字符串数据类型
sep_str	分割标识符

警告

和 group by 使用时拼接顺序和oracle库中不完全一致；行展示顺序不一致，建议使用该函数时根据列名进行排序；存在表达式计算时精度、标度和oracle不完全一致；暂时不支持和keep、over联合使用；和聚合函数使用时不支持嵌套使用。

示例

create table test_group_concat(id int, age int);
INSERT INTO test_group_concat (id, age) VALUES (1, 20);
INSERT INTO test_group_concat (id, age) VALUES (1, 20);
INSERT INTO test_group_concat (id, age) VALUES (1, 10);
INSERT INTO test_group_concat (id, age) VALUES (3, 30);
INSERT INTO test_group_concat (id, age) VALUES (3, 40);
INSERT INTO test_group_concat (id, age) VALUES (3, 40);
INSERT INTO test_group_concat (id, age) VALUES (4, 50);
INSERT INTO test_group_concat (id, age) VALUES (4, 60);

-- 转换前MySQL SQL：
select id, group_concat(age) from test_group_concat group by id;
+----+-------------------+
| id | group_concat(age) |
+----+-------------------+
|  1 | 20,20,10          |
|  3 | 30,40,40          |
|  4 | 50,60             |
+----+-------------------+

select group_concat(age) from test_group_concat;
+-------------------------+
| group_concat(age)       |
+-------------------------+
| 20,20,10,30,40,40,50,60 |
+-------------------------+

select group_concat(distinct age order by age desc separator ':') from test_group_concat;
+------------------------------------------------------------+
| group_concat(distinct age order by age desc separator ':') |
+------------------------------------------------------------+
| 60:50:40:30:20:10                                          |
+------------------------------------------------------------+

-- 转换后GaussDB-Oracle SQL：
select id, group_concat(age) from test_group_concat group by id;
id | group_concat
----+--------------
1 | 20,20,10
4 | 50,60
3 | 30,40,40

SELECT string_agg(age, ',') FROM test_group_concat;
      string_agg
-------------------------
20,20,10,30,40,40,50,60

SELECT string_agg(DISTINCT age, ':') FROM test_group_concat;
 string_agg
-------------------
10:20:30:40:50:60

12.2.4. 其他函数

12.2.4.1. COMPRESS

语法: compress (plaintext)
描述: 压缩字符串并返回二进制数据。

参数解释

参数	说明
plaintext	需要压缩的明文，该参数为字符串类型

示例

-- 转换前MySQL SQL：
select compress('123abc你好');
+----------------------------------------------------+
| compress('123abc你好')                             |
+----------------------------------------------------+
| 0x0C000000789C3334324E4C4A7EB277C1D3A57B011FE90645 |
+----------------------------------------------------+

-- 转换后GaussDB-Oracle SQL：
SELECT unisql.compress('123abc你好');
            compress
--------------------------------
123abc\344\275\240\345\245\275

12.2.4.2. UNCOMPRESS

语法: uncompress (ciphertext)
描述: 解压由compress()函数压缩的二进制数据，并恢复原始字符串。

参数解释

参数	说明
ciphertext	需要解压缩的密文，该参数为二进制类型bytea。

示例

-- 转换前MySQL SQL：
select uncompress(compress('123abc你好'));
+------------------------------------+
| uncompress(compress('123abc你好')) |
+------------------------------------+
| 0x313233616263E4BDA0E5A5BD         |
+------------------------------------+

-- 转换后GaussDB-Oracle SQL：
SELECT unisql.uncompress(unisql.compress('123abc你好'));
         uncompress
--------------------------------
123abc\344\275\240\345\245\275

12.2.4.3. LAST_INSERT_ID

语法: LAST_INSERT_ID ()
描述: 用于获取最后一次插入操作中自动生成的自增类型值。

示例

-- 转换前MySQL SQL：
create table t1(id int primary key auto_increment, co1 int);
insert into t1(co1) values(12), (23);
select * from t1;
+-----+-----+
| id  | co1 |
+-----+-----+
|| 1  || 12 |
|| 2  || 23 |
+-----+-----+

select last_insert_id();
+------------------+
| last_insert_id() |
+------------------+
| 1                |
+------------------+

-- 转换后GaussDB-Oracle SQL：
CREATE TABLE t1 (id serial PRIMARY KEY,co1 int);
insert into t1(co1) values(12), (23);
select * from t1;
id | co1
----+-----
1 |  12
2 |  23

SELECT lastval();
lastval
---------
      2

警告

mysql中的last_insert_id函数在单行或者多行插入时只返回第一行id，gaussdb中使用lastval函数替换last_insert_id且始终返回最后一次序列的值,所以仅在单行数据插入时mysql和gaussdb_oracle保持一致。

12.2.4.4. UUID

语法: UUID ()
描述: 用于生成一个唯一的标识符（UUID）,保证在空间和时间上的唯一性

示例

-- 转换前MySQL SQL：
select uuid();
+--------------------------------------+
| uuid()                               |
+--------------------------------------+
| 664c5710-5ba0-11ef-a608-005056c00001 |
+--------------------------------------+

-- 转换后GaussDB-Oracle SQL：
SELECT unisql.uuid();
uuid()
--------------------------------------
 664c5710-5ba0-11ef-a608-005056c00001

12.2.4.5. CURRENT_TIME

语法: CURRENT_TIME
描述: 用于获取当前时间,精确到秒

警告

当前转换结果范围为年月日时分秒，mysql为时分秒，这个点不一致

示例

-- 转换前MySQL SQL：
select CURRENT_TIME;
+--------------------+
| CURRENT_TIME       |
+--------------------+
| 17:08:05           |
+--------------------+

-- 转换后GaussDB-Oracle SQL：
SELECT sysdate;
   sysdate
---------------------------
2024-08-23 17:10:22