Documentation Home
MySQL 8.0 参考手册  / 第 5 章 MySQL 服务器管理  / 5.1 MySQL 服务器  /  5.1.6 服务器命令选项

5.1.6 服务器命令选项

当您启动mysqld服务器时,您可以使用 第 4.2.2 节,“指定程序选项”中描述的任何方法指定程序选项。最常见的方法是在选项文件或命令行中提供选项。但是,在大多数情况下,最好确保服务器每次运行时都使用相同的选项。确保这一点的最佳方法是将它们列在选项文件中。请参见 第 4.2.2.2 节,“使用选项文件”。该部分还描述了选项文件格式和语法。

mysqld[mysqld][server] 组中读取选项。mysqld_safe[mysqld][server][mysqld_safe][safe_mysqld]组中读取选项。 mysql.server[mysqld][mysql.server] 组中读取选项。

嵌入式 MySQL 服务器通常从 、 和 组中读取选项 [server][embedded]其中 是服务器所嵌入的应用程序的名称。 [xxxxx_SERVER]xxxxx

mysqld接受许多命令选项。如需简要总结,请执行以下命令:

mysqld --help

要查看完整列表,请使用以下命令:

mysqld --verbose --help

列表中的一些项目实际上是可以在服务器启动时设置的系统变量。这些可以在运行时使用SHOW VARIABLES语句显示。前面的mysqld 命令显示的一些项目没有出现在SHOW VARIABLES输出中;这是因为它们只是选项而不是系统变量。

以下列表显示了一些最常见的服务器选项。其他部分描述了其他选项:

一些选项控制缓冲区或高速缓存的大小。对于给定的缓冲区,服务器可能需要分配内部数据结构。这些结构通常是从分配给缓冲区的总内存中分配的,所需的空间量可能取决于平台。这意味着当您为控制缓冲区大小的选项分配一个值时,实际可用的空间量可能与分配的值不同。在某些情况下,金额可能小于分配的值。也有可能是服务器向上调整了一个值。例如,如果将值 0 分配给最小值为 1024 的选项,则服务器会将值设置为 1024。

除非另有说明,否则缓冲区大小、长度和堆栈大小的值以字节为单位给出。

一些选项采用文件名值。除非另有说明,否则如果值为相对路径名,则默认文件位置为数据目录。要明确指定位置,请使用绝对路径名。假设数据目录是 /var/mysql/data. 如果文件值选项作为相对路径名给出,则它位于 /var/mysql/data. 如果该值是绝对路径名,则其位置由路径名给出。

您还可以使用变量名作为选项在服务器启动时设置服务器系统变量的值。要为服务器系统变量赋值,请使用 形式的选项 。例如, 将变量的值设置为 32MB。 --var_name=value--key_buffer_size=32Mkey_buffer_size

当您为变量赋值时,MySQL 可能会自动更正该值以保持在给定范围内,或者如果仅允许某些值,则将值调整为最接近的允许值。

要限制系统变量可以在运行时使用语句设置的 最大值,请 在服务器启动时 SET 使用表单的选项指定此最大值 。--maximum-var_name=value

SET 您可以使用该语句 在运行时更改大多数系统变量的值。请参阅第 13.7.4.1 节,“变量赋值的 SET 语法”

