SHOW IMPORT

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

所需权限

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

语法图

ShowImportJobsStmt

SHOW IMPORT JOB - 图1

ShowImportJobStmt

SHOW IMPORT JOB - 图2

  1. ShowImportJobsStmt ::=
  2.     'SHOW' 'IMPORT' 'JOBS'
  4. ShowImportJobStmt ::=
  5.     '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创建该任务的数据库用户名

示例

  1. SHOW IMPORT JOBS;
  1. +--------+-------------------+--------------+----------+-------+----------+------------------+---------------+----------------+----------------------------+----------------------------+----------------------------+------------+
  2. | 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 |
  3. +--------+-------------------+--------------+----------+-------+----------+------------------+---------------+----------------+----------------------------+----------------------------+----------------------------+------------+
  4. |      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@%     |
  5. |      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@%     |
  6. +--------+-------------------+--------------+----------+-------+----------+------------------+---------------+----------------+----------------------------+----------------------------+----------------------------+------------+
  7. 1 row in set (0.01 sec)
  1. SHOW IMPORT JOB 60001;
  1. +--------+--------------------+--------------+----------+-------+---------+------------------+---------------+----------------+----------------------------+------------+----------+------------+
  2. | 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 |
  3. +--------+--------------------+--------------+----------+-------+---------+------------------+---------------+----------------+----------------------------+------------+----------+------------+
  4. |  60001 | /path/to/small.csv | `test`.`t`   |      361 |       | pending | 16B              |          NULL |                | 2023-06-08 15:59:37.047703 | NULL       | NULL     | root@%     |
  5. +--------+--------------------+--------------+----------+-------+---------+------------------+---------------+----------------+----------------------------+------------+----------+------------+
  6. 1 row in set (0.01 sec)

MySQL 兼容性

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

另请参阅