6.5.5 mysqlpump — 数据库备份程序
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 支持以下选项,可以在命令行或选项文件中指定。关于MySQL程序使用的选项文件,请参阅第6.2.2.2节,“使用选项文件”.
Table 6.14 mysqlimport Options
Option Name | Description |
---|---|
--bind-address | 使用指定的网络接口连接到MySQL服务器 |
--character-sets-dir | 字符集目录 |
--columns | 该选项的值是一个逗号分隔的列名列表 |
--compress | 压缩客户端和服务器之间的所有信息 |
--compression-algorithms | 允许的压缩算法 |
--debug | 写入调试日志 |
--debug-check | 在程序退出时打印调试信息 |
--debug-info | 在程序退出时打印调试信息、内存和CPU统计信息 |
--default-auth | 使用的身份验证插件 |
--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 only) |
--plugin-dir | 插件安装目录 |
--port | TCP/IP连接端口号 |
--print-defaults | 打印默认选项 |
--protocol | 使用的传输协议 |
--replace | 控制输入行是否覆盖现有行 |
--server-public-key-path | RSA公共密钥文件路径 |
--shared-memory-base-name | 共享内存名称(Windows only) |
--silent | 只有在错误发生时输出 |
--socket | Unix套接字文件或Windows命名管道 |
--ssl-ca | 包含可信任SSL证书的文件 |
--ssl-capath | 包含可信任SSL证书的目录 |
--ssl-cert | 包含X.509证书的文件 |
--ssl-cipher | 连接加密时允许的加密算法 |
--ssl-crl | 包含证书撤销列表的文件 |
--ssl-crlpath | 包含证书撤销列表的目录 |
--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
,-?
Command-Line Format --help
显示帮助信息并退出。
-
Command-Line Format --bind-address=ip_address
在具有多个网络接口的计算机上,使用该选项选择要用于连接到MySQL服务器的接口。
-
Command-Line Format --character-sets-dir=path
Type 字符串 Default Value [none]
字符集安装目录。见第12.15节,“字符集配置”。
-
--columns=
,column_list
-c
column_list
Command-Line Format --columns=column_list
该选项将列名列表作为其值。列名顺序指示如何将数据文件列与表列匹配。
-
--compress
,-C
Command-Line Format --compress[={OFF|ON}]
Deprecated 是 Type 布尔 Default Value OFF
在客户端和服务器之间发送所有信息时,压缩所有信息。如果可能。请参阅第6.2.8节,“连接压缩控制”。
此选项已弃用。预计将在未来的MySQL版本中删除。请参阅配置 legacy 连接压缩。
-
--compression-algorithms=
value
Command-Line Format --compression-algorithms=value
Type 设置 Default Value uncompressed
Valid Values zlib
zstd
uncompressed
服务器连接的允许压缩算法。可用的算法与
protocol_compression_algorithms
系统变量相同。默认值为uncompressed
。更多信息,请参阅第6.2.8节,“连接压缩控制”。
-
--debug[=
,debug_options
]-# [
debug_options
]Command-Line Format --debug[=debug_options]
Type 字符串 Default Value d:t:o
写入调试日志。一个典型的
debug_options
字符串是d:t:o,<em class="replaceable">
。默认值为file_name
d:t:o
。此选项仅在使用
WITH_DEBUG
编译MySQL时可用。Oracle提供的MySQL发行版不使用该选项。 -
Command-Line Format --debug-check
Type 布尔 Default Value FALSE
在程序退出时打印一些调试信息。
此选项仅在使用
WITH_DEBUG
编译MySQL时可用。Oracle提供的MySQL发行版不使用该选项。 -
Command-Line Format --debug-info
Type Boolean Default Value FALSE
在程序退出时打印调试信息和内存和CPU使用统计。
这个选项只有在使用
WITH_DEBUG
编译MySQL时可用。Oracle提供的MySQL发行版不使用这个选项。 -
--default-character-set=
charset_name
Command-Line Format --default-character-set=charset_name
Type String 使用
charset_name
作为默认字符集。请参见第12.15节,“字符集配置”。 -
Command-Line Format --default-auth=plugin
Type String 关于客户端身份验证插件的提示。请参见第8.2.17节,“可插拔身份验证”。
-
--defaults-extra-file=
file_name
Command-Line Format --defaults-extra-file=file_name
Type File name 在全局选项文件后读取这个选项文件,但是在Unix系统上是在用户选项文件前读取。如果文件不存在或不可访问,出现错误。如果
file_name
不是绝对路径名,则将其解释为相对当前目录。关于这个选项文件和其他选项文件选项的更多信息,请参见第6.2.2.3节,“命令行选项影响选项文件处理”。
-
Command-Line Format --defaults-file=file_name
Type File name 只使用给定的选项文件。如果文件不存在或不可访问,出现错误。如果
file_name
不是绝对路径名,则将其解释为相对当前目录。例外:即使使用
--defaults-file
, 客户端程序仍然读取.mylogin.cnf
。关于此和其他选项文件选项的详细信息,请见第6.2.2.3节,“命令行选项影响选项文件处理”。
-
Command-Line Format --defaults-group-suffix=str
Type 字符串 不仅读取通常的选项组,还读取通常名称加上
str
的组。例如,mysqlimport通常读取[client]
和[mysqlimport]
组。如果给出--defaults-group-suffix=_other
,mysqlimport也读取[client_other]
和[mysqlimport_other]
组。关于此和其他选项文件选项的详细信息,请见第6.2.2.3节,“命令行选项影响选项文件处理”。
-
--delete
,-D
Command-Line Format --delete
在导入文本文件前清空表。
-
Command-Line Format --enable-cleartext-plugin
Type 布尔 Default Value FALSE
启用
mysql_clear_password
明文身份验证插件。 (见第8.4.1.4节,“客户端明文可插拔身份验证”。) -
--fields-terminated-by=...
,--fields-enclosed-by=...
,--fields-optionally-enclosed-by=...
,--fields-escaped-by=...
Command-Line Format --fields-terminated-by=string
Type 字符串 Command-Line Format --fields-enclosed-by=string
Type 字符串 Command-Line Format --fields-optionally-enclosed-by=string
Type 字符串 Command-Line Format --fields-escaped-by
Type 字符串 这些选项的含义与对应的子句相同,用于
LOAD DATA
。请参阅第15.2.9节,“LOAD DATA 语句”。 -
--force
,-f
Command-Line Format --force
忽略错误。例如,如果文本文件中不存在某个表,则继续处理其他文件。没有
--force
,mysqlimport将在遇到不存在的表时退出。 -
Command-Line Format --get-server-public-key
Type 布尔值 从服务器请求用于RSA密钥对密码交换的公钥。这选项适用于使用
身份验证插件的客户端。在该插件中,服务器不会发送公钥除非被请求。这选项将被忽略在不使用RSA密码交换的客户端连接服务器时。 如果指定了
--server-public-key-path=
,并且指定了有效的公钥文件,该选项将被忽略。file_name
关于
插件的信息,请参阅 第8.4.1.2节,“Caching SHA-2 Pluggable Authentication”。 -
--host=
,host_name
-h
host_name
Command-Line Format --host=host_name
Type 字符串 Default Value localhost
将数据导入到指定主机上的MySQL服务器。默认主机是
localhost。 -
--ignore
,-i
Command-Line Format --ignore
请参阅
--replace
选项的描述。 -
Command-Line Format --ignore-lines=#
Type 数字 忽略数据文件的前
N
行。 -
Command-Line Format --lines-terminated-by=字符串
Type 字符串 该选项的含义与对应的子句相同,用于
LOAD DATA
。例如,要导入Windows文件,其中每行以回车符/换行符对结尾,可以使用--lines-terminated-by="\r\n"
。 (您可能需要根据命令解释器的转义规则双倍反斜杠。)请参阅第15.2.9节,“LOAD DATA Statement”。 -
--local
,-L
Command-Line Format --local
Type 布尔 Default Value FALSE
默认情况下,文件由服务器在服务器主机上读取。使用该选项,mysqlimport 在客户端主机上读取输入文件。
使用
LOCAL
加载操作在mysqlimport中成功也需要服务器允许本地加载;请参阅第8.1.6节,“LOAD DATA LOCAL安全考虑” -
--lock-tables
,-l
Command-Line Format --lock-tables
锁定所有表,以便在处理任何文本文件之前锁定所有表。这确保了服务器上的所有表是同步的。
-
Command-Line Format --login-path=name
Type 字符串 从指定的登录路径中读取选项。登录路径是包含指定MySQL服务器连接到的选项组。要创建或修改登录路径文件,请使用mysql_config_editor实用工具。请参阅第6.6.7节,“mysql_config_editor — MySQL Configuration Utility”。
关于其他选项文件选项的详细信息,请参阅第6.2.2.3节,“Command-Line Options that Affect Option-File Handling”。
-
Command-Line Format --no-login-paths
忽略读取登录路径文件中的选项。
请参阅
--login-path
以获取相关信息。关于此选项文件选项的详细信息,请参阅第6.2.2.3节,“Command-Line Options that Affect Option-File Handling”.
-
Command-Line Format --low-priority
在加载表时使用LOW_PRIORITY。该选项仅影响使用表级锁定(如MyISAM、MEMORY和MERGE)存储引擎。
-
Command-Line Format --no-defaults
不读取任何选项文件。如果程序启动失败,因为读取了未知选项从选项文件中,
--no-defaults
可以防止它们被读取。唯一的例外是,.mylogin.cnf文件总是被读取,以便在安全地指定密码,即使使用
--no-defaults
。要创建.mylogin.cnf文件,请使用mysql_config_editor工具。请参阅第6.6.7节,“mysql_config_editor — MySQL Configuration Utility”.关于此选项文件选项的详细信息,请参阅第6.2.2.3节,“Command-Line Options that Affect Option-File Handling”.
-
--password[=
,password
]-p[
password
]Command-Line Format --password[=password]
Type 字符串 MySQL服务器连接账户的密码。密码值是可选的。如果不提供,mysqlimport将提示输入密码。如果提供,不能在密码后添加空格。没有指定密码选项,默认情况下不发送密码。
在命令行指定密码应该被认为是不安全的。为了避免在命令行上输入密码,请使用选项文件。见第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
Command-Line Format --pipe
Type String 在 Windows 上,使用命名管道连接到服务器。这选项仅适用于服务器在支持命名管道连接时启动,并且连接的用户必须是指定的 Windows 组的成员,该组由
named_pipe_full_access_group
系统变量指定。 -
Command-Line Format --plugin-dir=dir_name
Type 目录名称 指定插件所在的目录。如果使用
--default-auth
选项指定了身份验证插件,但mysqlimport无法找到它。请参阅第8.2.17节,“可插拔身份验证”。 -
--port=
,port_num
-P
port_num
Command-Line Format --port=port_num
Type 数字 Default Value 3306
用于 TCP/IP 连接的端口号。
-
Command-Line Format --print-defaults
打印程序名称和从选项文件获取的所有选项。
关于这类选项文件选项的更多信息,请参阅第6.2.2.3节,“命令行选项影响选项文件处理”。
-
--protocol={TCP|SOCKET|PIPE|MEMORY}
Command-Line Format --protocol=type
Type 字符串 Default Value [see text]
Valid Values TCP
SOCKET
PIPE
MEMORY
用于连接到服务器的传输协议。它在其他连接参数通常导致使用的协议不同时非常有用。关于可接受值的详细信息,请参阅第6.2.7节,“连接传输协议”。
-
--replace
,-r
Command-Line Format --replace
使用
--replace
和--ignore
选项可以控制输入行的处理,这些行在唯一键值上与现有行重复。如果您指定--replace
,则新的行将替换现有行具有相同唯一键值的行。如果您指定--ignore
,则输入行将跳过与现有行在唯一键值上重复的行。如果您不指定任何选项,遇到重复键值时将发生错误,并且剩余的文本文件将被忽略。 -
--server-public-key-path=
file_name
Command-Line Format --server-public-key-path=file_name
Type 文件名 服务器公钥文件的路径名,该文件包含了客户端用于RSA密钥对认证的公钥。这选项适用于使用
sha256_password
或caching_sha2_password
认证插件的客户端。如果服务器不使用RSA密钥对认证,这选项将被忽略。如果指定了
--server-public-key-path=
并指定了有效的公钥文件,它将优先于file_name
--get-server-public-key
。对于
sha256_password
,这选项仅适用于使用OpenSSL编译的MySQL。关于
sha256_password
和caching_sha2_password
插件的信息,请参见第8.4.1.3节,“SHA-256 Pluggable Authentication”和第8.4.1.2节,“Caching SHA-2 Pluggable Authentication”。 -
--shared-memory-base-name=
name
Command-Line Format --shared-memory-base-name=name
Platform Specific Windows 在Windows上,使用共享内存连接到本地服务器的共享内存名称。默认值为
MYSQL
。共享内存名称是大小写敏感的。这选项仅适用于服务器在启用共享内存连接时启动。
-
--silent
,-s
Command-Line Format --silent
静默模式。只在出现错误时输出结果。
-
--socket=
,path
-S
path
Command-Line Format --socket={file_name|pipe_name}
Type String 对于连接到
localhost
的Unix socket文件或在Windows上使用的命名管道的名称。在Windows上,这个选项仅在服务器启动时使用
named_pipe
系统变量来支持命名管道连接。此外,连接的用户必须是named_pipe_full_access_group
系统变量指定的Windows组成员。 -
以
--ssl
开头的选项指定是否使用加密连接,并指示SSL密钥和证书的位置。请参阅加密连接选项。 -
--ssl-fips-mode={OFF|ON|STRICT}
Command-Line Format --ssl-fips-mode={OFF|ON|STRICT}
Deprecated Yes Type Enumeration Default Value OFF
Valid Values OFF
ON
STRICT
控制客户端是否启用FIPS模式。与其他
--ssl-
选项不同的是,这个选项不是用于建立加密连接,而是影响哪些加密操作被允许。请参阅Section 8.8, “FIPS Support”。xxx
这些
--ssl-fips-mode
值是允许的:-
OFF
:禁用FIPS模式。 -
ON
:启用FIPS模式。 -
STRICT
:启用““strict”” FIPS 模式。
Note如果OpenSSL FIPS Object Module不可用,唯一允许的
--ssl-fips-mode
值是OFF
。在这种情况下,设置--ssl-fips-mode
到ON
或STRICT
将导致客户端在启动时产生警告,并在非FIPS模式下操作。该选项已弃用。预计将在未来的 MySQL 版本中删除。
-
-
--tls-ciphersuites=
ciphersuite_list
Command-Line Format --tls-ciphersuites=ciphersuite_list
Type 字符串 用于加密连接的TLSv1.3的可接受的加密套件。值是一个或多个以冒号分隔的加密套件名称列表。可以使用的加密套件名称取决于 MySQL 编译时使用的 SSL 库。详见第8.3.2节,“加密连接 TLS 协议和加密”。
-
--tls-sni-servername=
server_name
Command-Line Format --tls-sni-servername=server_name
Type 字符串 指定该名称将被传递给
libmysqlclient
C API 库使用MYSQL_OPT_TLS_SNI_SERVERNAME
选项mysql_options()
。服务器名称不区分大小写。要查看客户端当前会话中指定的服务器名称,如果有,请检查Tls_sni_server_name
状态变量。Server Name Indication (SNI) 是 TLS 协议的扩展(OpenSSL 必须使用 TLS 扩展才能使用该选项)。MySQL 的 SNI 实现仅代表客户端。
-
Command-Line Format --tls-version=protocol_list
Type 字符串 Default Value 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
Command-Line Format --user=user_name,
Type 字符串 MySQL 账户的用户名,以用于连接到服务器。
-
Command-Line Format --use-threads=#
Type 数字 使用
N
个线程并行加载文件。 -
--verbose
,-v
Command-Line Format --verbose
详细模式。打印程序执行的更多信息。
-
--version
,-V
Command-Line Format --version
显示版本信息并退出。
-
--zstd-compression-level=
level
Command-Line Format --zstd-compression-level=#
Type 整数 用于连接到使用
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 |
+------+---------------+