SHOW IMPORT

SHOW IMPORT 语句用于显示 TiDB 中已经创建的 IMPORT 任务。该语句只能显示由当前用户创建的任务。

所需权限

  • 对于 SHOW IMPORT JOBS 语句,如果用户有 SUPER 权限,则可以看到所有 job,否则只能看到当前用户创建的 job。
  • 对于 SHOW IMPORT JOB <job-id>,只有 job 创建者或者拥有 SUPER 权限的用户才可以查看。

语法图

ShowImportJobsStmt
SHOWIMPORTJOBS
ShowImportJobStmt
SHOWIMPORTJOBJobID

SHOW IMPORT 语句输出结果的字段含义如下:

列名说明
Job_ID任务 ID
Data_Source数据源信息
Target_Table目标表
Phase表示任务当前所处的阶段,导入过程分为 importingvalidatingadd-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)

MySQL 兼容性

该语句是 TiDB 对 MySQL 语法的扩展。

另请参阅