大网数据广告活动
数据库部署与 SQL 参考

TiDB 中文参考:SHOW IMPORT

· 52CE 我爱测

# SHOW IMPORT 语句用于显示 TiDB 中已经创建的 IMPORT 任务。该语句只能显示由当前用户创建的任务。 ## 所需权限 - 对于 语句,如果用户有 权限,则可以看到所有 job,否则只能看到当前用户创建的 job。 - 对于 ,只有 job 创建者或者拥有 权限的用户才可以查看。 ## 语法图 语句输出结果的字段含义如下: | 列名 | 说明 | |------------------|---------------

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)

MySQL 兼容性

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

另请参阅

本文来自 PingCAP / TiDB 文档贡献者,按 CC BY-SA 3.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
PingCAP / TiDB 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY-SA 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。