4.5.5 mysqlimport —一个数据导入程序

mysqlimportClient 端为LOAD DATA SQL 语句提供了命令行界面。 mysqlimport的大多数选项直接对应于LOAD DATA语法的子句。参见第 13.2.6 节“ LOAD DATA 语句”

像这样调用mysqlimport

shell> mysqlimport [options] db_name textfile1 [textfile2 ...]

对于在命令行上命名的每个文本文件,mysqlimport将从文件名中删除所有 extensions,并使用结果确定要将文件内容导入到的 table 的名称。例如,名为patient.txtpatient.textpatient的文件都将导入到名为patient的 table 中。

mysqlimport支持以下选项,可以在命令行或选项文件的[mysqlimport][client]组中指定这些选项。有关 MySQL 程序使用的选项文件的信息,请参见第 4.2.2.2 节“使用选项文件”

table4.16 mysqlimport 选项

Option NameDescriptionIntroducedDeprecated
--bind-address使用指定的网络接口连接到 MySQL Server
--columns此选项以逗号分隔的列名列 table 作为其值
--compress压缩 Client 端和服务器之间发送的所有信息
--debug编写调试日志
--debug-check程序退出时打印调试信息
--debug-info程序退出时打印调试信息,内存和 CPU 统计信息
--default-auth身份验证插件使用
--default-character-set指定默认字符集
--defaults-extra-file除常规选项文件外,还读取命名的选项文件
--defaults-file只读命名的选项文件
--defaults-group-suffix选项组后缀值
--delete导入文本文件之前清空 table
--enable-cleartext-plugin启用明文身份验证插件5.7.10
--fields-enclosed-by此选项的含义与 LOAD DATA 的相应子句相同
--fields-escaped-by此选项的含义与 LOAD DATA 的相应子句相同
--fields-optionally-enclosed-by此选项的含义与 LOAD DATA 的相应子句相同
--fields-terminated-by此选项的含义与 LOAD DATA 的相应子句相同
--force即使发生 SQL 错误,也要 continue
--get-server-public-key从服务器请求 RSA 公钥5.7.23
--help显示帮助信息并退出
--hostMySQL 服务器所在的主机
--ignore请参阅--replace 选项的描述
--ignore-lines忽略数据文件的前 N 行
--lines-terminated-by此选项的含义与 LOAD DATA 的相应子句相同
--local从 Client 端主机本地读取 Importing 文件
--lock-tables在处理任何文本文件之前,锁定所有 table 以进行写入
--login-path从.mylogin.cnf 中读取登录路径选项
--low-priority加载 table 时使用 LOW_PRIORITY
--no-defaults不读取选项文件
--password连接服务器时使用的密码
--pipe使用命名管道连接到服务器(仅 Windows)
--plugin-dir安装插件的目录
--port用于连接的 TCP/IP 端口号
--print-defaults打印默认选项
--protocol使用的传输协议
--replace--replace 和--ignore 选项控制 Importing 行的处理,这些 Importing 行复制唯一键值上的现有行
--secure-auth不要以旧(4.1 之前)格式向服务器发送密码Yes
--server-public-key-path包含 RSA 公钥的文件的路径名5.7.23
--shared-memory-base-name共享内存连接的共享内存名称(仅 Windows)
--silent仅在发生错误时产生输出
--socketUnix 套接字文件或 Windows 命名管道使用
--ssl启用连接加密
--ssl-ca包含受信任的 SSL 证书颁发机构列 table 的文件
--ssl-capath包含受信任的 SSL 证书颁发机构证书文件的目录
--ssl-cert包含 X.509 证书的文件
--ssl-cipher连接加密的允许密码
--ssl-crl包含证书吊销列 table 的文件
--ssl-crlpath包含证书吊销列 table 文件的目录
--ssl-key包含 X.509 密钥的文件
--ssl-mode与服务器连接的所需安全状态5.7.11
--ssl-verify-server-cert根据服务器证书的通用名身份验证主机名
--tls-version允许的 TLS 协议进行加密连接5.7.10
--use-threads并行文件加载的线程数
--user连接服务器时使用的 MySQL 用户名
--verboseVerbose mode
--version显示版本信息并退出

显示帮助消息并退出。

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

字符集的安装目录。参见第 10.15 节“字符集配置”

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

尽可能压缩 Client 端和服务器之间发送的所有信息。参见第 4.2.6 节“连接压缩控制”

编写调试日志。典型的* debug_options *字符串是d:t:o,file_name。默认值为d:t:o

仅当使用WITH_DEBUG构建 MySQL 时,此选项才可用。使用此选项不是构建 Oracle 提供的 MySQL 发行版二进制文件。

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

