data import: add IMPORT INTO stmt (#14183)

Author: D3Hunter

TOC.md

@@ -708,6 +708,7 @@
       - [`BATCH`](/sql-statements/sql-statement-batch.md)
       - [`BEGIN`](/sql-statements/sql-statement-begin.md)
       - [`CALIBRATE RESOURCE`](/sql-statements/sql-statement-calibrate-resource.md)
+      - [`CANCEL IMPORT JOB`](/sql-statements/sql-statement-cancel-import-job.md)
       - [`CHANGE COLUMN`](/sql-statements/sql-statement-change-column.md)
       - [`CHANGE DRAINER`](/sql-statements/sql-statement-change-drainer.md)
       - [`CHANGE PUMP`](/sql-statements/sql-statement-change-pump.md)
@@ -751,6 +752,7 @@
       - [`FLUSH TABLES`](/sql-statements/sql-statement-flush-tables.md)
       - [`GRANT <privileges>`](/sql-statements/sql-statement-grant-privileges.md)
       - [`GRANT <role>`](/sql-statements/sql-statement-grant-role.md)
+      - [`IMPORT INTO`](/sql-statements/sql-statement-import-into.md)
       - [`INSERT`](/sql-statements/sql-statement-insert.md)
       - [`KILL [TIDB]`](/sql-statements/sql-statement-kill.md)
       - [`LOAD DATA`](/sql-statements/sql-statement-load-data.md)
@@ -797,6 +799,7 @@
       - [`SHOW ERRORS`](/sql-statements/sql-statement-show-errors.md)
       - [`SHOW [FULL] FIELDS FROM`](/sql-statements/sql-statement-show-fields-from.md)
       - [`SHOW GRANTS`](/sql-statements/sql-statement-show-grants.md)
+      - [`SHOW IMPORT JOB`](/sql-statements/sql-statement-show-import-job.md)
       - [`SHOW INDEX [FROM|IN]`](/sql-statements/sql-statement-show-index.md)
       - [`SHOW INDEXES [FROM|IN]`](/sql-statements/sql-statement-show-indexes.md)
       - [`SHOW KEYS [FROM|IN]`](/sql-statements/sql-statement-show-keys.md)

error-codes.md

@@ -299,23 +299,55 @@ TiDB 兼容 MySQL 的错误码，在大多数情况下，返回和 MySQL 一样
 
 * Error Number: 8156
 
-    `LOAD DATA` 语句的文件路径不能为空。需要设置正确的路径再进行导入。请参考 [`LOAD DATA`](/sql-statements/sql-statement-load-data.md)。
+    传入的文件路径不能为空。需要设置正确的路径再进行导入。
+
+* Error Number: 8157
+
+    不支持的文件格式。请参考 [`IMPORT INTO`](/sql-statements/sql-statement-import-into.md#format) 查看支持的格式。
 
 * Error Number: 8158
 
-    传入的 S3/GCS 路径无效。请参考[外部存储](/br/backup-and-restore-storages.md)设置有效的路径。
+    传入的文件路径不合法。请根据具体的错误提示进行处理。S3/GCS 路径设置可参考[外部存储](/br/backup-and-restore-storages.md#uri-格式)。
 
 * Error Number: 8159
 
-    TiDB 无法访问 `LOAD DATA` 语句中传入的 S3/GCS 路径。请确保填入的 S3/GCS bucket 存在，且你输入了正确的 access key 和 secret access key 以让 TiDB 服务器有权限访问 S3/GCS 对应的 bucket。
+    TiDB 无法访问传入的 S3/GCS 路径。请确保填写的 S3/GCS bucket 存在，且输入了正确的 Access Key 和 Secret Access Key 以让 TiDB 服务器有权限访问 S3/GCS 对应的 bucket。
 
 * Error Number: 8160
 
-    `LOAD DATA` 读取数据文件失败。请根据具体的错误提示进行处理。
+    读取数据文件失败。请根据具体的错误提示进行处理。
 
 * Error Number: 8162
 
-    `LOAD DATA` 语句存在错误。请参考 [`LOAD DATA`](/sql-statements/sql-statement-load-data.md) 查看已支持的功能。
+    语句存在错误。请根据具体的错误提示进行处理。
+
+* Error Number: 8163
+
+    未知的选项。请参考 [`IMPORT INTO`](/sql-statements/sql-statement-import-into.md#参数说明) 查看支持的选项。
+
+* Error Number: 8164
+
+    选项取值无效。请参考 [`IMPORT INTO`](/sql-statements/sql-statement-import-into.md#参数说明) 查看有效的取值。
+
+* Error Number: 8165
+
+    重复指定了选项，每个选项只能指定一次。
+
+* Error Number: 8166
+
+    某些选项只能在特定的条件下才可以使用。请根据具体的错误提示进行处理。请参考 [`IMPORT INTO`](/sql-statements/sql-statement-import-into.md#参数说明) 查看支持的选项。
+
+* Error Number: 8170
+
+    指定的 job 不存在。
+
+* Error Number: 8171
+
+    该 job 的状态不能进行当前操作。请根据具体的错误提示进行处理。
+
+* Error Number: 8173
+
+    执行 `IMPORT INTO` 时，TiDB 会对当前环境进行检查，比如检查下游表是否为空等。请根据具体的错误提示进行处理。
 
 * Error Number: 8200
 

mysql-schema.md

@@ -72,3 +72,4 @@ aliases: ['/docs-cn/dev/system-tables/system-table-overview/','/docs-cn/dev/refe
 * `expr_pushdown_blacklist` 表达式下推的黑名单
 * `opt_rule_blacklist` 逻辑优化规则的黑名单
 * `table_cache_meta` 缓存表的信息
+* `tidb_import_jobs` 记录 [`IMPORT INTO`](/sql-statements/sql-statement-import-into.md) 任务信息

privilege-management.md

@@ -342,6 +342,10 @@ SELECT * FROM INFORMATION_SCHEMA.USER_PRIVILEGES WHERE grantee = "'root'@'%'";
 
 需要拥有 `SUPER` 或者 `BACKUP_ADMIN` 权限。
 
+### CANCEL IMPORT JOB
+
+需要 `SUPER` 权限来取消属于其他用户的任务，否则只能取消当前用户创建的任务。
+
 ### CREATE DATABASE
 
 需要拥有全局 `CREATE` 权限。
@@ -374,6 +378,10 @@ SELECT * FROM INFORMATION_SCHEMA.USER_PRIVILEGES WHERE grantee = "'root'@'%'";
 
 需要对所操作的表拥有 `DROP` 权限。
 
+### IMPORT INTO
+
+需要对目标表拥有 `SELECT`、`UPDATE`、`INSERT`、`DELETE` 和 `ALTER` 权限。如果是导入存储在 TiDB 本地的文件，还需要有 `FILE` 权限。
+
 ### LOAD DATA
 
 `LOAD DATA` 需要对所操作的表拥有 `INSERT` 权限。执行 `REPLACE INTO` 语句还需要对所操作的表拥有 `DELETE` 权限。
@@ -400,6 +408,8 @@ SELECT * FROM INFORMATION_SCHEMA.USER_PRIVILEGES WHERE grantee = "'root'@'%'";
 
 `SHOW PROCESSLIST` 需要 `SUPER` 权限来显示属于其他用户的连接。
 
+`SHOW IMPORT JOB` 需要 `SUPER` 权限来显示属于其他用户的任务，否则只能看到当前用户创建的任务。
+
 ### CREATE ROLE/USER
 
 `CREATE ROLE` 需要 `CREATE ROLE` 权限。

sql-statements/sql-statement-cancel-import-job.md

@@ -0,0 +1,42 @@
+---
+title: CANCEL IMPORT
+summary: TiDB 数据库中 CANCEL IMPORT 的使用概况。
+---
+
+# CANCEL IMPORT
+
+`CANCEL IMPORT` 语句用于取消 TiDB 中创建的数据导入任务。
+
+## 所需权限
+
+只有导入任务的创建者或拥有 `SUPER` 权限的用户才能够取消任务。
+
+## 语法图
+
+```ebnf+diagram
+CancelImportJobsStmt ::=
+    'CANCEL' 'IMPORT' 'JOB' JobID
+```
+
+## 示例
+
+下面示例取消 ID 为 1 的导入任务：
+
+```sql
+CANCEL IMPORT JOB 1;
+```
+
+输出结果如下：
+
+```
+Query OK, 0 rows affected (0.01 sec)
+```
+
+## MySQL 兼容性
+
+该语句是 TiDB 对 MySQL 语法的扩展。
+
+## 另请参阅
+
+* [`IMPORT INTO`](/sql-statements/sql-statement-import-into.md)
+* [`SHOW IMPORT JOB`](/sql-statements/sql-statement-show-import-job.md)