PingKai Logo下载
搜索

SHOW IMPORT

SHOW IMPORT 语句用于显示 TiDB 中已经创建的 IMPORT 任务。

所需权限

  • 任务创建者可以查看自己创建的任务。
  • 具有 SUPER 或 IMPORT_JOB_VIEW 权限的用户可以查看所有用户创建的任务，包括 SHOW IMPORT JOBS 返回的任务列表和 SHOW IMPORT JOB <job-id> 返回的指定任务。

IMPORT_JOB_VIEW 是全局动态只读权限，可以使用以下语句授予或收回：

GRANT IMPORT_JOB_VIEW ON *.* TO 'import_monitor'@'%';
REVOKE IMPORT_JOB_VIEW ON *.* FROM 'import_monitor'@'%';

授权结果可通过 SHOW GRANTS 查看。也可以将该权限授予角色；角色启用后，用户即可查看所有导入任务。

IMPORT_JOB_VIEW 不授予执行 IMPORT INTO 或取消其他用户任务的能力。取消任务仍仅允许任务创建者或具有 SUPER 权限的用户执行。

注意

导入任务信息可能包含数据源位置、目标库表、源文件大小、任务状态和失败原因。请仅向确有运维、监控或巡检需求的账号授予 IMPORT_JOB_VIEW。

语法图

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)

MySQL 兼容性

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

另请参阅