文档首页
MySQL 8.4 参考手册
相关文档 下载本手册
PDF (US Ltr) - 39.9Mb
PDF (A4) - 40.0Mb
手册页 (TGZ) - 258.5Kb
手册页 (Zip) - 365.5Kb
信息 (Gzip) - 4.0Mb
信息 (Zip) - 4.0Mb


MySQL 8.4 参考手册  /  ...  /  mysqlimport — 数据导入程序

6.5.5 mysqlimport — 数据导入程序

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

像这样调用 mysqlimport

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

对于命令行上命名的每个文本文件,mysqlimport 会删除文件名中的任何扩展名,并使用结果来确定要将文件内容导入到的表的名称。 例如,名为 patient.txtpatient.textpatient 的文件都将被导入到名为 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-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)
--plugin-dir 安装插件的目录
--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-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, -?

    命令行格式 --help

    显示帮助消息并退出。

  • --bind-address=ip_address

    命令行格式 --bind-address=ip_address

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

  • --character-sets-dir=dir_name

    命令行格式 --character-sets-dir=path
    类型 字符串
    默认值 [无]

    安装字符集的目录。请参阅 第 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

    命令行格式 --debug-check
    类型 布尔值
    默认值 FALSE

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

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

  • --debug-info

    命令行格式 --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

    命令行格式 --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

    命令行格式 --defaults-file=file_name
    类型 文件名

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

    例外:即使使用 --defaults-file,客户端程序也会读取 .mylogin.cnf

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

  • --defaults-group-suffix=str

    命令行格式 --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

    命令行格式 --enable-cleartext-plugin
    类型 布尔值
    默认值 FALSE

    启用 mysql_clear_password 明文身份验证插件。(请参阅 第 8.4.1.4 节,“客户端明文可插拔身份验证”。)

  • --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

    命令行格式 --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.2 节,“缓存 SHA-2 可插拔身份验证”

  • --host=host_name, -h host_name

    命令行格式 --host=host_name
    类型 字符串
    默认值 localhost

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

  • --ignore, -i

    命令行格式 --ignore

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

  • --ignore-lines=N

    命令行格式 --ignore-lines=#
    类型 数字

    忽略数据文件的前 N 行。

  • --lines-terminated-by=...

    命令行格式 --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

    命令行格式 --login-path=name
    类型 字符串

    .mylogin.cnf 登录路径文件中的命名登录路径读取选项。登录路径是一个选项组,其中包含指定要连接到哪个 MySQL 服务器以及要使用哪个帐户进行身份验证的选项。要创建或修改登录路径文件,请使用 mysql_config_editor 实用程序。请参阅 第 6.6.7 节,“mysql_config_editor — MySQL 配置实用程序”

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

  • --no-login-paths

    命令行格式 --no-login-paths

    跳过从登录路径文件读取选项。

    有关相关信息,请参阅 --login-path

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

  • --low-priority

    命令行格式 --low-priority

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

  • --no-defaults

    命令行格式 --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 选项。

  • --password1[=pass_val]

    用于连接到服务器的 MySQL 帐户的多因素身份验证因素 1 的密码。密码值是可选的。如果未给出,mysqlimport 会提示您输入一个密码。如果给出,--password1= 与后面的密码之间必须没有空格。如果没有指定密码选项,则默认情况下不发送密码。

    在命令行上指定密码应被视为不安全的。为避免在命令行上提供密码,请使用选项文件。请参阅 第 8.1.2.1 节 “最终用户密码安全指南”

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

    --password1--password 是同义词,--skip-password1--skip-password 也是如此。

  • --password2[=pass_val]

    用于连接到服务器的 MySQL 帐户的多因素身份验证因素 2 的密码。此选项的语义与 --password1 的语义类似;有关详细信息,请参阅该选项的说明。

  • --password3[=pass_val]

    用于连接到服务器的 MySQL 帐户的多因素身份验证因素 3 的密码。此选项的语义与 --password1 的语义类似;有关详细信息,请参阅该选项的说明。

  • --pipe, -W

    命令行格式 --pipe
    类型 字符串

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

  • --plugin-dir=dir_name

    命令行格式 --plugin-dir=dir_name
    类型 目录名称

    要在其中查找插件的目录。如果使用 --default-auth 选项指定身份验证插件,但 mysqlimport 未找到它,请指定此选项。请参阅 第 8.2.17 节 “可插拔身份验证”

  • --port=port_num, -P port_num

    命令行格式 --port=port_num
    类型 数字
    默认值 3306

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

  • --print-defaults

    命令行格式 --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(已弃用),仅当使用 OpenSSL 构建 MySQL 时,此选项才适用。

    有关 sha256_passwordcaching_sha2_password 插件的信息,请参阅 第 8.4.1.3 节 “SHA-256 可插拔身份验证”第 8.4.1.2 节 “缓存 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 密钥和证书。请参阅 加密连接的命令选项

  • --ssl-fips-mode={OFF|ON|STRICT}

    命令行格式 --ssl-fips-mode={OFF|ON|STRICT}
    已弃用
    类型 枚举
    默认值 OFF
    有效值

    OFF

    ON

    STRICT

    控制是否在客户端启用 FIPS 模式。--ssl-fips-mode 选项与其他 --ssl-xxx 选项的不同之处在于,它不是用于建立加密连接,而是用于影响允许哪些加密操作。请参阅 第 8.8 节 “FIPS 支持”

    允许使用以下 --ssl-fips-mode

    • OFF:禁用 FIPS 模式。

    • ON:启用 FIPS 模式。

    • STRICT:启用“严格 FIPS 模式。

    注意

    如果 OpenSSL FIPS 对象模块不可用,则 --ssl-fips-mode 唯一允许的值为 OFF。在这种情况下,将 --ssl-fips-mode 设置为 ONSTRICT 会导致客户端在启动时生成警告并以非 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=服务器名称
    类型 字符串

    如果指定,则使用 mysql_options()MYSQL_OPT_TLS_SNI_SERVERNAME 选项将名称传递给 libmysqlclient C API 库。服务器名称不区分大小写。要显示客户端为当前会话指定的服务器名称(如果有),请检查 Tls_sni_server_name 状态变量。

    服务器名称指示 (SNI) 是 TLS 协议的扩展(必须使用 TLS 扩展编译 OpenSSL 才能使此选项起作用)。MySQL 对 SNI 的实现仅代表客户端。

  • --tls-version=protocol_list

    命令行格式 --tls-version=协议列表
    类型 字符串
    默认值

    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=用户名,
    类型 字符串

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

  • --use-threads=N

    命令行格式 --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 |
+------+---------------+