18.4.5 用mysqlimport命令导入文本文件-MySQL从入门到精通(五)

当前位置:　首页>> 技术小册>> MySQL从入门到精通(五)

### 18.4.5 用mysqlimport命令导入文本文件

在MySQL的数据管理任务中，数据的导入与导出是一项基础而重要的技能。特别是在处理大量数据时，能够高效地通过命令行工具进行数据的批量导入可以极大地提升工作效率。`mysqlimport`是MySQL提供的一个非常实用的命令行工具，它专门用于从文本文件中导入数据到MySQL数据库的表中。相比于使用`LOAD DATA INFILE` SQL语句，`mysqlimport`提供了一种更为直接、简洁的命令行方式来完成相同的任务。本章节将详细介绍如何使用`mysqlimport`命令来导入文本文件到MySQL数据库中。

#### 18.4.5.1 mysqlimport命令概述

`mysqlimport`命令是MySQL的一个客户端程序，它允许用户从文件（通常是CSV或制表符分隔的文本文件）中导入数据到指定的数据库表中。该命令简化了数据导入过程，因为它自动处理了很多`LOAD DATA INFILE`命令中需要手动指定的选项，如字段分隔符、行结束符等。使用`mysqlimport`时，用户只需指定数据文件路径、目标数据库和表名即可。

#### 18.4.5.2 使用mysqlimport的基本语法

`mysqlimport`命令的基本语法如下：

```bash
mysqlimport [选项] 数据库名 文件名...
```

或者，为了指定MySQL服务器的其他参数（如主机名、用户名、密码等），可以使用`--`参数来分隔`mysqlimport`的选项和MySQL连接选项：

```bash
mysqlimport [mysqlimport选项] -- 数据库名 文件名... -u 用户名 -p
```

在执行命令时，系统会提示输入MySQL用户的密码。

#### 18.4.5.3 文本文件的准备

在使用`mysqlimport`之前，你需要确保你的文本文件格式与目标数据库表的结构相匹配。通常，文本文件的第一行（如果存在）会被视为列名（表头），但这取决于`mysqlimport`的`--ignore-lines`或`--fields-terminated-by`等选项的使用情况。如果文本文件不包含表头，则必须确保数据文件中的列顺序与表中定义的列顺序一致。

#### 18.4.5.4 常用的mysqlimport选项

- `--fields-terminated-by=字符`：指定字段之间的分隔符，默认为制表符`\t`。
- `--fields-enclosed-by=字符`：指定字段值被包围的字符，常用于引号。
- `--fields-optionally-enclosed-by=字符`：类似`--fields-enclosed-by`，但字段值周围的包围字符是可选的。
- `--fields-escaped-by=字符`：指定转义字符，默认为`\`。
- `--lines-terminated-by=字符`：指定记录之间的分隔符，默认为换行符`\n`。
- `--ignore-lines=N`：忽略文件开头的N行数据，常用于跳过表头。
- `--columns=列名列表`：指定要导入的列，以逗号分隔。
- `--local`：如果数据文件在客户端机器上，使用此选项告诉`mysqlimport`通过客户端程序将数据发送给服务器，而不是直接在服务器上查找文件。

#### 18.4.5.5 示例

假设我们有一个名为`employees.csv`的CSV文件，其内容格式如下（第一行为表头）：

```csv
id,name,age,department
1,John Doe,30,IT
2,Jane Smith,25,HR
...
```

我们想要将这个文件导入到名为`employees`的表中，该表已经存在于`mydatabase`数据库中。

首先，确保MySQL服务正在运行，并且你有足够的权限来导入数据。

然后，打开命令行工具，执行以下命令：

```bash
mysqlimport --fields-terminated-by=, --ignore-lines=1 --local mydatabase employees.csv
```

这个命令做了以下几件事：

- `--fields-terminated-by=,` 指定了字段分隔符为逗号。
- `--ignore-lines=1` 忽略了文件的第一行，即表头。
- `--local` 表示`employees.csv`文件位于客户端机器上，而不是MySQL服务器上。
- `mydatabase` 是目标数据库名。
- `employees.csv` 是要导入的数据文件。

执行后，如果一切顺利，你将看到MySQL的导入进度和结果，包括导入了多少行数据等信息。

#### 18.4.5.6 注意事项

- 确保MySQL用户有足够的权限来向目标数据库表中插入数据。
- 如果数据文件中包含特殊字符（如换行符、引号等），可能需要使用`--fields-enclosed-by`或`--fields-escaped-by`选项来正确解析。
- 如果目标表不存在，`mysqlimport`不会自动创建表。你需要先使用`CREATE TABLE`语句创建表。
- 对于大文件的导入，考虑使用MySQL的批量插入优化技术，如调整`bulk_insert_buffer_size`等系统变量。
- 如果在导入过程中遇到格式错误或数据类型不匹配的问题，MySQL会报错并停止导入。此时，需要检查数据文件的内容是否符合表的列定义。

#### 18.4.5.7 结论

`mysqlimport`命令是MySQL数据库管理中一个强大而灵活的工具，它允许用户通过简单的命令行操作批量导入文本文件中的数据。通过合理使用`mysqlimport`的选项，用户可以轻松应对各种复杂的数据导入需求，从而提高工作效率。在实际应用中，建议结合具体的数据文件格式和目标表结构，灵活选择和使用`mysqlimport`命令的选项，以达到最佳的数据导入效果。

该分类下的相关小册推荐：

MySQL从入门到精通(三)

MySQL从入门到精通(一)

SQL零基础到熟练应用(增删改查)

细说MySQL(零基础到高级应用)

MySQL必会核心问题

MySQL 实战 45 讲

MySQL从入门到精通(二)

MySQL8.0入门与实践

MySQL从入门到精通(四)