mysqlimport 客户端为 LOAD DATA
SQL 语句提供了命令行界面。 mysqlimport 的大多数选项直接对应于 LOAD DATA
语法的子句。参见 第 15.2.9 节,“LOAD DATA 语句”.
像这样调用 mysqlimport
mysqlimport [options] db_name textfile1 [textfile2 ...]
对于命令行上命名的每个文本文件,mysqlimport 会从文件名中剥离任何扩展名,并将结果用于确定要将文件内容导入到的表的名称。例如,名为 patient.txt
、patient.text
和 patient
的文件都将被导入到名为 patient
的表中。
mysqlimport 支持以下选项,这些选项可以在命令行或选项文件中的 [mysqlimport]
和 [client]
组中指定。有关 MySQL 程序使用的选项文件的更多信息,请参见 第 6.2.2.2 节,“使用选项文件”.
表 6.14 mysqlimport 选项
选项名称 | 描述 |
---|---|
--bind-address | 使用指定的网络接口连接到 MySQL 服务器 |
--character-sets-dir | 可以找到字符集的目录 |
--columns | 此选项将逗号分隔的列名列表作为其值 |
--compress | 压缩客户端和服务器之间发送的所有信息 |
--compression-algorithms | 允许用于连接到服务器的压缩算法 |
--debug | 写入调试日志 |
--debug-check | 程序退出时打印调试信息 |
--debug-info | 程序退出时打印调试信息、内存和 CPU 统计信息 |
--default-character-set | 指定默认字符集 |
--defaults-extra-file | 除了通常的选项文件外,还要读取命名的选项文件 |
--defaults-file | 仅读取命名的选项文件 |
--defaults-group-suffix | 选项组后缀值 |
--delete | 在导入文本文件之前清空表 |
--enable-cleartext-plugin | 启用明文身份验证插件 |
--fields-enclosed-by | 此选项与 LOAD DATA 的相应子句具有相同的含义 |
--fields-escaped-by | 此选项与 LOAD DATA 的相应子句具有相同的含义 |
--fields-optionally-enclosed-by | 此选项与 LOAD DATA 的相应子句具有相同的含义 |
--fields-terminated-by | 此选项与 LOAD DATA 的相应子句具有相同的含义 |
--force | 即使发生 SQL 错误,也要继续 |
--get-server-public-key | 从服务器请求 RSA 公钥 |
--help | 显示帮助消息并退出 |
--host | MySQL 服务器所在的地址 |
--ignore | 参见 --replace 选项的描述 |
--ignore-lines | 忽略数据文件的前 N 行 |
--lines-terminated-by | 此选项与 LOAD DATA 的相应子句具有相同的含义 |
--local | 从客户端主机本地读取输入文件 |
--lock-tables | 在处理任何文本文件之前锁定所有表以进行写入 |
--login-path | 从 .mylogin.cnf 读取登录路径选项 |
--low-priority | 加载表时使用 LOW_PRIORITY |
--no-defaults | 不读取任何选项文件 |
--no-login-paths | 不从登录路径文件读取登录路径 |
--password | 连接到服务器时要使用的密码 |
--password1 | 连接到服务器时要使用的第一个多因素身份验证密码 |
--password2 | 连接到服务器时要使用的第二个多因素身份验证密码 |
--password3 | 连接到服务器时要使用的第三个多因素身份验证密码 |
--pipe | 使用命名管道连接到服务器(仅限 Windows) |
--port | 连接的 TCP/IP 端口号 |
--print-defaults | 打印默认选项 |
--protocol | 要使用的传输协议 |
--replace | --replace 和 --ignore 选项控制处理在唯一键值上重复现有行的输入行 |
--server-public-key-path | 包含 RSA 公钥的文件的路径名 |
--shared-memory-base-name | 用于共享内存连接的共享内存名称(仅限 Windows) |
--silent | 仅在发生错误时产生输出 |
--socket | 要使用的 Unix 套接字文件或 Windows 命名管道 |
--ssl-ca | 包含受信任的 SSL 证书颁发机构列表的文件 |
--ssl-capath | 包含受信任的 SSL 证书颁发机构证书文件的目录 |
--ssl-cert | 包含 X.509 证书的文件 |
--ssl-cipher | 允许用于连接加密的密码 |
--ssl-fips-mode | 是否在客户端启用 FIPS 模式 |
--ssl-key | 包含 X.509 密钥的文件 |
--ssl-mode | 连接到服务器所需的安全性状态 |
--ssl-session-data | 包含 SSL 会话数据的文件 |
--ssl-session-data-continue-on-failed-reuse | 如果会话重用失败,是否建立连接 |
--tls-ciphersuites | 允许用于加密连接的 TLSv1.3 密码套件 |
--tls-sni-servername | 客户端提供的服务器名称 |
--tls-version | 允许用于加密连接的 TLS 协议 |
--use-threads | 用于并行文件加载的线程数 |
--user | 连接到服务器时要使用的 MySQL 用户名 |
--verbose | 详细模式 |
--version | 显示版本信息并退出 |
--zstd-compression-level | 使用 zstd 压缩连接到服务器的压缩级别 |
--help
,-?
命令行格式 --help
显示帮助消息并退出。
-
命令行格式 --bind-address=ip_address
在具有多个网络接口的计算机上,使用此选项选择用于连接到 MySQL 服务器的接口。
-
命令行格式 --character-sets-dir=路径
类型 字符串 默认值 [无]
字符集安装所在的目录。请参见 第 12.15 节,“字符集配置”。
--columns=
,column_list
-c
column_list
命令行格式 --columns=column_list
此选项以逗号分隔的列名列表作为其值。列名的顺序指示如何将数据文件列与表列匹配。
--compress
,-C
命令行格式 --compress[={OFF|ON}]
已弃用 是 类型 布尔值 默认值 OFF
如果可能,压缩客户端和服务器之间发送的所有信息。请参见 第 6.2.8 节,“连接压缩控制”。
此选项已弃用。预计它将在未来版本的 MySQL 中删除。请参见 配置旧版连接压缩。
--compression-algorithms=
value
命令行格式 --compression-algorithms=value
类型 设置 默认值 未压缩
有效值 zlib
zstd
未压缩
允许用于连接到服务器的压缩算法。可用算法与
protocol_compression_algorithms
系统变量相同。默认值为uncompressed
。有关更多信息,请参见 第 6.2.8 节,“连接压缩控制”。
--debug[=
,debug_options
]-# [
debug_options
]命令行格式 --debug[=debug_options]
类型 字符串 默认值 d:t:o
写入调试日志。典型的
debug_options
字符串为d:t:o,
。默认值为file_name
d:t:o
。此选项仅在使用
WITH_DEBUG
构建 MySQL 时可用。Oracle 提供的 MySQL 发布二进制文件 不 使用此选项构建。-
命令行格式 --debug-check
类型 布尔值 默认值 FALSE
在程序退出时打印一些调试信息。
此选项仅在使用
WITH_DEBUG
构建 MySQL 时可用。Oracle 提供的 MySQL 发布二进制文件 不 使用此选项构建。 -
命令行格式 --debug-info
类型 布尔值 默认值 FALSE
在程序退出时打印调试信息以及内存和 CPU 使用情况统计信息。
此选项仅在使用
WITH_DEBUG
构建 MySQL 时可用。Oracle 提供的 MySQL 发布二进制文件 不 使用此选项构建。 --default-character-set=
charset_name
命令行格式 --default-character-set=charset_name
类型 字符串 使用
charset_name
作为默认字符集。请参见 第 12.15 节,“字符集配置”。-
命令行格式 --default-auth=plugin
类型 字符串 关于使用哪个客户端身份验证插件的提示。请参见 第 8.2.17 节,“可插拔身份验证”。
--defaults-extra-file=
file_name
命令行格式 --defaults-extra-file=file_name
类型 文件名 在全局选项文件之后(但在 Unix 上,用户选项文件之前)读取此选项文件。如果文件不存在或无法访问,则会发生错误。如果
file_name
不是绝对路径名,则将其解释为相对于当前目录。有关此选项和其他选项文件选项的更多信息,请参见 第 6.2.2.3 节,“影响选项文件处理的命令行选项”。
-
命令行格式 --defaults-file=file_name
类型 文件名 仅使用给定的选项文件。如果文件不存在或无法访问,则会发生错误。如果
file_name
不是绝对路径名,则将其解释为相对于当前目录。例外:即使使用
--defaults-file
,客户端程序也会读取.mylogin.cnf
。有关此选项和其他选项文件选项的更多信息,请参见 第 6.2.2.3 节,“影响选项文件处理的命令行选项”。
-
命令行格式 --defaults-group-suffix=str
类型 字符串 不仅读取通常的选项组,还读取具有通常名称和
str
后缀的组。例如,mysqlimport 通常读取[client]
和[mysqlimport]
组。如果此选项给出为--defaults-group-suffix=_other
,则 mysqlimport 还将读取[client_other]
和[mysqlimport_other]
组。有关此选项和其他选项文件选项的更多信息,请参见 第 6.2.2.3 节,“影响选项文件处理的命令行选项”。
--delete
,-D
命令行格式 --delete
在导入文本文件之前清空表。
-
命令行格式 --enable-cleartext-plugin
类型 布尔值 默认值 FALSE
启用
mysql_clear_password
明文身份验证插件。(请参见 第 8.4.1.3 节,“客户端明文可插拔身份验证”。) --fields-terminated-by=...
,--fields-enclosed-by=...
,--fields-optionally-enclosed-by=...
,--fields-escaped-by=...
命令行格式 --fields-terminated-by=string
类型 字符串 命令行格式 --fields-enclosed-by=string
类型 字符串 命令行格式 --fields-optionally-enclosed-by=string
类型 字符串 命令行格式 --fields-escaped-by
类型 字符串 这些选项与
LOAD DATA
的相应子句具有相同的含义。请参见 第 15.2.9 节,“LOAD DATA 语句”。--force
,-f
命令行格式 --force
忽略错误。例如,如果文本文件对应的表不存在,则继续处理所有剩余的文件。如果没有
--force
,则 mysqlimport 在表不存在时退出。-
命令行格式 --get-server-public-key
类型 布尔值 从服务器请求基于 RSA 密钥对的密码交换所需的公钥。此选项适用于使用
caching_sha2_password
身份验证插件进行身份验证的客户端。对于该插件,服务器不会发送公钥,除非请求。此选项将被忽略,用于不使用该插件进行身份验证的帐户。如果未使用基于 RSA 的密码交换,也会忽略它,例如当客户端使用安全连接连接到服务器时。如果给出
--server-public-key-path=
并指定一个有效的公钥文件,它优先于file_name
--get-server-public-key
。有关
caching_sha2_password
插件的信息,请参见 第 8.4.1.1 节,“缓存 SHA-2 可插拔身份验证”。 --host=
,host_name
-h
host_name
命令行格式 --host=host_name
类型 字符串 默认值 localhost
将数据导入给定主机上的 MySQL 服务器。默认主机为
localhost
。--ignore
,-i
命令行格式 --ignore
请参见
--replace
选项的描述。-
命令行格式 --ignore-lines=#
类型 数字 忽略数据文件的前
N
行。 -
命令行格式 --lines-terminated-by=string
类型 字符串 此选项与
LOAD DATA
的相应子句具有相同的含义。例如,要导入以回车/换行符对结尾的行结尾的行结束符结尾的 Windows 文件,请使用--lines-terminated-by="\r\n"
。(您可能需要将反斜杠加倍,具体取决于命令解释器的转义约定。)请参见 第 15.2.9 节,“LOAD DATA 语句”。 --local
,-L
命令行格式 --local
类型 布尔值 默认值 FALSE
默认情况下,文件由服务器在服务器主机上读取。使用此选项,mysqlimport 在客户端主机上本地读取输入文件。
在 mysqlimport 中成功使用
LOCAL
加载操作还需要服务器允许本地加载;请参见 第 8.1.6 节,“LOAD DATA LOCAL 的安全注意事项”--lock-tables
,-l
命令行格式 --lock-tables
在处理任何文本文件之前,锁定 所有 表以供写入。这确保了所有表在服务器上同步。
-
命令行格式 --login-path=name
类型 字符串 从
.mylogin.cnf
登录路径文件中的命名登录路径中读取选项。“登录路径” 是一个选项组,其中包含指定要连接的 MySQL 服务器以及要以哪个帐户进行身份验证的选项。要创建或修改登录路径文件,请使用 mysql_config_editor 实用程序。请参见 第 6.6.7 节,“mysql_config_editor — MySQL 配置实用程序”。有关此选项和其他选项文件选项的更多信息,请参见 第 6.2.2.3 节,“影响选项文件处理的命令行选项”。
-
命令行格式 --no-login-paths
跳过从登录路径文件读取选项。
有关相关信息,请参见
--login-path
。有关此选项和其他选项文件选项的更多信息,请参见 第 6.2.2.3 节,“影响选项文件处理的命令行选项”。
-
命令行格式 --low-priority
在加载表时使用
LOW_PRIORITY
。这仅影响仅使用表级锁定的存储引擎(例如MyISAM
、MEMORY
和MERGE
)。 -
命令行格式 --no-defaults
不读取任何选项文件。如果程序启动时由于读取选项文件中的未知选项而失败,可以使用
--no-defaults
来阻止读取这些选项。例外情况是,如果存在
.mylogin.cnf
文件,则始终会读取它。即使使用--no-defaults
,这也可以让密码以比命令行更安全的方式指定。要创建.mylogin.cnf
,请使用 mysql_config_editor 实用程序。参见 第 6.6.7 节,“mysql_config_editor — MySQL 配置实用程序”.有关此选项和其他选项文件选项的更多信息,请参见 第 6.2.2.3 节,“影响选项文件处理的命令行选项”。
--password[=
,password
]-p[
password
]命令行格式 --password[=password]
类型 字符串 用于连接到服务器的 MySQL 帐户的密码。密码值是可选的。如果未提供,则 mysqlimport 会提示输入密码。如果提供了密码,则
--password=
或-p
与其后的密码之间 不能有空格。如果未指定密码选项,则默认不发送任何密码。在命令行上指定密码被认为是不安全的。为避免在命令行上提供密码,请使用选项文件。参见 第 8.1.2.1 节,“密码安全的用户指南”.
要明确指定没有密码,并且 mysqlimport 不应该提示输入密码,请使用
--skip-password
选项。用于连接到服务器的 MySQL 帐户的多因素身份验证因子 1 的密码。密码值是可选的。如果未提供,则 mysqlimport 会提示输入密码。如果提供了密码,则
--password1=
与其后的密码之间 不能有空格。如果未指定密码选项,则默认不发送任何密码。在命令行上指定密码被认为是不安全的。为避免在命令行上提供密码,请使用选项文件。参见 第 8.1.2.1 节,“密码安全的用户指南”.
要明确指定没有密码,并且 mysqlimport 不应该提示输入密码,请使用
--skip-password1
选项。--password1
和--password
是同义词,--skip-password1
和--skip-password
也是同义词。用于连接到服务器的 MySQL 帐户的多因素身份验证因子 2 的密码。此选项的语义类似于
--password1
的语义;有关详细信息,请参见该选项的说明。用于连接到服务器的 MySQL 帐户的多因素身份验证因子 3 的密码。此选项的语义类似于
--password1
的语义;有关详细信息,请参见该选项的说明。--pipe
,-W
命令行格式 --pipe
类型 字符串 在 Windows 上,使用命名管道连接到服务器。此选项仅在服务器使用启用了
named_pipe
系统变量以支持命名管道连接的情况下适用。此外,进行连接的用户必须是named_pipe_full_access_group
系统变量指定的 Windows 组的成员。-
命令行格式 --plugin-dir=dir_name
类型 目录名称 查找插件的目录。如果使用
--default-auth
选项指定身份验证插件,但 mysqlimport 找不到它,请指定此选项。参见 第 8.2.17 节,“可插拔身份验证”. --port=
,port_num
-P
port_num
命令行格式 --port=port_num
类型 数字 默认值 3306
对于 TCP/IP 连接,要使用的端口号。
-
命令行格式 --print-defaults
打印程序名称及其从选项文件获取的所有选项。
有关此选项和其他选项文件选项的更多信息,请参见 第 6.2.2.3 节,“影响选项文件处理的命令行选项”。
--protocol={TCP|SOCKET|PIPE|MEMORY}
命令行格式 --protocol=type
类型 字符串 默认值 [参见文本]
有效值 TCP
SOCKET
PIPE
MEMORY
用于连接到服务器的传输协议。当其他连接参数通常导致使用除所需协议以外的协议时,它很有用。有关允许值的详细信息,请参见 第 6.2.7 节,“连接传输协议”.
--replace
,-r
命令行格式 --replace
--replace
和--ignore
选项控制对重复现有唯一键值行输入行的处理。如果指定--replace
,则新行将替换具有相同唯一键值的现有行。如果指定--ignore
,则将跳过重复现有唯一键值行的输入行。如果未指定任何选项,则当找到重复键值时会发生错误,并且会忽略文本文件的其余部分。--server-public-key-path=
file_name
命令行格式 --server-public-key-path=file_name
类型 文件名 指向包含服务器为基于 RSA 密钥对的密码交换所需的公钥的客户端副本的 PEM 格式文件的路径名。此选项适用于使用
sha256_password
或caching_sha2_password
身份验证插件进行身份验证的客户端。此选项对于不使用其中一个插件进行身份验证的帐户将被忽略。如果未使用基于 RSA 的密码交换,则该选项也会被忽略,例如客户端通过安全连接连接到服务器时的情况。如果给出
--server-public-key-path=
并指定一个有效的公钥文件,它优先于file_name
--get-server-public-key
。对于
sha256_password
,此选项仅在 MySQL 使用 OpenSSL 构建的情况下适用。有关
sha256_password
和caching_sha2_password
插件的信息,请参见 第 8.4.1.2 节,“SHA-256 可插拔身份验证” 和 第 8.4.1.1 节,“缓存 SHA-2 可插拔身份验证”.--shared-memory-base-name=
name
命令行格式 --shared-memory-base-name=name
平台特定 Windows 在 Windows 上,要使用共享内存连接到本地服务器,请使用共享内存名称。默认值为
MYSQL
。共享内存名称区分大小写。此选项仅在服务器使用启用了
shared_memory
系统变量以支持共享内存连接的情况下适用。--silent
,-s
命令行格式 --silent
静默模式。仅在发生错误时产生输出。
--socket=
,path
-S
path
命令行格式 --socket={file_name|pipe_name}
类型 字符串 对于连接到
localhost
,要使用的 Unix 套接字文件,或在 Windows 上,要使用的命名管道的名称。在 Windows 上,此选项仅在服务器使用启用了
named_pipe
系统变量以支持命名管道连接的情况下适用。此外,进行连接的用户必须是named_pipe_full_access_group
系统变量指定的 Windows 组的成员。以
--ssl
开头的选项指定是否使用加密连接到服务器,并指示在哪里找到 SSL 密钥和证书。参见 加密连接的命令选项.--ssl-fips-mode={OFF|ON|STRICT}
命令行格式 --ssl-fips-mode={OFF|ON|STRICT}
已弃用 是 类型 枚举 默认值 OFF
有效值 OFF
ON
STRICT
控制是否在客户端启用 FIPS 模式。
--ssl-fips-mode
选项与其他--ssl-
选项不同,因为它不用于建立加密连接,而是用于影响允许的加密操作。参见 第 8.8 节,“FIPS 支持”.xxx
以下
--ssl-fips-mode
值是允许的OFF
:禁用 FIPS 模式。ON
:启用 FIPS 模式。STRICT
:启用 “严格” FIPS 模式。
注意如果 OpenSSL FIPS 对象模块不可用,则
--ssl-fips-mode
唯一允许的值为OFF
。在这种情况下,将--ssl-fips-mode
设置为ON
或STRICT
会导致客户端在启动时产生警告并在非 FIPS 模式下运行。此选项已弃用。预计将在 MySQL 的未来版本中将其删除。
--tls-ciphersuites=
ciphersuite_list
命令行格式 --tls-ciphersuites=ciphersuite_list
类型 字符串 使用 TLSv1.3 的加密连接的允许密码套件。该值是一个或多个冒号分隔的密码套件名称列表。可以为此选项命名的密码套件取决于用于编译 MySQL 的 SSL 库。有关详细信息,请参见 第 8.3.2 节,“加密连接 TLS 协议和密码”.
--tls-sni-servername=
server_name
命令行格式 --tls-sni-servername=server_name
类型 字符串 指定此选项时,名称将使用
MYSQL_OPT_TLS_SNI_SERVERNAME
选项通过mysql_options()
传递到libmysqlclient
C API 库。服务器名称不区分大小写。要查看客户端为当前会话指定了哪个服务器名称(如果有),请检查Tls_sni_server_name
状态变量。服务器名称指示 (SNI) 是 TLS 协议的扩展(必须使用 TLS 扩展编译 OpenSSL,此选项才能正常工作)。MySQL 对 SNI 的实现仅代表客户端。
-
命令行格式 --tls-version=protocol_list
类型 字符串 默认值 TLSv1,TLSv1.1,TLSv1.2,TLSv1.3
(OpenSSL 1.1.1 或更高版本)TLSv1,TLSv1.1,TLSv1.2
(否则)用于加密连接的允许 TLS 协议。该值是包含一个或多个以逗号分隔的协议名称的列表。此选项可以指定的协议取决于用于编译 MySQL 的 SSL 库。有关详细信息,请参见 第 8.3.2 节,“加密连接 TLS 协议和密码”。
--user=
,user_name
-u
user_name
命令行格式 --user=user_name,
类型 字符串 用于连接到服务器的 MySQL 帐户的用户名。
-
命令行格式 --use-threads=#
类型 数字 使用
N
个线程并行加载文件。 --verbose
,-v
命令行格式 --verbose
详细模式。打印有关程序执行操作的更多信息。
--version
,-V
命令行格式 --version
显示版本信息并退出。
--zstd-compression-level=
level
命令行格式 --zstd-compression-level=#
类型 整数 用于与使用
zstd
压缩算法的服务器连接的压缩级别。允许的级别为 1 到 22,值越大表示压缩级别越高。默认的zstd
压缩级别为 3。压缩级别设置对不使用zstd
压缩的连接没有影响。有关更多信息,请参见 第 6.2.8 节,“连接压缩控制”。
以下是一个示例会话,演示了 mysqlimport 的使用。
$> 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 |
+------+---------------+