仅当使用WITH_DEBUG构建 MySQL 时,此选项才可用。使用此选项不是构建 Oracle 提供的 MySQL 发行版二进制文件。

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

仅当使用WITH_DEBUG构建 MySQL 时,此选项才可用。使用此选项不是构建 Oracle 提供的 MySQL 发行版二进制文件。

使用* charset_name *作为默认字符集。参见第 10.15 节“字符集配置”

有关使用哪个 Client 端身份验证插件的提示。参见第 6.2.13 节“可插入身份验证”

在全局选项文件之后但在用户选项文件之前(在 Unix 上)读取此选项文件。如果该文件不存在或无法访问,则发生错误。 * file_name *如果是相对路径名而不是完整路径名,则相对于当前目录进行解释。

有关此选项和其他选项文件选项的更多信息,请参见第 4.2.2.3 节“影响选项文件处理的命令行选项”

仅使用给定的选项文件。如果该文件不存在或无法访问,则发生错误。 * file_name *如果是相对路径名而不是完整路径名,则相对于当前目录进行解释。

exception:即使使用--defaults-file,Client 端程序也读取.mylogin.cnf

有关此选项和其他选项文件选项的更多信息,请参见第 4.2.2.3 节“影响选项文件处理的命令行选项”

不仅阅读常规选项组,还阅读具有常规名称和后缀* str *的组。例如,mysqlimport通常读取[client][mysqlimport]组。如果提供了--defaults-group-suffix=_other选项,则mysqlimport也会读取[client_other][mysqlimport_other]组。

有关此选项和其他选项文件选项的更多信息,请参见第 4.2.2.3 节“影响选项文件处理的命令行选项”

导入文本文件之前,清空 table。

启用mysql_clear_password明文身份验证插件。 (请参阅第 6.4.1.6 节“Client 端明文可插入身份验证”。)

MySQL 5.7.10 中添加了此选项。

这些选项与LOAD DATA的相应子句具有相同的含义。参见第 13.2.6 节“ LOAD DATA 语句”

忽略错误。例如,如果文本文件 table 不存在,请 continue 处理所有剩余文件。如果没有--force,则如果 table 不存在,则mysqlimport退出。

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

如果给出了--server-public-key-path=file_name并指定了有效的公共密钥文件,则它优先于--get-server-public-key

有关caching_sha2_password插件的信息,请参见第 6.4.1.4 节“缓存 SHA-2 可插入身份验证”

--get-server-public-key选项已添加到 MySQL 5.7.23 中。

将数据导入给定主机上的 MySQL 服务器。默认主机为localhost

请参阅--replace选项的说明。

忽略数据文件的前* N *行。

此选项的含义与LOAD DATA的相应子句相同。例如,要导入带有以回车/换行对结尾的行的 Windows 文件,请使用--lines-terminated-by="\r\n"。 (根据命令解释器的转义约定,您可能必须加倍反斜杠.)请参见第 13.2.6 节“ LOAD DATA 语句”

默认情况下,服务器主机上的服务器读取文件。使用此选项,mysqlimport在 Client 端主机上本地读取 Importing 文件。

成功使用mysqlimport内的LOCAL加载操作还需要服务器允许本地加载。见第 6.1.6 节“ LOAD DATA LOCAL 的安全注意事项”

在处理任何文本文件之前,锁定所有 table 以进行写入。这样可以确保所有 table 在服务器上都同步。

.mylogin.cnf登录路径文件中的命名登录路径中读取选项。 “登录路径”是一个选项组,其中包含一些选项,这些选项指定要连接到哪个 MySQL 服务器以及要作为身份验证的帐户。要创建或修改登录路径文件,请使用mysql_config_editorUtil。参见第 4.6.6 节“ mysql_config_editor-MySQL 配置 Util”

有关此选项和其他选项文件选项的更多信息,请参见第 4.2.2.3 节“影响选项文件处理的命令行选项”

加载 table 格时使用LOW_PRIORITY。这仅影响仅使用 table 级锁定的存储引擎(例如MyISAMMEMORYMERGE)。

不要读取任何选项文件。如果由于从选项文件中读取未知选项而导致程序启动失败,则可以使用--no-defaults来防止读取它们。

exception 是在所有情况下都读取.mylogin.cnf文件(如果存在)。这样即使在使用--no-defaults的情况下,也可以通过比命令行更安全的方式指定密码。 (.mylogin.cnfmysql_config_editorUtil 创建。请参见第 4.6.6 节“ mysql_config_editor-MySQL 配置 Util”。)

有关此选项和其他选项文件选项的更多信息,请参见第 4.2.2.3 节“影响选项文件处理的命令行选项”

