# 其他函数
#### ANY_VALUE
ANY_VALUE(ANY arg)
描述：返回每个分组中指定列的第一条数据。
返回值类型：任意类型
示例：
```
m_db=# CREATE TABLE t1 (c1 INT, c2 INT);
CREATE TABLE
m_db=# INSERT INTO t1 VALUES(1, NULL), (1, 18), (2, 17), (2, 22);
INSERT 0 4
m_db=# SELECT * FROM t1;
 c1 | c2
----+----
  1 |
  1 | 18
  2 | 17
  2 | 22
(4 rows)
m_db=# SELECT ANY_VALUE(c2) FROM t1 GROUP BY c1;
 any_value
-----------
        17
(2 rows)
m_db=# DROP TABLE t1;
```
#### BENCHMARK
BENCHMARK(INT count, expr)
描述：重复计算expr表达式count次，通过这种方式评估expr表达式的执行效率。正常场景下，函数的返回值始终为0，但可以根据客户端提示的执行时间控制BENCHMARK总共执行所消耗的时间。BENCHMARK函数只能测量数字表达式（scalar expression）的性能，表达式可以为一个子查询，但子查询返回的结果只能是单值。
返回值类型：INT
示例：
```
m_db=# CREATE TABLE employee (id INT PRIMARY KEY, name VARCHAR(20) NOT NULL, age INT DEFAULT 18);
NOTICE:  CREATE TABLE / PRIMARY KEY will create implicit index "employee_pkey" for table "employee"
CREATE TABLE
m_db=# INSERT INTO employee VALUES(2, 'Bob', 36),(3, 'John', 25),(5, 'Mary', 25),(4, 'Michael', 36),(1, 'Tom', 25);
INSERT 0 5
m_db=# \timing on
Timing is on.
m_db=# SELECT BENCHMARK(1000000, ABS(age)) FROM employee;
 benchmark 
-----------
         0
         0
         0
         0
         0
(5 rows)
Time: 2769.498 ms
m_db=# \timing off
Timing is off.
m_db=# DROP TABLE employee;
DROP TABLE
```
#### CHARSET
CHARSET(expr)
描述：返回指定的字符串的字符集。
入参类型：支持任意数据类型。
返回值类型：TEXT
示例：
```
mdb=# SELECT CHARSET('Gauss');
 charset 
---------
 utf8
(1 row)
mdb=# SELECT CHARSET(_BINARY'Gauss');
 charset 
---------
 binary
(1 row)
mdb=# SELECT CHARSET(123);
 charset 
---------
 binary
(1 row)
```
#### COLLATION
COLLATION (TEXT str)
描述：返回指定的字符串的排序规则。为了保持与MySQL行为一致，该函数的参数嵌套的SQL语句并不会实际执行。
返回值类型：TEXT
示例：
```
mdb=# SELECT COLLATION('Gauss');
     collation      
--------------------
 utf8mb4_general_ci
(1 row)
mdb=# SELECT COLLATION(_BINARY'Gauss');
 collation 
-----------
 binary
(1 row)
mdb=# SELECT COLLATION(_GBK'Gauss');
   collation    
----------------
 gbk_chinese_ci
(1 row)
```
#### CONNECTION_ID
CONNECTION_ID()
描述：返回当前连接的客户端会话id。
返回值类型：BIGINT UNSIGNED
示例：
```
m_db=# SELECT connection_id();
  connection_id  
-----------------
 140598681532160
(1 row)
```
#### CURRENT_USER
CURRENT_USER() \| CURRENT_USER
描述：返回当前客户端的鉴权用户的信息。
返回值类型：TEXT
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
此函数按照CURRENT_USER形式调用时（即直接调用"SELECT current_user;"）：当GUC参数m_format_behavior_compat_options值中包含'enable_samename_funcs'的情况下为M-Compatibility模式数据库实现行为，即当前实现行为；当GUC参数m_format_behavior_compat_options值中不包含'enable_samename_funcs'时，具体的实现行为请参见[系统信息函数](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0065.html)章节的内容介绍。
示例：
```
m_db=# SELECT CURRENT_USER;
 current_user
--------------
 oms
(1 row)
m_db=# SELECT CURRENT_USER();
 current_user
--------------
 oms
(1 row)
```
#### DATABASE
DATABASE()
描述：返回当前数据库（Schema）的名称。
返回值类型：TEXT
示例：
```
m_db=# SELECT DATABASE();
 database 
----------
 public
(1 row)
```
#### DEFAULT
DEFAULT(col_name)
描述：返回指定列col_name的默认值。如果col_name没有设置默认值且没有指定NOT NULL，则返回NULL；如果col_name无默认值且定义NOT NULL则报错。
返回值类型：任意类型
示例：
```
m_db=# CREATE TABLE employee (id INT PRIMARY KEY, name VARCHAR(20) NOT NULL, age INT DEFAULT 18);
NOTICE:  CREATE TABLE / PRIMARY KEY will create implicit index "employee_pkey" for table "employee"
CREATE TABLE
m_db=# INSERT INTO employee VALUES(2, 'Bob', 36),(3, 'John', 25),(5, 'Mary', 25),(4, 'Michael', 36),(1, 'Tom', 25);
INSERT 0 5
m_db=# SELECT DEFAULT(age) FROM employee;
 default 
---------
      18
      18
      18
      18
      18
(5 rows)
m_db=# DROP TABLE employee;
DROP TABLE
```
#### FOUND_ROWS
FOUND_ROWS()
描述：返回当前连接前一条查询语句执行结果的行数，当前一条查询语句使用SQL_CALC_FOUND_ROWS关键字时，前一条查询语句即使存在LIMIT子句，FOUND_ROWS函数也将返回所有行数，前一条语句不是SELECT形式的查询语句时，FOUND_ROWS函数的返回值是未定义的。
返回值类型：BIGINT
示例：
```
m_db=# CREATE TABLE employee (id INT PRIMARY KEY, name VARCHAR(20) NOT NULL, age INT);
NOTICE:  CREATE TABLE / PRIMARY KEY will create implicit index "employee_pkey" for table "employee"
CREATE TABLE
m_db=# INSERT INTO employee VALUES(2, 'Bob', 36),(3, 'John', 25),(5, 'Mary', 25),(4, 'Michael', 36),(1, 'Tom', 25);
INSERT 0 5
m_db=# SELECT * FROM employee;
 id |  name   | age 
----+---------+-----
  2 | Bob     |  36
  3 | John    |  25
  5 | Mary    |  25
  4 | Michael |  36
  1 | Tom     |  25
(5 rows)
m_db=# SELECT FOUND_ROWS();
 found_rows 
------------
          5
(1 row)
m_db=# SELECT * FROM employee LIMIT 3;
 id | name | age 
----+------+-----
  2 | Bob  |  36
  3 | John |  25
  5 | Mary |  25
(3 rows)
m_db=# SELECT FOUND_ROWS();
 found_rows 
------------
          3
(1 row)
m_db=# SELECT * FROM employee LIMIT 7;
 id |  name   | age 
----+---------+-----
  2 | Bob     |  36
  3 | John    |  25
  5 | Mary    |  25
  4 | Michael |  36
  1 | Tom     |  25
(5 rows)
m_db=# SELECT FOUND_ROWS();
 found_rows 
------------
          5
(1 row)
m_db=# SELECT SQL_CALC_FOUND_ROWS * FROM employee LIMIT 3;
 id | name | age 
----+------+-----
  2 | Bob  |  36
  3 | John |  25
  5 | Mary |  25
(3 rows)
m_db=# SELECT FOUND_ROWS();
 found_rows 
------------
          5
(1 row)
m_db=# DROP TABLE employee;
DROP TABLE
```
#### LAST_INSERT_ID
- last_insert_id() 描述：返回当前会话最近一次执行的INSERT语句中，成功插入AUTO_INCREMENT列的第一个自动生成的值。
  返回值类型：BIGINT UNSIGNED
  示例：
  ```
  m_db=# CREATE TABLE t1(c1 INT PRIMARY KEY, c2 INT AUTO_INCREMENT UNIQUE) AUTO_INCREMENT=10;
  NOTICE:  CREATE TABLE will create implicit sequence "t1_c2_seq" for serial column "t1.c2"
  NOTICE:  CREATE TABLE / PRIMARY KEY will create implicit index "t1_pkey" for table "t1"
  NOTICE:  CREATE TABLE / UNIQUE will create implicit index "t1_c2_key" for table "t1"
  CREATE TABLE
                                    ^
  m_db=# INSERT INTO t1(c1) VALUES(1), (2), (3);
  INSERT 0 3
  m_db=# SELECT last_insert_id();
   last_insert_id 
  ----------------
   10
  (1 row)
  m_db=# DROP TABLE t1;
  DROP TABLE
  ```
  

