### 4.5.5 mysqlimport——一个数据导入程序

[](<>)[](<>)[](<>)[](<>)[](<>)

这[**mysql导入**](mysqlimport.html)客户端提供了一个命令行界面[`加载数据`](load-data.html)SQL 语句。大多数选项[**mysql导入**](mysqlimport.html)直接对应于[`加载数据`](load-data.html)句法。看[第 13.2.7 节，“加载数据语句”](load-data.html).

调用[**mysql导入**](mysqlimport.html)像这样：

```
mysqlimport [options] db_name textfile1 [textfile2 ...]
```

对于命令行中命名的每个文本文件，[**mysql导入**](mysqlimport.html)从文件名中删除任何扩展名，并使用结果来确定要将文件内容导入到的表的名称。例如，文件名为`病人.txt`,`患者文本`， 和`病人`all 将被导入一个名为`病人`.

[**mysql导入**](mysqlimport.html)支持以下选项，可以在命令行中指定，也可以在`[mysql导入]`和`[客户]`选项文件的组。有关 MySQL 程序使用的选项文件的信息，请参阅[第 4.2.2.2 节，“使用选项文件”](option-files.html).

[](<>)

**表 4.15 mysqlimport 选项**

| 选项名称 | 描述 | 介绍 | 已弃用 |
| ---- | --- | --- | --- |
| [--绑定地址](mysqlimport.html#option_mysqlimport_bind-address) | 使用指定的网络接口连接 MySQL Server |  |  |
| [--列](mysqlimport.html#option_mysqlimport_columns) | 此选项采用逗号分隔的列名列表作为其值 |  |  |
| [--压缩](mysqlimport.html#option_mysqlimport_compress) | 压缩客户端和服务器之间发送的所有信息 |  | 8.0.18 |
| [--压缩算法](mysqlimport.html#option_mysqlimport_compression-algorithms) | 允许连接到服务器的压缩算法 | 8.0.18 |  |
| [--调试](mysqlimport.html#option_mysqlimport_debug) | 写调试日志 |  |  |
| [--调试检查](mysqlimport.html#option_mysqlimport_debug-check) | 程序退出时打印调试信息 |  |  |
| [--调试信息](mysqlimport.html#option_mysqlimport_debug-info) | 程序退出时打印调试信息、内存和 CPU 统计信息 |  |  |
| [--默认身份验证](mysqlimport.html#option_mysqlimport_default-auth) | 要使用的身份验证插件 |  |  |
| [--默认字符集](mysqlimport.html#option_mysqlimport_default-character-set) | 指定默认字符集 |  |  |
| [--defaults-额外文件](mysqlimport.html#option_mysqlimport_defaults-extra-file) | 除了通常的选项文件外，还读取命名的选项文件 |  |  |
| [--默认文件](mysqlimport.html#option_mysqlimport_defaults-file) | 只读命名选项文件 |  |  |
| [--defaults-组后缀](mysqlimport.html#option_mysqlimport_defaults-group-suffix) | 选项组后缀值 |  |  |
| [--删除](mysqlimport.html#option_mysqlimport_delete) | 在导入文本文件之前清空表格 |  |  |
| [--启用明文插件](mysqlimport.html#option_mysqlimport_enable-cleartext-plugin) | 启用明文身份验证插件 |  |  |
| [--fields-enclosed-by](mysqlimport.html#option_mysqlimport_fields) | 该选项与 LOAD DATA 的相应子句含义相同 |  |  |
| [--字段转义](mysqlimport.html#option_mysqlimport_fields) | 该选项与 LOAD DATA 的相应子句含义相同 |  |  |
| [--fields-optional-enclosure-by](mysqlimport.html#option_mysqlimport_fields) | 该选项与 LOAD DATA 的相应子句含义相同 |  |  |
| [--字段终止者](mysqlimport.html#option_mysqlimport_fields) | 该选项与 LOAD DATA 的相应子句含义相同 |  |  |
| [--力量](mysqlimport.html#option_mysqlimport_force) | 即使发生 SQL 错误也继续 |  |  |
| [--get-server-public-key](mysqlimport.html#option_mysqlimport_get-server-public-key) | 从服务器请求 RSA 公钥 |  |  |
| [--帮助](mysqlimport.html#option_mysqlimport_help) | 显示帮助信息并退出 |  |  |
| [--主持人](mysqlimport.html#option_mysqlimport_host) | MySQL服务器所在的主机 |  |  |
| [--忽视](mysqlimport.html#option_mysqlimport_ignore) | 请参阅 --replace 选项的说明 |  |  |
| [--忽略行](mysqlimport.html#option_mysqlimport_ignore-lines) | 忽略数据文件的前 N ​​行 |  |  |
| [--行终止于](mysqlimport.html#option_mysqlimport_lines-terminated-by) | 该选项与 LOAD DATA 的相应子句含义相同 |  |  |
| [--当地的](mysqlimport.html#option_mysqlimport_local) | 从客户端主机本地读取输入文件 |  |  |
| [--锁表](mysqlimport.html#option_mysqlimport_lock-tables) | 在处理任何文本文件之前锁定所有表以进行写入 |  |  |
| [--登录路径](mysqlimport.html#option_mysqlimport_login-path) | 从 .mylogin.cnf 读取登录路径选项 |  |  |
| [--低优先级](mysqlimport.html#option_mysqlimport_low-priority) | 使用低\_加载表格时的优先级 |  |  |
| [--无默认值](mysqlimport.html#option_mysqlimport_no-defaults) | 不读取选项文件 |  |  |
| [--密码](mysqlimport.html#option_mysqlimport_password) | 连接服务器时使用的密码 |  |  |
| [--密码1](mysqlimport.html#option_mysqlimport_password1) | 连接到服务器时使用的第一个多重身份验证密码 | 8.0.27 |  |
| [--密码2](mysqlimport.html#option_mysqlimport_password2) | 连接到服务器时使用的第二个多重身份验证密码 | 8.0.27 |  |
| [--密码3](mysqlimport.html#option_mysqlimport_password3) | 连接到服务器时使用的第三个多重身份验证密码 | 8.0.27 |  |
| [--管道](mysqlimport.html#option_mysqlimport_pipe) | 使用命名管道连接到服务器（仅限 Windows） |  |  |
| [--插件目录](mysqlimport.html#option_mysqlimport_plugin-dir) | 插件安装目录 |  |  |
| [--港口](mysqlimport.html#option_mysqlimport_port) | 用于连接的 TCP/IP 端口号 |  |  |
| [--打印默认值](mysqlimport.html#option_mysqlimport_print-defaults) | 打印默认选项 |  |  |
| [--协议](mysqlimport.html#option_mysqlimport_protocol) | 要使用的传输协议 |  |  |
| [--代替](mysqlimport.html#option_mysqlimport_replace) | --replace 和 --ignore 选项控制对在唯一键值上重复现有行的输入行的处理 |  |  |
| [--服务器公钥路径](mysqlimport.html#option_mysqlimport_server-public-key-path) | 包含 RSA 公钥的文件的路径名 |  |  |
| [--shared-memory-base-name](mysqlimport.html#option_mysqlimport_shared-memory-base-name) | 共享内存连接的共享内存名称（仅限 Windows） |  |  |
| [--无声](mysqlimport.html#option_mysqlimport_silent) | 仅在发生错误时生成输出 |  |  |
| [--插座](mysqlimport.html#option_mysqlimport_socket) | 要使用的 Unix 套接字文件或 Windows 命名管道 |  |  |
| [--ssl-ca](mysqlimport.html#option_mysqlimport_ssl) | 包含受信任 SSL 证书颁发机构列表的文件 |  |  |
| [--ssl-capath](mysqlimport.html#option_mysqlimport_ssl) | 包含受信任的 SSL 证书颁发机构证书文件的目录 |  |  |
| [--ssl 证书](mysqlimport.html#option_mysqlimport_ssl) | 包含 X.509 证书的文件 |  |  |
| [--ssl密码](mysqlimport.html#option_mysqlimport_ssl) | 连接加密的允许密码 |  |  |
| [--ssl-crl](mysqlimport.html#option_mysqlimport_ssl) | 包含证书吊销列表的文件 |  |  |
| [--ssl-crlpath](mysqlimport.html#option_mysqlimport_ssl) | 包含证书吊销列表文件的目录 |  |  |
| [--ssl-fips 模式](mysqlimport.html#option_mysqlimport_ssl-fips-mode) | 客户端是否开启 FIPS 模式 |  |  |
| [--ssl 密钥](mysqlimport.html#option_mysqlimport_ssl) | 包含 X.509 密钥的文件 |  |  |
| [--ssl 模式](mysqlimport.html#option_mysqlimport_ssl) | 连接到服务器的所需安全状态 |  |  |
| [--ssl 会话数据](mysqlimport.html#option_mysqlimport_ssl) | 包含 SSL 会话数据的文件 | 8.0.29 |  |
| [--ssl-session-data-continue-on-failed-reuse](mysqlimport.html#option_mysqlimport_ssl) | 会话重用失败时是否建立连接 | 8.0.29 |  |
| [--tls-密码套件](mysqlimport.html#option_mysqlimport_tls-ciphersuites) | 用于加密连接的允许 TLSv1.3 密码套件 | 8.0.16 |  |
| [--tls-版本](mysqlimport.html#option_mysqlimport_tls-version) | 加密连接的允许 TLS 协议 |  |  |
| [--使用线程](mysqlimport.html#option_mysqlimport_use-threads) | 并行文件加载的线程数 |  |  |
| [--用户](mysqlimport.html#option_mysqlimport_user) | 连接到服务器时使用的 MySQL 用户名 |  |  |
| [--详细](mysqlimport.html#option_mysqlimport_verbose) | 详细模式 |  |  |
| [--版本](mysqlimport.html#option_mysqlimport_version) | 显示版本信息并退出 |  |  |
| [--zstd-压缩级别](mysqlimport.html#option_mysqlimport_zstd-compression-level) | 与使用 zstd 压缩的服务器的连接的压缩级别 | 8.0.18 |  |

-   [](<>) [`- 帮助`](mysqlimport.html#option_mysqlimport_help), `-？`

    [](<>)[](<>)

    显示帮助信息并退出。

-   [](<>) [`--绑定地址=*`IP地址`*`](mysqlimport.html#option_mysqlimport_bind-address)

    [](<>)[](<>)

    在具有多个网络接口的计算机上，使用此选项来选择用于连接 MySQL 服务器的接口。

-   [](<>) [`--字符集目录=*`目录名`*`](mysqlimport.html#option_mysqlimport_character-sets-dir)

    [](<>)[](<>)

    安装字符集的目录。看[第 10.15 节，“字符集配置”](charset-configuration.html).

-   [](<>) [`--列=*`列列表`*`](mysqlimport.html#option_mysqlimport_columns),`-c *`列列表`*`

    [](<>)[](<>)

    此选项将逗号分隔的列名列表作为其值。列名的顺序指示如何将数据文件列与表列匹配。

-   [](<>) [`- 压缩`](mysqlimport.html#option_mysqlimport_compress),`-C`

    [](<>)[](<>)

    如果可能，压缩客户端和服务器之间发送的所有信息。看[第 4.2.8 节，“连接压缩控制”](connection-compression-control.html).

    从 MySQL 8.0.18 开始，此选项已弃用。期望它在 MySQL 的未来版本中被删除。看[配置旧版连接压缩](connection-compression-control.html#connection-compression-legacy-configuration).

-   [](<>) [`--压缩算法=*`价值`*`](mysqlimport.html#option_mysqlimport_compression-algorithms)

    [](<>)[](<>)

    连接到服务器的允许压缩算法。可用的算法与[`协议压缩算法`](server-system-variables.html#sysvar_protocol_compression_algorithms)系统变量。默认值为`未压缩`.

    有关详细信息，请参阅[第 4.2.8 节，“连接压缩控制”](connection-compression-control.html).

    此选项是在 MySQL 8.0.18 中添加的。

-   [](<>) [`--调试[=*`调试选项`*]`](mysqlimport.html#option_mysqlimport_debug),`-# [*`调试选项`*]`

    [](<>)[](<>)

    编写调试日志。一个典型的*`调试选项`*字符串是`d:t:o,*`文件名`*`.默认是`d:t:o`.

    仅当 MySQL 是使用[`WITH_DEBUG`](source-configuration-options.html#option_cmake_with_debug).Oracle 提供的 MySQL 发行版二进制文件是*不是*使用此选项构建。

-   [](<>) [`--调试检查`](mysqlimport.html#option_mysqlimport_debug-check)

    [](<>)[](<>)

    程序退出时打印一些调试信息。

    仅当 MySQL 是使用[`WITH_DEBUG`](source-configuration-options.html#option_cmake_with_debug).Oracle 提供的 MySQL 发行版二进制文件是*不是*使用此选项构建。

-   [](<>) [`- 调试信息`](mysqlimport.html#option_mysqlimport_debug-info)

    [](<>)[](<>)

    程序退出时打印调试信息以及内存和 CPU 使用统计信息。

    仅当 MySQL 是使用[`WITH_DEBUG`](source-configuration-options.html#option_cmake_with_debug).Oracle 提供的 MySQL 发行版二进制文件是*不是*使用此选项构建。

-   [](<>) [`--默认字符集=*`字符集名称`*`](mysqlimport.html#option_mysqlimport_default-character-set)

    [](<>)[](<>)

    采用*`字符集名称`*作为默认字符集。看[第 10.15 节，“字符集配置”](charset-configuration.html).

-   [](<>) [`--default-auth=*`插入`*`](mysqlimport.html#option_mysqlimport_default-auth)

    [](<>)[](<>)

    关于使用哪个客户端身份验证插件的提示。看[第 6.2.17 节，“可插拔身份验证”](pluggable-authentication.html).

-   [](<>) [`--defaults-extra-file=*`文件名`*`](mysqlimport.html#option_mysqlimport_defaults-extra-file)

    [](<>)[](<>)

    在全局选项文件之后但（在 Unix 上）在用户选项文件之前读取此选项文件。如果文件不存在或无法访问，则会发生错误。如果*`文件名`*不是绝对路径名，它是相对于当前目录解释的。

    有关此选项和其他选项文件选项的更多信息，请参阅[第 4.2.2.3 节，“影响选项文件处理的命令行选项”](option-file-options.html).

-   [](<>) [`--默认文件=*`文件名`*`](mysqlimport.html#option_mysqlimport_defaults-file)

    [](<>)[](<>)

    仅使用给定的选项文件。如果文件不存在或无法访问，则会发生错误。如果*`文件名`*不是绝对路径名，它是相对于当前目录解释的。

    例外：即使有[`--defaults 文件`](option-file-options.html#option_general_defaults-file), 客户端程序读取`.mylogin.cnf`.

    有关此选项和其他选项文件选项的更多信息，请参阅[第 4.2.2.3 节，“影响选项文件处理的命令行选项”](option-file-options.html).

-   [](<>) [`--defaults-group-suffix=*`字符串`*`](mysqlimport.html#option_mysqlimport_defaults-group-suffix)

    [](<>)[](<>)

    不仅可以读取通常的选项组，还可以读取具有通常名称和后缀的组*`字符串`*.例如，[**mysql导入**](mysqlimport.html)通常读取`[客户]`和`[mysql导入]`团体。如果这个选项被给出为[`--defaults-group-suffix=_other`](mysqlimport.html#option_mysqlimport_defaults-group-suffix),[**mysql导入**](mysqlimport.html)还读取`[client_other]`和`[mysqlimport_other]`团体。

    有关此选项和其他选项文件选项的更多信息，请参阅[第 4.2.2.3 节，“影响选项文件处理的命令行选项”](option-file-options.html).

-   [](<>) [`- 删除`](mysqlimport.html#option_mysqlimport_delete),`-D`

    [](<>)[](<>)

    在导入文本文件之前清空表。

-   [](<>) [`--启用明文插件`](mysqlimport.html#option_mysqlimport_enable-cleartext-plugin)

    [](<>)[](<>)

    启用`mysql_clear_password`明文身份验证插件。（看[第 6.4.1.4 节，“客户端明文可插入身份验证”](cleartext-pluggable-authentication.html).)

-   [](<>) [`--fields-terminated-by=...`](mysqlimport.html#option_mysqlimport_fields),[`--fields-enclosed-by=...`](mysqlimport.html#option_mysqlimport_fields),[`--fields-optional-enclosed-by=...`](mysqlimport.html#option_mysqlimport_fields),[`--fields-escaped-by=...`](mysqlimport.html#option_mysqlimport_fields)

    [](<>)[](<>)[](<>)[](<>)[](<>)[](<>)[](<>)[](<>)

    这些选项与相应子句的含义相同[`加载数据`](load-data.html).看[第 13.2.7 节，“加载数据语句”](load-data.html).

-   [](<>) [`- 力量`](mysqlimport.html#option_mysqlimport_force),`-f`

    [](<>)[](<>)

    忽略错误。例如，如果文本文件的表不存在，则继续处理任何剩余的文件。没有[`- 力量`](mysqlimport.html#option_mysqlimport_force),[**mysql导入**](mysqlimport.html)如果表不存在则退出。

-   [](<>) [`--get-server-public-key`](mysqlimport.html#option_mysqlimport_get-server-public-key)

    [](<>)[](<>)

    从服务器请求基于 RSA 密钥对的密码交换所需的公钥。此选项适用于通过`cache_sha2_password`身份验证插件。对于该插件，除非请求，否则服务器不会发送公钥。对于未使用该插件进行身份验证的帐户，此选项将被忽略。如果不使用基于 RSA 的密码交换，它也会被忽略，例如客户端使用安全连接连接到服务器的情况。

    如果[`--server-public-key-path=*`文件名`*`](mysqlimport.html#option_mysqlimport_server-public-key-path)给出并指定一个有效的公钥文件，它优先于[`--get-server-public-key`](mysqlimport.html#option_mysqlimport_get-server-public-key).

    有关信息`cache_sha2_password`插件，见[第 6.4.1.2 节，“缓存 SHA-2 可插入身份验证”](caching-sha2-pluggable-authentication.html).

-   [](<>) [`--主机=*`主机名`*`](mysqlimport.html#option_mysqlimport_host),`-h *`主机名`*`

    [](<>)[](<>)

    将数据导入给定主机上的 MySQL 服务器。默认主机是`本地主机`.

-   [](<>) [`- 忽视`](mysqlimport.html#option_mysqlimport_ignore),`-一世`

    [](<>)[](<>)

    请参阅说明[`- 代替`](mysqlimport.html#option_mysqlimport_replace)选项。

-   [](<>) [`--忽略行=*`ñ`*`](mysqlimport.html#option_mysqlimport_ignore-lines)

    [](<>)[](<>)

    忽略第一个*`ñ`*数据文件的行。

-   [](<>) [`--lines-terminated-by=...`](mysqlimport.html#option_mysqlimport_lines-terminated-by)

    [](<>)[](<>)

    该选项与对应的子句含义相同[`加载数据`](load-data.html).例如，要导入行以回车符/换行符对终止的 Windows 文件，请使用[`--lines-terminated-by="\r\n"`](mysqlimport.html#option_mysqlimport_lines-terminated-by).（您可能必须将反斜杠加倍，具体取决于命令解释器的转义约定。）请参阅[第 13.2.7 节，“加载数据语句”](load-data.html).

-   [](<>) [`- 当地的`](mysqlimport.html#option_mysqlimport_local),`-L`

    [](<>)[](<>)

    默认情况下，文件由服务器主机上的服务器读取。有了这个选项，[**mysql导入**](mysqlimport.html)在客户端主机上本地读取输入文件。

    成功使用`当地的`内的加载操作[**mysql导入**](mysqlimport.html)还要求服务器允许本地加载；看[第 6.1.6 节，“本地加载数据的安全注意事项”](load-data-local-security.html)

-   [](<>) [`--锁表`](mysqldump.html#option_mysqldump_lock-tables),`-l`

    [](<>)[](<>)

    锁*全部*在处理任何文本文件之前编写的表格。这可确保所有表在服务器上同步。

-   [](<>) [`--登录路径=*`姓名`*`](mysqlimport.html#option_mysqlimport_login-path)

    [](<>)[](<>)

    从命名登录路径中读取选项`.mylogin.cnf`登录路径文件。“登录路径”是一个选项组，其中包含指定要连接到哪个 MySQL 服务器以及要作为哪个帐户进行身份验证的选项。要创建或修改登录路径文件，请使用[**mysql\_配置\_编辑**](mysql-config-editor.html)效用。看[第 4.6.7 节，“mysql\_配置\_编辑器 — MySQL 配置实用程序”](mysql-config-editor.html).

    有关此选项和其他选项文件选项的更多信息，请参阅[第 4.2.2.3 节，“影响选项文件处理的命令行选项”](option-file-options.html).

-   [](<>) [`- 低优先级`](mysqlimport.html#option_mysqlimport_low-priority)

    [](<>)[](<>)

    采用`低优先级`加载表时。这仅影响仅使用表级锁定的存储引擎（例如`MyISAM`,`记忆`， 和`合并`）。

-   [](<>) [`--no-defaults`](mysqlimport.html#option_mysqlimport_no-defaults)

    [](<>)[](<>)

    不要读取任何选项文件。如果由于从选项文件中读取未知选项而导致程序启动失败，[`--no-defaults`](mysqlimport.html#option_mysqlimport_no-defaults)可以用来防止它们被读取。

    唯一的例外是`.mylogin.cnf`如果文件存在，则在所有情况下都会读取文件。这允许以比在命令行上更安全的方式指定密码，即使在[`--no-defaults`](mysqlimport.html#option_mysqlimport_no-defaults)用来。创造`.mylogin.cnf`， 使用[**mysql\_配置\_编辑**](mysql-config-editor.html)效用。看[第 4.6.7 节，“mysql\_配置\_编辑器 — MySQL 配置实用程序”](mysql-config-editor.html).

    有关此选项和其他选项文件选项的更多信息，请参阅[第 4.2.2.3 节，“影响选项文件处理的命令行选项”](option-file-options.html).

-   [](<>) [`--密码[=*`密码`*]`](mysqlimport.html#option_mysqlimport_password),`-p[*`密码`*]`

    [](<>)[](<>)

    用于连接服务器的 MySQL 帐户的密码。密码值是可选的。如果不给，[**mysql导入**](mysqlimport.html)提示一个。如果给出，必须有*没有空间*之间[`--密码=`](mysqlimport.html#option_mysqlimport_password)要么`-p`和它后面的密码。如果未指定密码选项，则默认为不发送密码。

    在命令行上指定密码应该被认为是不安全的。为避免在命令行上提供密码，请使用选项文件。看[第 6.1.2.1 节，“最终用户密码安全指南”](password-security-user.html).

    明确指定没有密码并且[**mysql导入**](mysqlimport.html)不应该提示输入一个，使用[`--跳过密码`](mysqlimport.html#option_mysqlimport_password)选项。

-   [](<>) [`--密码1[=*`pass_val`*]`](mysqlimport.html#option_mysqlimport_password1)

    [](<>)

    用于连接服务器的 MySQL 帐户的多重身份验证因素 1 的密码。密码值是可选的。如果不给，[**mysql导入**](mysqlimport.html)提示一个。如果给出，必须有*没有空间*之间[`--密码1=`](mysqlimport.html#option_mysqlimport_password1)和它后面的密码。如果未指定密码选项，则默认为不发送密码。

    在命令行上指定密码应该被认为是不安全的。为避免在命令行上提供密码，请使用选项文件。看[第 6.1.2.1 节，“最终用户密码安全指南”](password-security-user.html).

    明确指定没有密码并且[**mysql导入**](mysqlimport.html)不应该提示输入一个，使用[`--skip-password1`](mysqlimport.html#option_mysqlimport_password1)选项。

    [`--密码1`](mysqlimport.html#option_mysqlimport_password1)和[`- 密码`](mysqlimport.html#option_mysqlimport_password)是同义词[`--skip-password1`](mysqlimport.html#option_mysqlimport_password1)和[`--跳过密码`](mysqlimport.html#option_mysqlimport_password).

-   [](<>) [`--密码2[=*`pass_val`*]`](mysqlimport.html#option_mysqlimport_password2)

    [](<>)

    用于连接服务器的 MySQL 帐户的多重身份验证因子 2 的密码。此选项的语义类似于[`--密码1`](mysqlimport.html#option_mysqlimport_password1);有关详细信息，请参阅该选项的说明。

-   [](<>) [`--密码3[=*`pass_val`*]`](mysqlimport.html#option_mysqlimport_password3)

    [](<>)

    用于连接服务器的 MySQL 帐户的多重身份验证因子 3 的密码。此选项的语义类似于[`--密码1`](mysqlimport.html#option_mysqlimport_password1);有关详细信息，请参阅该选项的说明。

-   [](<>) [`- 管道`](mysqlimport.html#option_mysqlimport_pipe),`-W`

    [](<>)[](<>)

    在 Windows 上，使用命名管道连接到服务器。此选项仅适用于服务器以[`命名管道`](server-system-variables.html#sysvar_named_pipe)启用系统变量以支持命名管道连接。此外，建立连接的用户必须是由指定的 Windows 组的成员[`named_pipe_full_access_group`](server-system-variables.html#sysvar_named_pipe_full_access_group)系统变量。

-   [](<>) [`--插件目录=*`目录名`*`](mysqlimport.html#option_mysqlimport_plugin-dir)

    [](<>)[](<>)

    查找插件的目录。指定此选项，如果[`--default-auth`](mysqlimport.html#option_mysqlimport_default-auth)选项用于指定身份验证插件，但[**mysql导入**](mysqlimport.html)没有找到它。看[第 6.2.17 节，“可插拔身份验证”](pluggable-authentication.html).

-   [](<>) [`--端口=*`端口号`*`](mysqlimport.html#option_mysqlimport_port),`-P *`端口号`*`

    [](<>)[](<>)

    对于 TCP/IP 连接，要使用的端口号。

-   [](<>) [`--打印默认值`](mysqlimport.html#option_mysqlimport_print-defaults)

    [](<>)[](<>)

    打印程序名称和它从选项文件中获取的所有选项。

    有关此选项和其他选项文件选项的更多信息，请参阅[第 4.2.2.3 节，“影响选项文件处理的命令行选项”](option-file-options.html).

-   [](<>) [`--protocol={TCP|SOCKET|管道|内存}`](mysqlimport.html#option_mysqlimport_protocol)

    [](<>)[](<>)

    用于连接到服务器的传输协议。当其他连接参数通常导致使用您想要的协议以外的协议时，它很有用。有关允许值的详细信息，请参见[第 4.2.7 节，“连接传输协议”](transport-protocols.html).

-   [](<>) [`- 代替`](mysqlimport.html#option_mysqlimport_replace),`-r`

    [](<>)[](<>)

    这[`- 代替`](mysqlimport.html#option_mysqlimport_replace)和[`- 忽视`](mysqlimport.html#option_mysqlimport_ignore)选项控制对在唯一键值上重复现有行的输入行的处理。如果您指定[`- 代替`](mysqlimport.html#option_mysqlimport_replace)，新行替换具有相同唯一键值的现有行。如果您指定[`- 忽视`](mysqlimport.html#option_mysqlimport_ignore)，将跳过与唯一键值上的现有行重复的输入行。如果您不指定任一选项，则在找到重复键值时会发生错误，并且文本文件的其余部分将被忽略。

-   [](<>) [`--server-public-key-path=*`文件名`*`](mysqlimport.html#option_mysqlimport_server-public-key-path)

    [](<>)[](<>)

    PEM 格式的文件的路径名，其中包含服务器基于 RSA 密钥对的密码交换所需的公钥的客户端副本。此选项适用于通过`sha256_password`要么`cache_sha2_password`身份验证插件。对于未使用这些插件之一进行身份验证的帐户，此选项将被忽略。如果不使用基于 RSA 的密码交换，它也会被忽略，例如客户端使用安全连接连接到服务器的情况。

    如果[`--server-public-key-path=*`文件名`*`](mysqlimport.html#option_mysqlimport_server-public-key-path)给出并指定一个有效的公钥文件，它优先于[`--get-server-public-key`](mysqlimport.html#option_mysqlimport_get-server-public-key).

    为了`sha256_password`, 此选项仅适用于使用 OpenSSL 构建 MySQL 的情况。

    有关信息`sha256_password`和`cache_sha2_password`插件，见[第 6.4.1.3 节，“SHA-256 可插入身份验证”](sha256-pluggable-authentication.html)， 和[第 6.4.1.2 节，“缓存 SHA-2 可插入身份验证”](caching-sha2-pluggable-authentication.html).

-   [](<>) [`--shared-memory-base-name=*`姓名`*`](mysqlimport.html#option_mysqlimport_shared-memory-base-name)

    [](<>)[](<>)

    在 Windows 上，用于使用共享内存与本地服务器建立连接的共享内存名称。默认值为`MYSQL`.共享内存名称区分大小写。

    此选项仅适用于服务器以[`共享内存`](server-system-variables.html#sysvar_shared_memory)启用系统变量以支持共享内存连接。

-   [](<>) [`- 无声`](mysqlimport.html#option_mysqlimport_silent),`-s`

    [](<>)[](<>)

    静音模式。仅在发生错误时生成输出。

-   [](<>) [`--socket=*`小路`*`](mysqlimport.html#option_mysqlimport_socket),`-S *`小路`*`

    [](<>)[](<>)

    对于连接到`本地主机`，要使用的 Unix 套接字文件，或者在 Windows 上，要使用的命名管道的名称。

    在 Windows 上，此选项仅在服务器以[`命名管道`](server-system-variables.html#sysvar_named_pipe)启用系统变量以支持命名管道连接。此外，建立连接的用户必须是由指定的 Windows 组的成员[`named_pipe_full_access_group`](server-system-variables.html#sysvar_named_pipe_full_access_group)系统变量。

-   [](<>) `--ssl*`

    [](<>)[](<>)

    开头的选项`--ssl`指定是否使用加密连接到服务器并指示在哪里可以找到 SSL 密钥和证书。看[加密连接的命令选项](connection-options.html#encrypted-connection-options).

-   [](<>) [`--ssl-fips-mode={OFF|ON|STRICT}`](mysqlimport.html#option_mysqlimport_ssl-fips-mode)

    [](<>)[](<>)

    控制是否在客户端启用 FIPS 模式。这[`--ssl-fips-模式`](mysqlimport.html#option_mysqlimport_ssl-fips-mode)选项不同于其他`--ssl-*`xxx`*`选项，因为它不用于建立加密连接，而是影响允许哪些加密操作。看[第 6.8 节，“FIPS 支持”](fips-mode.html).

    这些[`--ssl-fips-模式`](mysqlimport.html#option_mysqlimport_ssl-fips-mode)允许的值：

    -   `离开`：禁用 FIPS 模式。

    -   `在`：启用 FIPS 模式。

    -   `严格的`：启用“严格”FIPS 模式。

    笔记

    如果 OpenSSL FIPS 对象模块不可用，则唯一允许的值为[`--ssl-fips-模式`](mysqlimport.html#option_mysqlimport_ssl-fips-mode)是`离开`.在这种情况下，设置[`--ssl-fips-模式`](mysqlimport.html#option_mysqlimport_ssl-fips-mode)到`在`要么`严格的`导致客户端在启动时产生警告并在非 FIPS 模式下运行。

-   [](<>) [`--tls-ciphersuites=*`密码套件列表`*`](mysqlimport.html#option_mysqlimport_tls-ciphersuites)

    [](<>)[](<>)

    允许使用 TLSv1.3 的加密连接的密码套件。该值是一个或多个以冒号分隔的密码套件名称的列表。可以为此选项命名的密码套件取决于用于编译 MySQL 的 SSL 库。有关详细信息，请参阅[第 6.3.2 节，“加密连接 TLS 协议和密码”](encrypted-connection-protocols-ciphers.html).

    此选项是在 MySQL 8.0.16 中添加的。

-   [](<>) [`--tls-版本=*`协议列表`*`](mysqlimport.html#option_mysqlimport_tls-version)

    [](<>)[](<>)

    加密连接的允许 TLS 协议。该值是一个或多个逗号分隔的协议名称的列表。可以为此选项命名的协议取决于用于编译 MySQL 的 SSL 库。有关详细信息，请参阅[第 6.3.2 节，“加密连接 TLS 协议和密码”](encrypted-connection-protocols-ciphers.html).

-   [](<>) [`--用户=*`用户名`*`](mysqlimport.html#option_mysqlimport_user),`-u *`用户名`*`

    [](<>)[](<>)

    用于连接到服务器的 MySQL 帐户的用户名。

-   [](<>) [`--使用线程=*`ñ`*`](mysqlimport.html#option_mysqlimport_use-threads)

    [](<>)[](<>)

    使用*`N`*线程。

-   [](<>) [`--冗长的`](mysqlimport.html#option_mysqlimport_verbose),`-五`

    [](<>)[](<>)

    详细模式。打印有关程序功能的更多信息。

-   [](<>) [`--版本`](mysqlimport.html#option_mysqlimport_version),`-五`

    [](<>)[](<>)

    显示版本信息并退出。

-   [](<>) [`--压缩级别=*`数量`*`](mysqlimport.html#option_mysqlimport_zstd-compression-level)

     [](<>)[](<>)

    用于连接到使用`zstd`压缩算法。允许的水平从1到22，较大的值表示压缩水平增加。默认值`zstd`压缩级别为3。压缩级别设置对不使用压缩级别的连接没有影响`zstd`压缩。

    有关更多信息，请参阅[第4.2.8节，“连接压缩控制”](connection-compression-control.html).

    这个选项是在MySQL 8.0.18中添加的。

    下面是一个演示如何使用[**mysqlimport**](mysqlimport.html):


```
$> mysql -e 'CREATE TABLE imptest(id INT, n VARCHAR(30))' test
$> ed
a
100     Max Sydow
101     Count Dracula
.
w imptest.txt
32
q
$> od -c imptest.txt
0000000   1   0   0  \t   M   a   x       S   y   d   o   w  \n   1   0
0000020   1  \t   C   o   u   n   t       D   r   a   c   u   l   a  \n
0000040
$> mysqlimport --local test imptest.txt
test.imptest: Records: 2  Deleted: 0  Skipped: 0  Warnings: 0
$> mysql -e 'SELECT * FROM imptest' test
+------+---------------+
| id   | n             |
+------+---------------+
|  100 | Max Sydow     |
|  101 | Count Dracula |
+------+---------------+
```
