信息函数
TiDB 支持使用 MySQL 8.0 中提供的大部分信息函数。
TiDB 支持的 MySQL 信息函数
函数名 | 功能描述 |
---|---|
BENCHMARK() | 循环执行一个表达式 |
CONNECTION_ID() | 返回当前连接的连接 ID(线程 ID) |
CURRENT_ROLE() | 返回当前连接的角色 |
CURRENT_USER() , CURRENT_USER | 返回当前用户的用户名和主机名 |
DATABASE() | 返回默认(当前)的数据库 |
FOUND_ROWS() | 该函数对于一个包含 LIMIT 的 SELECT 查询语句,返回在不包含 LIMIT 的情况下的记录数 |
LAST_INSERT_ID() | 返回上一条 INSERT 语句中自增列的值 |
ROW_COUNT() | 影响的行数 |
SCHEMA() | 与 DATABASE() 同义 |
SESSION_USER() | 与 USER() 同义 |
SYSTEM_USER() | 与 USER() 同义 |
USER() | 返回客户端提供的用户名和主机名 |
VERSION() | 返回当前 MySQL 服务器的版本信息 |
BENCHMARK()
BENCHMARK()
函数可以按照指定的次数重复执行给定的表达式。
语法:
BENCHMARK(count, expression)
count
:要执行表达式的次数。expression
:要重复执行的表达式。
示例:
SELECT BENCHMARK(5, SLEEP(2));
+------------------------+
| BENCHMARK(5, SLEEP(2)) |
+------------------------+
| 0 |
+------------------------+
1 row in set (10.00 sec)
CONNECTION_ID()
CONNECTION_ID()
函数返回连接的 ID。根据 TiDB 的 enable-32bits-connection-id
配置项的值不同,该函数将返回一个 32 位或 64 位的连接 ID。
如果启用了 enable-global-kill
,连接的 ID 可用于在同一集群的多个 TiDB 实例中终止查询。
SELECT CONNECTION_ID();
+-----------------+
| CONNECTION_ID() |
+-----------------+
| 322961414 |
+-----------------+
1 row in set (0.00 sec)
CURRENT_ROLE()
CURRENT_ROLE()
函数返回当前会话的当前角色。
SELECT CURRENT_ROLE();
+----------------+
| CURRENT_ROLE() |
+----------------+
| NONE |
+----------------+
1 row in set (0.00 sec)
CURRENT_USER()
CURRENT_USER()
函数返回当前会话中使用的账户。
SELECT CURRENT_USER();
+----------------+
| CURRENT_USER() |
+----------------+
| root@% |
+----------------+
1 row in set (0.00 sec)
DATABASE()
DATABASE()
函数返回当前会话正在使用的数据库名。
SELECT DATABASE();
+------------+
| DATABASE() |
+------------+
| test |
+------------+
1 row in set (0.00 sec)
FOUND_ROWS()
FOUND_ROWS()
函数返回上一条执行的 SELECT
语句的结果集中的行数。
SELECT 1 UNION ALL SELECT 2;
+------+
| 1 |
+------+
| 2 |
| 1 |
+------+
2 rows in set (0.01 sec)
SELECT FOUND_ROWS();
+--------------+
| FOUND_ROWS() |
+--------------+
| 2 |
+--------------+
1 row in set (0.00 sec)
LAST_INSERT_ID()
LAST_INSERT_ID()
函数返回包含 AUTO_INCREMENT
或 AUTO_RANDOM
列的表中最后插入行的 ID。
CREATE TABLE t1(id SERIAL);
Query OK, 0 rows affected (0.17 sec)
INSERT INTO t1() VALUES();
Query OK, 1 row affected (0.03 sec)
INSERT INTO t1() VALUES();
Query OK, 1 row affected (0.00 sec)
SELECT LAST_INSERT_ID();
+------------------+
| LAST_INSERT_ID() |
+------------------+
| 3 |
+------------------+
1 row in set (0.00 sec)
TABLE t1;
+----+
| id |
+----+
| 1 |
| 3 |
+----+
2 rows in set (0.00 sec)
ROW_COUNT()
ROW_COUNT()
函数返回受影响的行数。
CREATE TABLE t1(id BIGINT UNSIGNED PRIMARY KEY AUTO_RANDOM);
Query OK, 0 rows affected, 1 warning (0.16 sec)
INSERT INTO t1() VALUES (),(),();
Query OK, 3 rows affected (0.02 sec)
Records: 3 Duplicates: 0 Warnings: 0
SELECT ROW_COUNT();
+-------------+
| ROW_COUNT() |
+-------------+
| 3 |
+-------------+
1 row in set (0.00 sec)
SCHEMA()
SCHEMA()
函数与 DATABASE()
同义。
SESSION_USER()
SESSION_USER()
函数与 USER()
同义。
SYSTEM_USER()
SYSTEM_USER()
函数与 USER()
同义。
USER()
USER()
函数返回当前连接的用户。该函数的输出可能与 CURRENT_USER()
的输出略有不同,因为 USER()
显示的是实际 IP 地址,而不是通配符。
SELECT USER(), CURRENT_USER();
+----------------+----------------+
| USER() | CURRENT_USER() |
+----------------+----------------+
| root@127.0.0.1 | root@% |
+----------------+----------------+
1 row in set (0.00 sec)
VERSION()
VERSION()
函数以与 MySQL 兼容的格式返回 TiDB 版本。如需获取更详细的版本信息,可以使用 TIDB_VERSION()
函数。
SELECT VERSION();
+--------------------+
| VERSION() |
+--------------------+
| 8.0.11-TiDB-v7.5.1 |
+--------------------+
1 row in set (0.00 sec)
SELECT TIDB_VERSION()\G
*************************** 1. row ***************************
TIDB_VERSION(): Release Version: v7.5.1
Edition: Community
Git Commit Hash: 7d16cc79e81bbf573124df3fd9351c26963f3e70
Git Branch: heads/refs/tags/v7.5.1
UTC Build Time: 2024-02-27 14:28:32
GoVersion: go1.21.6
Race Enabled: false
Check Table Before Drop: false
Store: tikv
1 row in set (0.00 sec)
以上示例来自 TiDB v7.5.1,它会将自身标识为 MySQL 8.0.11。
如需更改该函数返回的版本,可以修改 server-version
配置项。
TiDB 特有的信息函数
下列函数为 TiDB 中特有的信息函数,MySQL 中无对应的函数。
函数名 | 功能描述 |
---|---|
CURRENT_RESOURCE_GROUP() | 返回当前连接的资源组名 |
TiDB 不支持的信息函数
CHARSET()
COERCIBILITY()
COLLATION()
ICU_VERSION()
ROLES_GRAPHML()