- last_insert_id(expr) 描述：将last_insert_id(expr)函数的返回值作为再次执行last_insert_id()函数的返回值进行返回。若expr为NULL，则last_insert_id(expr)返回NULL，再次执行last_insert_id()函数，返回值为0。
  返回值类型：BIGINT UNSIGNED
  示例：
  ```
  m_db=# SELECT last_insert_id(100);
   last_insert_id 
  ----------------
   100
  (1 row)
  m_db=# SELECT last_insert_id();
   last_insert_id 
  ----------------
   100
  (1 row)
  ```
  
 
#### ROW_COUNT
ROW_COUNT()
描述：返回上一条语句影响行数。对于DDL语句，直接返回0；除SELECT之外的DML语句，返回影响的实际行数，SELECT语句返回-1，其中SELECT INTO返回实际影响行数。
返回值类型：BIGINT
示例：
```
m_db=# CREATE TABLE employee (id INT PRIMARY KEY, name VARCHAR(20) NOT NULL, age INT);
NOTICE:  CREATE TABLE / PRIMARY KEY will create implicit index "employee_pkey" for table "employee"
CREATE TABLE
m_db=# INSERT INTO employee VALUES(2, 'Bob', 36),(3, 'John', 25),(5, 'Mary', 25),(4, 'Michael', 36),(1, 'Tom', 25);
INSERT 0 5
m_db=# SELECT ROW_COUNT();
 row_count 
-----------
         5
(1 row)
m_db=# UPDATE employee SET age=26 WHERE age=25;
UPDATE 3
m_db=# SELECT ROW_COUNT();
 row_count 
-----------
         3
(1 row)
m_db=# DELETE FROM employee WHERE age=36;
DELETE 2
m_db=# SELECT ROW_COUNT();
 row_count 
-----------
         2
(1 row)
m_db=# DROP TABLE employee;
DROP TABLE
```
#### SCHEMA
SCHEMA()
描述：返回当前Schema（数据库）的名称。
返回值类型：TEXT
示例：
```
m_db=# SELECT SCHEMA();
 schema
--------
 public
(1 row)
```
#### SLEEP
SLEEP(INT duration)
描述：使执行该函数的会话按照指定的秒数休眠。
返回值类型：BIGINT
示例：
```
m_db=# SELECT SLEEP(1);
 sleep 
-------
     0
(1 row)
```
 #### SYSTEM_USER