第 5.1.7 节,“服务器系统变量”,提供了所有变量的完整描述,以及在服务器启动和运行时设置它们的附加信息。有关更改系统变量的信息,请参阅 第 5.1.1 节,“配置服务器”

  • --help,-?

    命令行格式 --help

    显示一条简短的帮助消息并退出。使用 --verbose--help选项查看完整消息。

  • --allow-suspicious-udfs

    命令行格式 --allow-suspicious-udfs[={OFF|ON}]
    类型 布尔值
    默认值 OFF

    此选项控制是否可以加载仅具有xxxmain 函数符号的可加载函数。默认情况下,该选项是关闭的,只能加载至少有一个辅助符号的可加载函数;这可以防止尝试从包含合法函数的共享对象文件以外的共享对象文件加载函数。请参阅可加载函数安全预防措施

  • --ansi

    命令行格式 --ansi

    使用标准 (ANSI) SQL 语法而不是 MySQL 语法。为了更精确地控制服务器 SQL 模式,请改用该 --sql-mode选项。请参阅 第 1.7 节,“MySQL 标准合规性”第 5.1.10 节,“服务器 SQL 模式”

  • --basedir=dir_name, -b dir_name

    命令行格式 --basedir=dir_name
    系统变量 basedir
    范围 全球的
    动态的
    类型 目录名称
    默认值 configuration-dependent default

    MySQL 安装目录的路径。此选项设置basedir系统变量。

  • --bootstrap

    命令行格式 --bootstrap

    mysql_install_db程序 使用此选项 来创建 MySQL 特权表,而无需启动完整的 MySQL 服务器。

    每当使用此选项时,复制和全局事务标识符都会自动禁用(缺陷 #13992602)。请参阅第 17.1.3 节,“使用全局事务标识符进行复制”

    当服务器在引导程序模式下运行时,某些功能不可用,这些功能限制了init_file系统变量命名的任何文件中允许的语句。有关详细信息,请参阅该变量的说明。

  • --character-set-client-handshake

    命令行格式 --character-set-client-handshake[={OFF|ON}]
    类型 布尔值
    默认值 ON

    不要忽略客户端发送的字符集信息。要忽略客户端信息并使用默认服务器字符集,请使用 --skip-character-set-client-handshake; 这使得 MySQL 的行为类似于 MySQL 4.0。

  • --chroot=dir_name, -r dir_name

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

    使用系统调用在启动时 将mysqld服务器置于封闭环境中 。chroot()这是推荐的安全措施。

    笔记

    使用此选项在一定程度上限制了LOAD DATASELECT ... INTO OUTFILE

  • --console

    命令行格式 --console
    特定于平台 视窗

    (仅限 Windows。)将错误日志消息写入 stderrstdout(控制台)。如果使用此选项, mysqld不会关闭控制台窗口。

    --log-error--console如果两者都给出 ,则优先。

  • --core-file

    命令行格式 --core-file[={OFF|ON}]
    类型 布尔值
    默认值 OFF

    如果mysqld死了, 写一个核心文件。核心文件的名称和位置取决于系统。在 Linux 上,一个名为 core 的文件 被写入进程的当前工作目录,对于mysqld来说是数据目录。 表示服务器进程的进程 ID。在 macOS 上,一个名为的核心文件 被写入该目录。在 Solaris 上,使用coreadm命令指定核心文件的写入位置以及命名方式。 core.pidpidcore.pid/cores

    对于某些系统,要获得核心文件,您还必须指定 mysqld_safe--core-file-size选项 。参见 第 4.3.2 节,“mysqld_safe — MySQL 服务器启动脚本”。在某些系统(例如 Solaris)上,如果您也使用该 选项,则不会获得核心文件。可能会有额外的限制或限制。例如,可能需要 在启动服务器之前执行ulimit -c unlimited 。请查阅您的系统文档。 --user

  • --datadir=dir_name, -h dir_name

    命令行格式 --datadir=dir_name
    系统变量 datadir
    范围 全球的
    动态的
    类型 目录名称

    MySQL 服务器数据目录的路径。此选项设置datadir系统变量。请参阅该变量的说明。

  • --debug[=debug_options], -# [debug_options]

    命令行格式 --debug[=debug_options]
    系统变量 debug
    范围 全局,会话
    动态的 是的
    类型 细绳
    默认值 (Unix) d:t:i:o,/tmp/mysqld.trace
    默认值 (Windows) d:t:i:O,\mysqld.trace

    如果 MySQL 配置了 CMake选项,您可以使用此选项来获取mysqld正在执行的操作的跟踪文件。典型的字符串是 . 默认值是在 Unix 和Windows 上。 -DWITH_DEBUG=1 debug_optionsd:t:o,file_named:t:i:o,/tmp/mysqld.traced:t:i:O,\mysqld.trace

    使用-DWITH_DEBUG=1调试支持配置 MySQL 使您可以 --debug="d,parser_debug"在启动服务器时使用该选项。这会导致用于处理 SQL 语句的 Bison 解析器将解析器跟踪转储到服务器的标准错误输出。通常,此输出会写入错误日志。

    这个选项可以多次给出。以前一个值开头+-加上或减去前一个值的值。例如, 将值设置为 。 --debug=T --debug=+PP:T

    有关详细信息,请参阅第 5.8.3 节,“DBUG 包”

  • --debug-sync-timeout[=N]

    命令行格式 --debug-sync-timeout[=#]
    类型 整数

    控制是否启用用于测试和调试的调试同步工具。使用调试同步需要使用 CMake选项配置 MySQL(请参阅 第 2.9.7 节,“MySQL 源配置选项”)。如果未编译 Debug Sync,则此选项不可用。选项值是以秒为单位的超时。默认值为 0,即禁用调试同步。要启用它,请指定一个大于 0 的值;该值也成为各个同步点的默认超时值。如果选项没有值,则超时设置为 300 秒。 -DENABLE_DEBUG_SYNC=1

    有关调试同步工具的描述以及如何使用同步点,请参阅 MySQL 内部结构:测试同步

  • --default-authentication-plugin=plugin_name

    命令行格式 --default-authentication-plugin=plugin_name
    类型 枚举
    默认值 mysql_native_password
    有效值

    mysql_native_password

    sha256_password

    此选项设置默认身份验证插件。这些值是允许的:

    笔记

    在 MySQL 5.6.17 之前,如果您使用此选项将默认身份验证插件更改为 以外的值 mysql_native_password,则早于 MySQL 5.5.7 的客户端无法连接,因为它们不理解对身份验证协议的更改。

    在 MySQL 5.6 中,没有 --default-authentication-plugin option对应的 server 系统变量;要读取为此选项设置的值,您必须检查正在运行的 MySQL 服务器进程以查看在调用 mysqld时使用了哪些选项(如果有的话) (在 Linux 系统上,您可以使用ps ax | grep mysqld或类似的方式执行此操作),以及可能的服务器选项文件以及。这是一个已知问题,已在 MySQL 5.7 中解决。(缺陷 #68858,缺陷 #16595944)

    --default-authentication-plugin 值影响服务器操作的这些方面:

    • 它确定服务器将哪个身份验证插件分配给创建的新帐户 CREATE USER以及 GRANT未明确指定身份验证插件的语句。

    • old_passwords系统变量会影响使用mysql_native_passwordsha256_password身份验证插件的帐户 的密码散列。如果默认身份验证插件是这些插件之一,服务器将 old_passwords在启动时设置为插件密码哈希方法所需的值。

    • 对于使用以下任一语句创建的帐户,服务器将该帐户与默认身份验证插件相关联,并为该帐户分配给定的密码,并根据该插件的要求进行哈希处理:

      CREATE USER ... IDENTIFIED BY 'cleartext password';
      GRANT ...  IDENTIFIED BY 'cleartext password';
    • 对于使用以下任一语句创建的帐户,服务器将该帐户与默认身份验证插件相关联,并为该帐户分配给定的密码哈希(如果密码哈希具有插件要求的格式):

      CREATE USER ... IDENTIFIED BY PASSWORD 'encrypted password';
      GRANT ...  IDENTIFIED BY PASSWORD 'encrypted password';

      如果密码哈希不是默认身份验证插件要求的格式,则语句失败。

  • --default-time-zone=timezone

    命令行格式 --default-time-zone=name
    类型 细绳

    设置默认服务器时区。此选项设置全局 time_zone系统变量。如果没有给出该选项,则默认时区与系统时区相同(由 system_time_zone系统变量的值给出。

    变量system_time_zone不同于 . time_zone尽管它们可能具有相同的值,但后一个变量用于为每个连接的客户端初始化时区。请参阅第 5.1.13 节,“MySQL 服务器时区支持”

  • --defaults-extra-file=file_name

    在全局选项文件之后但(在 Unix 上)在用户选项文件之前读取此选项文件。如果该文件不存在或无法访问,则会发生错误。如果 file_name不是绝对路径名,则将其解释为相对于当前目录。如果使用它,这必须是命令行上的第一个选项。

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

  • --defaults-file=file_name

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

    笔记

    如果使用它,这必须是命令行上的第一个选项,除非服务器是使用 --defaults-fileand --install(或 --install-manual)选项启动的, --install(或 --install-manual)必须是第一个。

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

  • --defaults-group-suffix=str

    不仅要阅读通常的选项组,还要阅读具有通常名称和后缀 str. 例如, mysqld通常读取该 [mysqld]组。如果此选项作为 给出 --defaults-group-suffix=_othermysqld也会读取该 [mysqld_other]组。

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

  • --des-key-file=file_name

    命令行格式 --des-key-file=file_name

    从此文件中读取默认 DES 密钥。这些键由DES_ENCRYPT()DES_DECRYPT()函数使用。

  • --exit-info[=flags], -T [flags]

    命令行格式 --exit-info[=flags]
    类型 整数

    这是可用于调试mysqld服务器的不同标志的位掩码。除非您确切知道它的作用, 否则不要使用此选项!

  • --external-locking

    命令行格式 --external-locking[={OFF|ON}]
    类型 布尔值
    默认值 OFF

    启用外部锁定(系统锁定),默认情况下禁用。如果在 lockd不能完全工作的系统(如 Linux)上使用此选项,mysqld很容易死锁。

    要显式禁用外部锁定,请使用 --skip-external-locking.

    外部锁定仅影响 MyISAM表访问。有关更多信息,包括可以和不能使用它的条件,请参阅第 8.11.5 节,“外部锁定”

  • --flush

    命令行格式 --flush[={OFF|ON}]
    系统变量 flush
    范围 全球的
    动态的 是的
    类型 布尔值
    默认值 OFF

    在每个 SQL 语句之后将所有更改刷新(同步)到磁盘。通常,MySQL 仅在每个 SQL 语句之后才将所有更改写入磁盘,并让操作系统处理同步到磁盘的操作。请参阅 第 B.3.3.3 节,“如果 MySQL 持续崩溃怎么办”

    笔记

    如果--flush已指定,则 的值flush_time无关紧要,并且更改为 flush_time对刷新行为没有影响。

  • --gdb

    命令行格式 --gdb[={OFF|ON}]
    类型 布尔值
    默认值 OFF

    安装中断处理程序SIGINT (需要停止mysqld^C设置断点)并禁用堆栈跟踪和核心文件处理。参见 第 5.8.1.4 节,“在 gdb 下调试 mysqld”

  • --ignore-db-dir=dir_name

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

    此选项告诉服务器为了SHOW DATABASES语句或 INFORMATION_SCHEMA表的目的而忽略给定的目录名称。例如,如果 MySQL 配置将数据目录定位在 Unix 文件系统的根目录下,系统可能会在 lost+found那里创建一个服务器应该忽略的目录。使用 启动服务器 --ignore-db-dir=lost+found 会导致该名称不被列为数据库。

    要指定多个名称,请多次使用此选项,每个名称一次。将选项指定为空值(即 as --ignore-db-dir=)会将目录列表重置为空列表。

    服务器启动时给出的此选项的实例用于设置ignore_db_dirs系统变量。

  • --innodb-xxx

    InnoDB为存储引擎 设置一个选项。这些InnoDB选项列在 第 14.14 节,“InnoDB 启动选项和系统变量”中。

  • --install [service_name]

    命令行格式 --install [service_name]
    特定于平台 视窗

    (仅限 Windows)将服务器安装为在 Windows 启动期间自动启动的 Windows 服务。默认服务名称是MySQL如果没有 service_name给出值。有关详细信息,请参阅第 2.3.4.7 节,“将 MySQL 作为 Windows 服务启动”

    笔记

    如果服务器是用 --defaults-file--install选项启动的, --install必须是第一个。

  • --install-manual [service_name]

    命令行格式 --install-manual [service_name]
    特定于平台 视窗

    (仅限 Windows)将服务器安装为必须手动启动的 Windows 服务。它不会在 Windows 启动期间自动启动。默认服务名称是 MySQL如果没有 service_name给出值。有关详细信息,请参阅第 2.3.4.7 节,“将 MySQL 作为 Windows 服务启动”

    笔记

    如果服务器是用 --defaults-file--install-manual选项启动的, --install-manual必须是第一个。

  • --language=lang_name, -L lang_name

    命令行格式 --language=name
    弃用 是的; 改用lc-messages-dir_
    系统变量 language
    范围 全球的
    动态的
    类型 目录名称
    默认值 /usr/local/mysql/share/mysql/english/

    用于错误消息的语言。 lang_name可以作为语言名称或安装语言文件的目录的完整路径名给出。请参阅 第 10.12 节,“设置错误消息语言”

    --lc-messages-dirand --lc-messagesshould be used 而不是--language,它已被弃用并作为 的同义词处理 --lc-messages-dir。期望 --language在未来的 MySQL 版本中删除该选项。

  • --large-pages

    命令行格式 --large-pages[={OFF|ON}]
    系统变量 large_pages
    范围 全球的
    动态的
    特定于平台 Linux
    类型 布尔值
    默认值 OFF

    一些硬件/操作系统架构支持大于默认值(通常为 4KB)的内存页。这种支持的实际实现取决于底层硬件和操作系统。由于减少了转换后备缓冲区 (TLB) 未命中,执行大量内存访问的应用程序可以通过使用大页面来提高性能。

    MySQL 支持大页面支持的 Linux 实现(在 Linux 中称为 HugeTLB)。请参阅 第 8.12.4.2 节,“启用大页面支持”。有关 Solaris 对大页面的支持,请参阅该 --super-large-pages选项的描述。

    --large-pages默认情况下禁用。

  • --lc-messages=locale_name

    命令行格式 --lc-messages=name
    系统变量 lc_messages
    范围 全局,会话
    动态的 是的
    类型 细绳
    默认值 en_US

    用于错误消息的语言环境。默认值为 en_US。服务器将参数转换为语言名称并将其与 的值组合 --lc-messages-dir以生成错误消息文件的位置。请参阅 第 10.12 节,“设置错误消息语言”

  • --lc-messages-dir=dir_name

    命令行格式 --lc-messages-dir=dir_name
    系统变量 lc_messages_dir
    范围 全球的
    动态的
    类型 目录名称

    错误信息所在的目录。服务器使用该值和 的值 --lc-messages来生成错误消息文件的位置。请参阅 第 10.12 节,“设置错误消息语言”

  • --local-service

    命令行格式 --local-service

    (仅限 Windows)--local-service服务名称后面的选项会导致服务器使用 LocalService具有有限系统权限的 Windows 帐户运行。如果 --defaults-file--local-service都在服务名称之后给出,则它们的顺序可以是任意的。请参阅 第 2.3.4.7 节,“将 MySQL 作为 Windows 服务启动”

  • --log-error[=file_name]

    命令行格式 --log-error[=file_name]
    系统变量 log_error
    范围 全球的
    动态的
    类型 文件名

    将错误日志和启动消息写入此文件。请参阅 第 5.4.2 节,“错误日志”

    如果该选项没有命名文件,则 Unix 和类 Unix 系统上的错误日志文件名位于 host_name.err 数据目录中。Windows 上的文件名是相同的,除非--pid-file指定了该选项。.err在这种情况下,文件名是数据目录中 带有后缀的 PID 文件基本名称。

    如果选项命名文件,则错误日志文件具有该名称(.err如果名称没有后缀,则添加后缀)位于数据目录下,除非给出绝对路径名以指定不同的位置。

    在 Windows上,如果两者都给出 ,--log-error则优先。--console

  • --log-isam[=file_name]

    命令行格式 --log-isam[=file_name]
    类型 文件名

    记录对此文件的所有MyISAM更改(仅在调试时使用MyISAM)。

  • --log-raw

    命令行格式 --log-raw[={OFF|ON}]
    类型 布尔值
    默认值 OFF

    写入通用查询日志、慢查询日志和二进制日志的某些语句中的密码由服务器重写,不会以纯文本形式出现。--log-raw通过使用该选项启动服务器,可以抑制一般查询日志的密码重写 。此选项可用于诊断目的,以查看服务器接收到的语句的确切文本,但出于安全原因,不建议在生产中使用。

  • --log-short-format

    命令行格式 --log-short-format[={OFF|ON}]
    类型 布尔值
    默认值 OFF

    如果已激活,则将较少的信息记录到慢查询日志中。

  • --log-slow-admin-statements

    命令行格式 --log-slow-admin-statements[={OFF|ON}](5.6.10)
    删除 5.6.11
    类型 布尔值
    默认值 OFF

    在写入慢速查询日志的语句中包含慢速管理语句。行政报表包括ALTER TABLEANALYZE TABLECHECK TABLECREATE INDEXDROP INDEXOPTIMIZE TABLEREPAIR TABLE

    这个命令行选项在 MySQL 5.6.11 中被移除,并被 log_slow_admin_statements 系统变量取代。系统变量可以像选项一样在命令行或选项文件中设置,因此不需要在服务器启动时进行任何更改,但系统变量还可以在运行时检查或设置值。

  • --log-tc=file_name

    命令行格式 --log-tc=file_name
    类型 文件名
    默认值 tc.log

    内存映射事务协调器日志文件的名称(用于在禁用二进制日志时影响多个存储引擎的 XA 事务)。默认名称是 tc.log. 如果未作为完整路径名给出,则该文件将在数据目录下创建。此选项未使用。

  • --log-tc-size=size

    命令行格式 --log-tc-size=#
    类型 整数
    默认值 24576
    最大值(64 位平台) 18446744073709551615
    最大值(32 位平台) 4294967295

    内存映射事务协调器日志的大小(以字节为单位)。默认大小为 24KB。

  • --log-warnings[=level], -W [level]

    命令行格式 --log-warnings[=#]
    系统变量 log_warnings
    范围 全球的
    动态的 是的
    类型 整数
    默认值 1
    最小值 0
    最大值(64 位平台) 18446744073709551615
    最大值(32 位平台) 4294967295

    打印出诸如Aborted connection...错误日志之类的警告。默认情况下启用此选项 (1)。要禁用它,请使用 --log-warnings=0. 指定没有level值的选项会将当前值递增 1。建议通过将其设置为大于 0 来启用此选项,例如,如果您使用复制(您将获得有关正在发生的事情的更多信息,例如有关网络故障和重新连接的消息). 如果该值大于 1,则将中止的连接写入错误日志,并写入新连接尝试的拒绝访问错误。请参阅 第 B.3.2.10 节,“通信错误和中止连接”

    如果副本服务器在 --log-warnings启用时启动,则副本将消息打印到错误日志以提供有关其状态的信息,例如二进制日志和中继日志坐标它开始其工作的位置,它何时切换到另一个中继日志,何时它断开连接后重新连接,等等。--log-warnings如果大于 0 ,服务器将记录有关基于语句的日志记录不安全的语句的消息 。

  • --memlock

    命令行格式 --memlock[={OFF|ON}]
    类型 布尔值
    默认值 OFF

    将mysqld进程 锁定在内存中。如果您遇到操作系统导致mysqld交换到磁盘的问题,此选项可能会有所帮助。

    --memlock在支持mlockall()系统调用的系统上工作;这包括 Solaris、大多数使用 2.4 或更高内核的 Linux 发行版,可能还有其他 Unix 系统。在 Linux 系统上,您可以 mlockall()通过检查它是否在系统mman.h文件中定义来判断是否支持(以及此选项),如下所示:

    $> grep mlockall /usr/include/sys/mman.h

    如果mlockall()支持,您应该在上一个命令的输出中看到如下内容:

    extern int mlockall (int __flags) __THROW;
    重要的

    使用此选项可能需要您将服务器运行为 root,出于安全原因,这通常不是一个好主意。请参阅 第 6.1.5 节,“如何以普通用户身份运行 MySQL”

    在 Linux 和其他系统上,您可以root通过更改 limits.conf文件来避免运行服务器的需要。请参阅第 8.12.4.2 节“启用大页面支持”中有关 memlock 限制的注释 。

    您不得在不支持mlockall()系统调用的系统上使用此选项;如果这样做,mysqld很可能会在您尝试启动它时立即退出。

  • --myisam-block-size=N

    命令行格式 --myisam-block-size=#
    类型 整数
    默认值 1024
    最小值 1024
    最大值 16384

    用于MyISAM索引页的块大小。

  • --no-defaults

    不要读取任何选项文件。如果程序启动因从选项文件中读取未知选项而失败, --no-defaults可用于防止它们被读取。如果使用它,这必须是命令行上的第一个选项。

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

  • --old-style-user-limits

    命令行格式 --old-style-user-limits[={OFF|ON}]
    类型 布尔值
    默认值 OFF

    启用旧式用户限制。(在 MySQL 5.0.3 之前,帐户资源限制是针对用户连接的每个主机单独计算的,而不是 user表中的每个帐户行。)请参阅 第 6.2.13 节,“设置帐户资源限制”

  • --partition[=value]

    命令行格式 --partition[={OFF|ON}]
    被禁用 skip-partition
    类型 布尔值
    默认值 ON

    在 MySQL 服务器中启用或禁用用户定义的分区支持。

  • --performance-schema-xxx

    配置性能模式选项。有关详细信息,请参阅 第 22.14 节,“性能模式命令选项”

  • --plugin-load=plugin_list

    命令行格式 --plugin-load=plugin_list
    系统变量 plugin_load
    范围 全球的
    动态的
    类型 细绳

    此选项告诉服务器在启动时加载指定的插件。如果给出了多个 --plugin-load选项,则只有最后一个适用。可以使用 --plugin-load-add选项指定要加载的其他插件。

    选项值是以分号分隔的 plugin_library和 值列表。每个都是包含插件代码的库文件的名称,每个 都是要加载的插件的名称。如果一个插件库的命名没有任何前面的插件名称,服务器将加载库中的所有插件。使用前面的插件名称,服务器仅从库中加载指定的插件。服务器在系统变量 命名的目录中查找插件库文件 。name=plugin_libraryplugin_librarynameplugin_dir

    例如,如果名为myplug1myplug2的插件包含在插件库文件myplug1.somyplug2.so中,则使用此选项执行早期插件加载:

    mysqld --plugin-load="myplug1=myplug1.so;myplug2=myplug2.so"

    引号将参数值括起来,否则某些命令解释器会将分号 ( ;) 解释为特殊字符。(例如,Unix shell 将其视为命令终止符。)

    每个命名插件仅针对mysqld 的单次调用加载 。--plugin-load 重新启动后,除非再次使用,否则不会加载插件。这与 形成对比 INSTALL PLUGIN,后者向表中添加一个条目以mysql.plugins导致在每次正常的服务器启动时加载插件。

    在正常的启动序列中,服务器通过读取 mysql.plugins系统表来确定加载哪些插件。如果服务器以该 --skip-grant-tables选项启动,则表中注册的插件mysql.plugins 不会加载并且不可用。 --plugin-load即使在给定的情况下也能加载插件 --skip-grant-tables--plugin-load还允许在启动时加载无法在运行时加载的插件。

    有关插件加载的其他信息,请参阅 第 5.5.1 节,“安装和卸载插件”

  • --plugin-load-add=plugin_list

    命令行格式 --plugin-load-add=plugin_list
    系统变量 plugin_load_add
    范围 全球的
    动态的
    类型 细绳

    此选项是对 --plugin-load选项的补充。 --plugin-load-add将一个或多个插件添加到要在启动时加载的插件集中。参数格式与 for 相同 --plugin-load--plugin-load-add可用于避免将大量插件指定为单个冗长笨拙的--plugin-load 参数。

    --plugin-load-add可以在没有 的情况下给出 --plugin-load,但它的任何实例--plugin-load-add出现在 之前--plugin-load。没有效果,因为 --plugin-load重置了要加载的插件集。换句话说,这些选项:

    --plugin-load=x --plugin-load-add=y

    相当于这个选项:

    --plugin-load="x;y"

    但是这些选项:

    --plugin-load-add=y --plugin-load=x

    相当于这个选项:

    --plugin-load=x

    有关插件加载的其他信息,请参阅 第 5.5.1 节,“安装和卸载插件”

  • --plugin-xxx

    指定属于服务器插件的选项。例如,许多存储引擎可以构建为插件,对于这样的引擎,可以用 --plugin前缀指定它们的选项。因此, 可以将--innodb-file-per-table选项InnoDB指定为 --plugin-innodb-file-per-table

    对于可以启用或禁用的布尔选项, --skip前缀和其他替代格式也受支持(请参阅 第 4.2.2.4 节,“程序选项修饰符”)。例如, --skip-plugin-innodb-file-per-table 禁用innodb-file-per-table.

    前缀的基本原理--plugin是,如果名称与内置服务器选项发生冲突,它可以明确指定插件选项。例如,如果插件编写者将插件命名为 sql并实现mode选项,则选项名称可能是 --sql-mode,这将与同名的内置选项冲突。在这种情况下,将解决对冲突名称的引用,以支持内置选项。为避免歧义,用户可以将插件选项指定为 --plugin-sql-mode. 使用的 --plugin建议为插件选项添加前缀以避免任何歧义问题。

  • --port=port_num, -P port_num

    命令行格式 --port=port_num
    系统变量 port
    范围 全球的
    动态的
    类型 整数
    默认值 3306
    最小值 0
    最大值 65535

    侦听 TCP/IP 连接时使用的端口号。在 Unix 和类 Unix 系统上,端口号必须为 1024 或更高,除非服务器由 root操作系统用户启动。将此选项设置为 0 会导致使用默认值。

  • --port-open-timeout=num

    命令行格式 --port-open-timeout=#
    类型 整数
    默认值 0

    在某些系统上,当服务器停止时,TCP/IP 端口可能不会立即可用。如果服务器随后快速重新启动,则其重新打开端口的尝试可能会失败。此选项表示如果无法打开,服务器应等待 TCP/IP 端口空闲的秒数。默认是不等待。

  • --print-defaults

    打印程序名称和它从选项文件中获取的所有选项。如果使用它,它必须是命令行上的第一个选项,除非它可以紧接在--defaults-file或 之后使用--defaults-extra-file

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

  • --remove [service_name]

    命令行格式 --remove [service_name]
    特定于平台 视窗

    (仅限 Windows)删除 MySQL Windows 服务。默认服务名称是MySQL如果没有 service_name给出值。有关详细信息,请参阅第 2.3.4.7 节,“将 MySQL 作为 Windows 服务启动”

  • --safe-user-create

    命令行格式 --safe-user-create[={OFF|ON}]
    类型 布尔值
    默认值 OFF

    如果启用此选项,则用户无法使用该GRANT 语句创建新的 MySQL 用户,除非该用户具有 系统表或表中任何列的INSERT权限 。mysql.user如果您希望用户能够创建具有用户有权授予的权限的新用户,您应该授予用户以下权限:

    GRANT INSERT(user) ON mysql.user TO 'user_name'@'host_name';

    这样可以确保用户不能直接更改任何权限列,而必须使用 GRANT语句将权限授予其他用户。

  • --skip-grant-tables

    命令行格式 --skip-grant-tables[={OFF|ON}]
    类型 布尔值
    默认值 OFF

    此选项会影响服务器启动顺序:

  • --skip-host-cache

    命令行格式 --skip-host-cache

    禁用内部主机缓存以加快名称到 IP 的解析。禁用缓存后,服务器会在每次客户端连接时执行 DNS 查找。

    使用--skip-host-cache类似于将 host_cache_size系统变量设置为 0,但 host_cache_size更灵活,因为它还可以用于在运行时调整、启用或禁用主机缓存,而不仅仅是在服务器启动时。

    使用 启动服务器 --skip-host-cache不会阻止对 值的运行时更改 host_cache_size,但此类更改没有任何效果,即使 host_cache_size设置大于 0,也不会重新启用缓存。

    有关主机缓存如何工作的更多信息,请参阅 第 5.1.11.2 节,“DNS 查找和主机缓存”

  • --skip-innodb

    禁用InnoDB存储引擎。在这种情况下,因为默认存储引擎是 InnoDB,服务器无法启动,除非您还使用 --default-storage-engine并将 默认值设置为永久和表 --default-tmp-storage-engine的其他引擎 。TEMPORARY

    从 MySQL 5.6.21 开始,该 --skip-innodb 选项已弃用。它的使用会导致警告。期望在未来的 MySQL 版本中删除此选项。

  • --skip-new

    命令行格式 --skip-new

    此选项禁用(过去考虑的)新的、可能不安全的行为。它导致这些设置: delay_key_write=OFF, concurrent_insert=NEVER, automatic_sp_privileges=OFF。它还会导致OPTIMIZE TABLE 映射到不支持 ALTER TABLE的存储引擎。OPTIMIZE TABLE

  • --skip-partition

    命令行格式

    --skip-partition

    --disable-partition

    禁用用户定义的分区。可以使用SHOW TABLES或通过查询 表来查看分区表INFORMATION_SCHEMA.TABLES,但不能创建或修改,也不能访问此类表中的数据。表中所有特定于分区的列都 INFORMATION_SCHEMA.PARTITIONS 显示NULL.

    由于DROP TABLE删除了表定义 ( .frm) 文件,因此即使使用该选项禁用分区,此语句也适用于分区表。但是,在这种情况下,该语句不会删除 .par与分区表关联的文件。因此,您应该避免在禁用分区的情况下删除分区表,或者采取措施.par 手动删除孤立文件。

  • --skip-show-database

    命令行格式 --skip-show-database
    系统变量 skip_show_database
    范围 全球的
    动态的
    类型 布尔值
    默认值 OFF

    此选项设置 skip_show_database系统变量,该变量控制允许谁使用该 SHOW DATABASES语句。请参阅 第 5.1.7 节,“服务器系统变量”

  • --skip-stack-trace

    命令行格式 --skip-stack-trace

    不要写堆栈跟踪。当您在调试器下运行mysqld时,此选项很有用。在某些系统上,您还必须使用此选项来获取核心文件。参见 第 5.8 节,“调试 MySQL”

  • --slow-start-timeout=timeout

    命令行格式 --slow-start-timeout=#
    类型 整数
    默认值 15000

    此选项控制 Windows 服务控制管理器的服务启动超时。该值是服务控制管理器在启动期间尝试终止 Windows 服务之前等待的最大毫秒数。默认值为 15000(15 秒)。如果 MySQL 服务启动时间过长,您可能需要增加此值。值为 0 表示没有超时。

  • --socket=path

    命令行格式 --socket={file_name|pipe_name}
    系统变量 socket
    范围 全球的
    动态的
    类型 细绳
    默认值 (Windows) MySQL
    默认值(其他) /tmp/mysql.sock

    在 Unix 上,此选项指定侦听本地连接时要使用的 Unix 套接字文件。默认值为 /tmp/mysql.sock。如果给出此选项,服务器将在数据目录中创建文件,除非给出绝对路径名以指定不同的目录。在 Windows 上,该选项指定在侦听使用命名管道的本地连接时要使用的管道名称。默认值为MySQL(不区分大小写)。

  • --sql-mode=value[,value[,value...]]

    命令行格式 --sql-mode=name
    系统变量 sql_mode
    范围 全局,会话
    动态的 是的
    类型
    默认值 NO_ENGINE_SUBSTITUTION
    有效值

    ALLOW_INVALID_DATES

    ANSI_QUOTES

    ERROR_FOR_DIVISION_BY_ZERO

    HIGH_NOT_PRECEDENCE

    IGNORE_SPACE

    NO_AUTO_CREATE_USER

    NO_AUTO_VALUE_ON_ZERO

    NO_BACKSLASH_ESCAPES

    NO_DIR_IN_CREATE

    NO_ENGINE_SUBSTITUTION

    NO_FIELD_OPTIONS

    NO_KEY_OPTIONS

    NO_TABLE_OPTIONS

    NO_UNSIGNED_SUBTRACTION

    NO_ZERO_DATE

    NO_ZERO_IN_DATE

    ONLY_FULL_GROUP_BY

    PAD_CHAR_TO_FULL_LENGTH

    PIPES_AS_CONCAT

    REAL_AS_FLOAT

    STRICT_ALL_TABLES

    STRICT_TRANS_TABLES

    设置 SQL 模式。默认值为 NO_ENGINE_SUBSTITUTION。请参阅 第 5.1.10 节,“服务器 SQL 模式”

    笔记

    MySQL 安装程序可能会在安装过程中配置 SQL 模式。例如, mysql_install_db创建一个my.cnf在基本安装目录中命名的默认选项文件。该文件包含设置 SQL 模式的行;参见第 4.4.3 节,“mysql_install_db — 初始化 MySQL 数据目录”

    如果 SQL 模式不同于默认模式或您期望的模式,请检查服务器在启动时读取的选项文件中的设置。

  • --ssl, --skip-ssl

    命令行格式 --ssl[={OFF|ON}]
    被禁用 skip-ssl
    类型 布尔值
    默认值 OFF

    此选项指定服务器允许但不需要加密连接。 --ssl可以通过设置 系统变量来暗示,如这些变量的描述中所示。 ssl_xxx

    --ssl可以以否定形式指定为 --skip-ssl或同义词 ( --ssl=OFF, --disable-ssl)。在这种情况下,该选项指定服务器 不允许加密连接,无论 系统变量的设置如何。 ssl_xxx

    有关配置服务器是否允许客户端使用 SSL 连接以及指示在哪里可以找到 SSL 密钥和证书的更多信息,请参阅 第 6.3.1 节,“配置 MySQL 以使用加密连接”。考虑至少在服务器端设置ssl_certssl_key系统变量,在客户端设置 --ssl-ca(or --ssl-capath) 选项。

  • --standalone

    命令行格式 --standalone
    特定于平台 视窗

    仅适用于 Windows;指示 MySQL 服务器不作为服务运行。

  • --super-large-pages

    命令行格式 --super-large-pages[={OFF|ON}]
    特定于平台 索拉里斯
    类型 布尔值
    默认值 OFF

    MySQL 中大页面的标准使用尝试使用支持的最大大小,最多 4MB。在 Solaris 下, 超大页面功能允许使用高达 256MB 的页面。此功能可用于最新的 SPARC 平台。可以使用 --super-large-pages--skip-super-large-pages 选项启用或禁用它。

  • --symbolic-links, --skip-symbolic-links

    命令行格式 --symbolic-links[={OFF|ON}]
    类型 布尔值
    默认值 ON

    启用或禁用符号链接支持。此选项在 Windows 和 Unix 上有不同的效果:

  • --sysdate-is-now

    命令行格式 --sysdate-is-now[={OFF|ON}]
    类型 布尔值
    默认值 OFF

    SYSDATE()默认情况下返回它执行的时间,而不是它出现的语句开始执行的时间。这与 的行为不同NOW()。此选项导致SYSDATE()成为的同义词NOW()。有关二进制日志记录和复制的影响的信息,请参阅 SYSDATE()12.7 节“日期和时间函数”SET TIMESTAMP5.1.7 节“服务器系统变量”中的说明。

  • --tc-heuristic-recover={COMMIT|ROLLBACK}

    命令行格式 --tc-heuristic-recover=name
    类型 枚举
    默认值 OFF
    有效值

    OFF

    COMMIT

    ROLLBACK

    在手动启发式恢复中使用的决定。

    如果--tc-heuristic-recover指定了一个选项,则无论手动启发式恢复是否成功,服务器都会退出。

    在具有多个能够进行两阶段提交的存储引擎的系统上,该ROLLBACK选项不安全并导致恢复停止并出现以下错误:

    [ERROR] --tc-heuristic-recover rollback
    strategy is not safe on systems with more than one 2-phase-commit-capable
    storage engine. Aborting crash recovery.
  • --temp-pool

    命令行格式 --temp-pool[={OFF|ON}]
    类型 布尔值
    默认值 (Linux) ON
    默认值(其他) OFF

    除了在 Linux 上,此选项将被忽略。在 Linux 上,它会导致服务器创建的大多数临时文件使用一小组名称,而不是每个新文件的唯一名称。这解决了 Linux 内核中处理创建许多具有不同名称的新文件的问题。对于旧的行为,Linux 似乎泄漏了内存,因为它被分配到目录条目缓存而不是磁盘缓存。

  • --transaction-isolation=level

    命令行格式 --transaction-isolation=name
    类型 枚举
    默认值 REPEATABLE-READ
    有效值

    READ-UNCOMMITTED

    READ-COMMITTED

    REPEATABLE-READ

    SERIALIZABLE

    设置默认事务隔离级别。该 level值可以是 READ-UNCOMMITTEDREAD-COMMITTEDREPEATABLE-READSERIALIZABLE。请参阅 第 13.3.6 节,“SET TRANSACTION 语句”

    默认事务隔离级别也可以在运行时使用SET TRANSACTION语句或通过设置 tx_isolation系统变量来设置。

  • --transaction-read-only

    命令行格式 --transaction-read-only[={OFF|ON}]
    类型 布尔值
    默认值 OFF

    设置默认事务访问模式。默认情况下,只读模式是禁用的,所以模式是读/写。

    要在运行时设置默认事务访问模式,请使用 SET TRANSACTION语句或设置tx_read_only系统变量。请参阅第 13.3.6 节,“SET TRANSACTION 语句”

  • --tmpdir=dir_name, -t dir_name

    命令行格式 --tmpdir=dir_name
    系统变量 tmpdir
    范围 全球的
    动态的
    类型 目录名称

    用于创建临时文件的目录路径。/tmp 如果您的默认目录驻留在太小而无法容纳临时表的分区上,这可能很有用。此选项接受以循环方式使用的多个路径。路径应:在 Unix 上以冒号字符 ( ) 分隔;,在 Windows 上以分号字符 ( ) 分隔。

    --tmpdir可以是非永久位置,例如基于内存的文件系统上的目录或服务器主机重新启动时清除的目录。如果 MySQL 服务器充当副本,并且您使用的是非永久位置 ,请考虑使用系统变量--tmpdir为副本设置不同的临时目录 。slave_load_tmpdir对于副本,用于复制 LOAD DATA语句的临时文件存储在此目录中,因此如果临时文件已被删除,它们可以在机器重启后继续存在,但如果临时文件已被删除,复制现在可以在重启后继续。

    有关临时文件存储位置的更多信息,请参阅第 B.3.3.5 节,“MySQL 存储临时文件的位置”

  • --user={user_name|user_id}, -u {user_name|user_id}

    命令行格式 --user=name
    类型 细绳

    以具有名称或数字用户 ID 的用户身份 运行mysqld服务器。(在此上下文中的用户指的是系统登录帐户,而不是授权表中列出的 MySQL 用户。) user_nameuser_id

    启动 mysqld时, 此选项是必需的。服务器在其启动序列期间更改其用户 ID,导致它以该特定用户而不是 . 请参阅 第 6.1.1 节,“安全准则”rootroot

    为避免用户 --user=root向文件添加选项 my.cnf(从而导致服务器运行为root)的可能安全漏洞,mysqld 仅使用指定的第一个--user 选项并在有多个 --user选项时产生警告。/etc/my.cnf和 中的选项在 $MYSQL_HOME/my.cnf命令行选项之前进行处理,因此建议您将 --user选项放入 /etc/my.cnf并指定 . 以外的值root。中的选项在 /etc/my.cnf任何其他 --user选项之前找到,这确保服务器以非用户身份运行 root,如果--user找到任何其他选项,则会出现警告。

  • --validate-user-plugins[={OFF|ON}]

    命令行格式 --validate-user-plugins[={OFF|ON}]
    介绍 5.6.11
    类型 布尔值
    默认值 ON

    如果启用此选项(默认),服务器将检查每个用户帐户并在发现会使帐户无法使用的情况时发出警告:

    • 该帐户需要未加载的身份验证插件。

    • 该帐户需要 sha256_password身份验证插件,但服务器启动时未按此插件的要求启用 SSL 或 RSA。

    启用 --validate-user-plugins会减慢服务器初始化和FLUSH PRIVILEGES. 如果您不需要额外的检查,您可以在启动时禁用此选项以避免性能下降。

  • --verbose, -v

    将此选项与--help 详细帮助选项一起使用。

  • --version,-V

    显示版本信息并退出。