| title | summary |
|---|---|
SHOW IMPORT |
TiDB 数据库中 SHOW IMPORT 的使用概况。 |
SHOW IMPORT 语句用于显示 TiDB 中已经创建的 IMPORT 任务。该语句只能显示由当前用户创建的任务。
- 对于
SHOW IMPORT JOBS语句，如果用户有SUPER权限，则可以看到所有 job，否则只能看到当前用户创建的 job。 - 对于
SHOW IMPORT JOB <job-id>，只有 job 创建者或者拥有SUPER权限的用户才可以查看。
ShowImportJobsStmt ::=
'SHOW' 'IMPORT' 'JOBS'
ShowImportJobStmt ::=
'SHOW' 'IMPORT' 'JOB' JobID
SHOW IMPORT 语句输出结果的字段含义如下:
| 列名 | 说明 |
|---|---|
| Job_ID | 任务 ID |
| Data_Source | 数据源信息 |
| Target_Table | 目标表 |
| Phase | 表示任务当前所处的阶段，导入过程分为 importing、validating、add-index 等阶段 |
| Status | 表示当前任务的状态。有以下几种状态：pending 表示任务已创建但还未开始运行；running 表示运行中；canceled 表示已经取消的任务；failed 表示任务失败并退出；finished 表示任务已完成。 |
| Source_File_Size | 源文件大小 |
| Imported_Rows | 已经读到并写入目标表的数据行数 |
| Result_Message | 如果导入失败，则返回错误信息，否则为空。 |
| Create_Time | 任务创建时间 |
| Start_Time | 任务启动时间 |
| End_Time | 任务结束时间 |
| Created_By | 创建该任务的数据库用户名 |
SHOW IMPORT JOBS;+--------+-------------------+--------------+----------+-------+----------+------------------+---------------+----------------+----------------------------+----------------------------+----------------------------+------------+
| Job_ID | Data_Source | Target_Table | Table_ID | Phase | Status | Source_File_Size | Imported_Rows | Result_Message | Create_Time | Start_Time | End_Time | Created_By |
+--------+-------------------+--------------+----------+-------+----------+------------------+---------------+----------------+----------------------------+----------------------------+----------------------------+------------+
| 1 | /path/to/file.csv | `test`.`foo` | 116 | | finished | 11GB | 950000 | | 2023-06-26 11:23:59.281257 | 2023-06-26 11:23:59.484932 | 2023-06-26 13:04:30.622952 | root@% |
| 2 | /path/to/file.csv | `test`.`bar` | 130 | | finished | 1.194TB | 49995000 | | 2023-06-26 15:42:45.079237 | 2023-06-26 15:42:45.388108 | 2023-06-26 17:29:43.023568 | root@% |
+--------+-------------------+--------------+----------+-------+----------+------------------+---------------+----------------+----------------------------+----------------------------+----------------------------+------------+
1 row in set (0.01 sec)
SHOW IMPORT JOB 60001;+--------+--------------------+--------------+----------+-------+---------+------------------+---------------+----------------+----------------------------+------------+----------+------------+
| Job_ID | Data_Source | Target_Table | Table_ID | Phase | Status | Source_File_Size | Imported_Rows | Result_Message | Create_Time | Start_Time | End_Time | Created_By |
+--------+--------------------+--------------+----------+-------+---------+------------------+---------------+----------------+----------------------------+------------+----------+------------+
| 60001 | /path/to/small.csv | `test`.`t` | 361 | | pending | 16B | NULL | | 2023-06-08 15:59:37.047703 | NULL | NULL | root@% |
+--------+--------------------+--------------+----------+-------+---------+------------------+---------------+----------------+----------------------------+------------+----------+------------+
1 row in set (0.01 sec)
该语句是 TiDB 对 MySQL 语法的扩展。