SYSTEM_USER()
描述：返回一个UTF8编码的字符串，该字符串内容包含当前客户端使用的当前账户的用户名和当前客户端主机的ip地址，格式为username@ip。
返回值类型：TEXT
示例：
```
m_db=# SELECT SYSTEM_USER();
  system_user  
---------------
 oms@localhost
(1 row)
```
#### USER
USER()
描述：SYSTEM_USER的同义函数，该函数的功能用法与[SYSTEM_USER]相同。
返回值类型：TEXT
示例：
```
m_db=# SELECT USER();
     user
---------------
 oms@localhost
(1 row)
```
#### UUID
UUID()
描述：返回一个根据RFC 4122、ISO/IEF 9834-8:2005以及相关标准定义的通用唯一标识符（UUID）。这个标识符是一个小写十六进制数字组成的字符串，该字符串由一组8位数字、三组4位数字和一组12位数字组成，总共32个数字代表128位。
返回值类型：VARCHAR
示例：
```
m_db=# SELECT UUID();
                 uuid                 
--------------------------------------
 b28d6aaa-7a3a-c03c-f812-fa163e6cc336
(1 row)
```
#### UUID_SHORT
UUID_SHORT()
描述：返回一个在一定条件下具有唯一性的短通用标识符。这个标识符是一个64位无符号类型的整数。
在满足下列条件时，返回的值是唯一的：
- 当前集群下的服务节点数不能超过256个。

- 不能在节点重新启动之间设置服务器主机的系统时间。

- 在节点重新启动之间平均每秒调用UUID_SHORT()少于1600万次。
返回值类型：UINT64
示例：
```
m_db=# SELECT UUID_SHORT();
      uuid_short      
----------------------
 13863614461119561729
(1 row)
```
