情報機能

TiDB は、MySQL 8.0 で利用可能な情報関数ほとんどをサポートしています。

TiDB がサポートする MySQL関数

ベンチマーク（）

BENCHMARK()関数は、指定された回数、指定された式を実行します。

構文：

BENCHMARK(count, expression)

• count : 式を実行する回数。
• expression : 繰り返し実行される式。

例：

SELECT BENCHMARK(5, SLEEP(2));

+------------------------+
| BENCHMARK(5, SLEEP(2)) |
+------------------------+
|                      0 |
+------------------------+
1 row in set (10.00 sec)

接続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()関数は、現在のセッションの現在の役割返します。

SELECT CURRENT_ROLE();

+----------------+
| CURRENT_ROLE() |
+----------------+
| NONE           |
+----------------+
1 row in set (0.00 sec)

現在のユーザー()

CURRENT_USER()関数は、現在のセッションで使用されているアカウントを返します。

SELECT CURRENT_USER();

+----------------+
| CURRENT_USER() |
+----------------+
| root@%         |
+----------------+
1 row in set (0.00 sec)

データベース()

DATABASE()関数は、現在のセッションで使用されているデータベース スキーマを返します。

SELECT DATABASE();

+------------+
| DATABASE() |
+------------+
| test       |
+------------+
1 row in set (0.00 sec)

見つかった行()

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)

注記：

クエリ修飾子SQL_CALC_FOUND_ROWS 、クエリ修飾子LIMITを考慮せずに結果セットの合計行数を計算しますが、クエリ修飾子tidb_enable_noop_functions有効な場合にのみ使用できます。このクエリ修飾子は、MySQL 8.0.17 以降では非推奨です。代わりにクエリ修飾子COUNT(*)使用することをお勧めします。

最終挿入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)

注記

• TiDBでは、 AUTO_ID_CACHE指定するとMySQLが返す結果と異なる結果になる可能性があります。この不一致は、TiDBが各ノードにIDをキャッシュするため、IDの順序が乱れたり、IDに空白が生じたりする可能性があるためです。アプリケーションで厳密なID順序の維持が不可欠な場合は、 MySQL互換モード有効にすることができます。

• 上の例ではIDが2ずつ増加しますが、MySQLでは同じシナリオでIDが1ずつ増加します。互換性に関する詳細は自動増分ID参照してください。

LAST_INSERT_ID(expr)関数は式を引数として受け取り、その値をLAST_INSERT_ID()次回呼び出し時に保存します。MySQL互換のシーケンス生成メソッドとして使用できます。TiDBはシーケンス関数もサポートしています。

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()関数はDATABASE()の同義語です。

セッションユーザー()

SESSION_USER()関数はUSER()の同義語です。

SYSTEM_USER()

SYSTEM_USER()関数はUSER()の同義語です。

ユーザー（）

USER()関数は現在の接続のユーザーを返します。5 USER()ワイルドカードではなく実際のIPアドレスを表示するため、 CURRENT_USER()の出力とは若干異なる場合があります。

SELECT USER(), CURRENT_USER();

+----------------+----------------+
| USER()         | CURRENT_USER() |
+----------------+----------------+
| root@127.0.0.1 | root@%         |
+----------------+----------------+
1 row in set (0.00 sec)

バージョン()

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)

上記の例は、MySQL 8.0.11 として識別される TiDB v7.5.1 からのものです。

TiDB固有の関数

次の関数は TiDB でのみサポートされており、MySQL には同等の関数はありません。

サポートされていない関数

• CHARSET()
• COERCIBILITY()
• COLLATION()
• ICU_VERSION()
• ROLES_GRAPHML()