用于连接服务器的 MySQL 帐户的密码。密码值是可选的。如果未给出,mysqlimport提示 Importing 一个。如果提供,则--password=-p与后面的密码之间必须没有空格。如果未指定密码选项,则默认为不发送密码。

在命令行上指定密码应该被认为是不安全的。为避免在命令行上 Importing 密码,请使用选项文件。参见第 6.1.2.1 节,“最终用户密码安全准则”

要明确指定没有密码并且mysqlimport不应提示 Importing 密码,请使用--skip-password选项。

在 Windows 上,使用命名管道连接到服务器。仅当服务器在启用了named_pipe系统变量的情况下启动以支持命名管道连接时,此选项才适用。此外,构建连接的用户必须是named_pipe_full_access_group系统变量指定的 Windows 组的成员。

在其中查找插件的目录。如果--default-auth选项用于指定身份验证插件,但mysqlimport找不到它,请指定此选项。参见第 6.2.13 节“可插入身份验证”

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

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

有关此选项和其他选项文件选项的更多信息,请参见第 4.2.2.3 节“影响选项文件处理的命令行选项”

用于连接到服务器的传输协议。当其他连接参数通常导致使用您想要的协议以外的协议时,此功能很有用。有关允许值的详细信息,请参见第 4.2.5 节“连接传输协议”

--replace--ignore选项控制 Importing 行的处理,这些 Importing 行复制唯一键值上的现有行。如果指定--replace,则新行将替换具有相同唯一键值的现有行。如果指定--ignore,则将跳过在唯一键值上复制现有行的 Importing 行。如果您不指定任何一个选项,则当找到重复的键值时,将发生错误,而文本文件的其余部分将被忽略。

不要以旧(4.1 之前)格式向服务器发送密码。这样可以防止除使用较新密码格式的服务器以外的其他连接。

从 MySQL 5.7.5 开始,此选项已被弃用,并将在以后的 MySQL 版本中删除。它始终处于启用状态,尝试禁用它(--skip-secure-auth--secure-auth=0)会产生错误。在 MySQL 5.7.5 之前,此选项默认为启用,但可以禁用。

Note

使用 4.1 之前的哈希方法的密码比使用本地密码哈希方法的密码安全性较低,应避免使用。不建议使用 4.1 之前的密码,并在 MySQL 5.7.5 中删除了对它们的支持。有关帐户升级的说明,请参阅第 6.4.1.3 节“迁移到 4.1 版之前的密码哈希和 mysql_old_password 插件”

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

如果给出了--server-public-key-path=file_name并指定了有效的公共密钥文件,则它优先于--get-server-public-key

对于sha256_password,仅当使用 OpenSSL 构建 MySQL 时,此选项才适用。

有关sha256_passwordcaching_sha2_password插件的信息,请参见第 6.4.1.5 节“ SHA-256 可插拔身份验证”第 6.4.1.4 节“缓存 SHA-2 可插入身份验证”

--server-public-key-path选项已添加到 MySQL 5.7.23 中。

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

仅当在启用了shared_memory系统变量以支持共享内存连接的情况下启动服务器时,此选项才适用。

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

对于到localhost的连接(要使用的 Unix 套接字文件),或者在 Windows 上,要使用的命名管道的名称。

在 Windows 上,仅当在启用了named_pipe系统变量以支持命名管道连接的情况下启动服务器时,此选项才适用。此外,构建连接的用户必须是named_pipe_full_access_group系统变量指定的 Windows 组的成员。

  • --ssl*

--ssl开头的选项指定是否使用 SSL 连接到服务器,并指示在何处查找 SSL 密钥和证书。参见加密连接的命令选项

加密连接允许的 TLS 协议。该值是一个或多个逗号分隔的协议名称的列 table。可以为此选项命名的协议取决于用于编译 MySQL 的 SSL 库。有关详细信息,请参见第 6.3.2 节“加密的连接 TLS 协议和密码”

MySQL 5.7.10 中添加了此选项。

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

使用* N *线程并行加载文件。

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

显示版本信息并退出。

这是一个示例会话,演示了mysqlimport的用法:

shell> mysql -e 'CREATE TABLE imptest(id INT, n VARCHAR(30))' test
shell> ed
a
100     Max Sydow
101     Count Dracula
.
w imptest.txt
32
q
shell> 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
shell> mysqlimport --local test imptest.txt
test.imptest: Records: 2  Deleted: 0  Skipped: 0  Warnings: 0
shell> mysql -e 'SELECT * FROM imptest' test
+------+---------------+
| id   | n             |
+------+---------------+
|  100 | Max Sydow     |
|  101 | Count Dracula |
+------+---------------+