当您启动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
输出中;这是因为它们只是选项而不是系统变量。
以下列表显示了一些最常见的服务器选项。其他部分描述了其他选项:
影响安全的选项:参见 第 6.1.4 节,“与安全相关的 mysqld 选项和变量”。
SSL 相关选项:请参阅 加密连接的命令选项。
二进制日志控制选项:参见第 5.4.4 节,“二进制日志”。
与复制相关的选项:请参阅 第 17.1.4 节,“复制和二进制日志记录选项和变量”。
加载插件的选项,例如可插拔存储引擎:请参阅第 5.5.1 节,“安装和卸载插件”。
特定于特定存储引擎的选项:请参阅 第 14.14 节,“InnoDB 启动选项和系统变量”和 第 15.2.1 节,“MyISAM 启动选项”。
一些选项控制缓冲区或高速缓存的大小。对于给定的缓冲区,服务器可能需要分配内部数据结构。这些结构通常是从分配给缓冲区的总内存中分配的,所需的空间量可能取决于平台。这意味着当您为控制缓冲区大小的选项分配一个值时,实际可用的空间量可能与分配的值不同。在某些情况下,金额可能小于分配的值。也有可能是服务器向上调整了一个值。例如,如果将值 0 分配给最小值为 1024 的选项,则服务器会将值设置为 1024。
除非另有说明,否则缓冲区大小、长度和堆栈大小的值以字节为单位给出。
一些选项采用文件名值。除非另有说明,否则如果值为相对路径名,则默认文件位置为数据目录。要明确指定位置,请使用绝对路径名。假设数据目录是
/var/mysql/data
. 如果文件值选项作为相对路径名给出,则它位于
/var/mysql/data
. 如果该值是绝对路径名,则其位置由路径名给出。
您还可以使用变量名作为选项在服务器启动时设置服务器系统变量的值。要为服务器系统变量赋值,请使用 形式的选项
。例如,
将变量的值设置为 32MB。
--
var_name
=value
--key_buffer_size=32M
key_buffer_size
当您为变量赋值时,MySQL 可能会自动更正该值以保持在给定范围内,或者如果仅允许某些值,则将值调整为最接近的允许值。
要限制系统变量可以在运行时使用语句设置的
最大值,请
在服务器启动时
SET
使用表单的选项指定此最大值
。--maximum-
var_name
=value
SET
您可以使用该语句
在运行时更改大多数系统变量的值。请参阅第 13.7.4.1 节,“变量赋值的 SET 语法”。
第 5.1.7 节,“服务器系统变量”,提供了所有变量的完整描述,以及在服务器启动和运行时设置它们的附加信息。有关更改系统变量的信息,请参阅 第 5.1.1 节,“配置服务器”。
--help
,-?
命令行格式 --help
-
命令行格式 --allow-suspicious-udfs[={OFF|ON}]
类型 布尔值 默认值 OFF
此选项控制是否可以加载仅具有
xxx
main 函数符号的可加载函数。默认情况下,该选项是关闭的,只能加载至少有一个辅助符号的可加载函数;这可以防止尝试从包含合法函数的共享对象文件以外的共享对象文件加载函数。请参阅可加载函数安全预防措施。 -
命令行格式 --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
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 DATA
和SELECT ... INTO OUTFILE
。-
命令行格式 --console
特定于平台 视窗 (仅限 Windows。)将错误日志消息写入
stderr
和stdout
(控制台)。如果使用此选项, mysqld不会关闭控制台窗口。--log-error
--console
如果两者都给出 ,则优先。 -
命令行格式 --core-file[={OFF|ON}]
类型 布尔值 默认值 OFF
如果mysqld死了, 写一个核心文件。核心文件的名称和位置取决于系统。在 Linux 上,一个名为 core 的文件 被写入进程的当前工作目录,对于mysqld来说是数据目录。 表示服务器进程的进程 ID。在 macOS 上,一个名为的核心文件 被写入该目录。在 Solaris 上,使用coreadm命令指定核心文件的写入位置以及命名方式。
core.
pid
pid
core.
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_options
d:t:o,
file_name
d:t:i:o,/tmp/mysqld.trace
d:t:i:O,\mysqld.trace
使用
-DWITH_DEBUG=1
调试支持配置 MySQL 使您可以--debug="d,parser_debug"
在启动服务器时使用该选项。这会导致用于处理 SQL 语句的 Bison 解析器将解析器跟踪转储到服务器的标准错误输出。通常,此输出会写入错误日志。这个选项可以多次给出。以前一个值开头
+
或-
加上或减去前一个值的值。例如, 将值设置为 。--debug=T
--debug=+P
P:T
有关详细信息,请参阅第 5.8.3 节,“DBUG 包”。
-
命令行格式 --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_native_password
:使用MySQL本机密码;请参阅 第 6.4.1.1 节,“本机可插入身份验证”。sha256_password
:使用 SHA-256 密码;请参阅第 6.4.1.4 节,“SHA-256 可插入身份验证”。
笔记在 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_password
或sha256_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=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 节,“影响选项文件处理的命令行选项”。
只读给定的选项文件。如果该文件不存在或无法访问,则会发生错误。如果
file_name
不是绝对路径名,则将其解释为相对于当前目录。笔记如果使用它,这必须是命令行上的第一个选项,除非服务器是使用
--defaults-file
and--install
(或--install-manual
)选项启动的,--install
(或--install-manual
)必须是第一个。有关此选项和其他选项文件选项的其他信息,请参阅第 4.2.2.3 节,“影响选项文件处理的命令行选项”。
不仅要阅读通常的选项组,还要阅读具有通常名称和后缀
str
. 例如, mysqld通常读取该[mysqld]
组。如果此选项作为 给出--defaults-group-suffix=_other
, mysqld也会读取该[mysqld_other]
组。有关此选项和其他选项文件选项的其他信息,请参阅第 4.2.2.3 节,“影响选项文件处理的命令行选项”。
-
命令行格式 --des-key-file=file_name
从此文件中读取默认 DES 密钥。这些键由
DES_ENCRYPT()
和DES_DECRYPT()
函数使用。 --exit-info[=
,flags
]-T [
flags
]命令行格式 --exit-info[=flags]
类型 整数 这是可用于调试mysqld服务器的不同标志的位掩码。除非您确切知道它的作用, 否则不要使用此选项!
-
命令行格式 --external-locking[={OFF|ON}]
类型 布尔值 默认值 OFF
启用外部锁定(系统锁定),默认情况下禁用。如果在
lockd
不能完全工作的系统(如 Linux)上使用此选项,mysqld很容易死锁。要显式禁用外部锁定,请使用
--skip-external-locking
.外部锁定仅影响
MyISAM
表访问。有关更多信息,包括可以和不能使用它的条件,请参阅第 8.11.5 节,“外部锁定”。 -
命令行格式 --flush[={OFF|ON}]
系统变量 flush
范围 全球的 动态的 是的 类型 布尔值 默认值 OFF
在每个 SQL 语句之后将所有更改刷新(同步)到磁盘。通常,MySQL 仅在每个 SQL 语句之后才将所有更改写入磁盘,并让操作系统处理同步到磁盘的操作。请参阅 第 B.3.3.3 节,“如果 MySQL 持续崩溃怎么办”。
笔记如果
--flush
已指定,则 的值flush_time
无关紧要,并且更改为flush_time
对刷新行为没有影响。 -
命令行格式 --gdb[={OFF|ON}]
类型 布尔值 默认值 OFF
安装中断处理程序
SIGINT
(需要停止mysqld以^C
设置断点)并禁用堆栈跟踪和核心文件处理。参见 第 5.8.1.4 节,“在 gdb 下调试 mysqld”。 -
命令行格式 --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]
特定于平台 视窗 (仅限 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
, -Llang_name
命令行格式 --language=name
弃用 是的; 改用 lc-messages-dir
_系统变量 language
范围 全球的 动态的 不 类型 目录名称 默认值 /usr/local/mysql/share/mysql/english/
用于错误消息的语言。
lang_name
可以作为语言名称或安装语言文件的目录的完整路径名给出。请参阅 第 10.12 节,“设置错误消息语言”。--lc-messages-dir
and--lc-messages
should be used 而不是--language
,它已被弃用并作为 的同义词处理--lc-messages-dir
。期望--language
在未来的 MySQL 版本中删除该选项。-
命令行格式 --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=name
系统变量 lc_messages
范围 全局,会话 动态的 是的 类型 细绳 默认值 en_US
用于错误消息的语言环境。默认值为
en_US
。服务器将参数转换为语言名称并将其与 的值组合--lc-messages-dir
以生成错误消息文件的位置。请参阅 第 10.12 节,“设置错误消息语言”。 -
命令行格式 --lc-messages-dir=dir_name
系统变量 lc_messages_dir
范围 全球的 动态的 不 类型 目录名称 错误信息所在的目录。服务器使用该值和 的值
--lc-messages
来生成错误消息文件的位置。请参阅 第 10.12 节,“设置错误消息语言”。 -
命令行格式 --local-service
(仅限 Windows)
--local-service
服务名称后面的选项会导致服务器使用LocalService
具有有限系统权限的 Windows 帐户运行。如果--defaults-file
和--local-service
都在服务名称之后给出,则它们的顺序可以是任意的。请参阅 第 2.3.4.7 节,“将 MySQL 作为 Windows 服务启动”。 -
命令行格式 --log-error[=file_name]
系统变量 log_error
范围 全球的 动态的 不 类型 文件名 将错误日志和启动消息写入此文件。请参阅 第 5.4.2 节,“错误日志”。
如果该选项没有命名文件,则 Unix 和类 Unix 系统上的错误日志文件名位于
数据目录中。Windows 上的文件名是相同的,除非host_name
.err--pid-file
指定了该选项。.err
在这种情况下,文件名是数据目录中 带有后缀的 PID 文件基本名称。如果选项命名文件,则错误日志文件具有该名称(
.err
如果名称没有后缀,则添加后缀)位于数据目录下,除非给出绝对路径名以指定不同的位置。在 Windows上,如果两者都给出 ,
--log-error
则优先。--console
-
命令行格式 --log-isam[=file_name]
类型 文件名 记录对此文件的所有
MyISAM
更改(仅在调试时使用MyISAM
)。 -
命令行格式 --log-raw[={OFF|ON}]
类型 布尔值 默认值 OFF
写入通用查询日志、慢查询日志和二进制日志的某些语句中的密码由服务器重写,不会以纯文本形式出现。
--log-raw
通过使用该选项启动服务器,可以抑制一般查询日志的密码重写 。此选项可用于诊断目的,以查看服务器接收到的语句的确切文本,但出于安全原因,不建议在生产中使用。 -
命令行格式 --log-short-format[={OFF|ON}]
类型 布尔值 默认值 OFF
如果已激活,则将较少的信息记录到慢查询日志中。
-
命令行格式 --log-slow-admin-statements[={OFF|ON}]
(5.6.10)删除 5.6.11 类型 布尔值 默认值 OFF
在写入慢速查询日志的语句中包含慢速管理语句。行政报表包括
ALTER TABLE
、ANALYZE TABLE
、CHECK TABLE
、CREATE INDEX
、DROP INDEX
、OPTIMIZE TABLE
和REPAIR TABLE
。这个命令行选项在 MySQL 5.6.11 中被移除,并被
log_slow_admin_statements
系统变量取代。系统变量可以像选项一样在命令行或选项文件中设置,因此不需要在服务器启动时进行任何更改,但系统变量还可以在运行时检查或设置值。 -
命令行格式 --log-tc=file_name
类型 文件名 默认值 tc.log
内存映射事务协调器日志文件的名称(用于在禁用二进制日志时影响多个存储引擎的 XA 事务)。默认名称是
tc.log
. 如果未作为完整路径名给出,则该文件将在数据目录下创建。此选项未使用。 -
命令行格式 --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[={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=#
类型 整数 默认值 1024
最小值 1024
最大值 16384
用于
MyISAM
索引页的块大小。 不要读取任何选项文件。如果程序启动因从选项文件中读取未知选项而失败,
--no-defaults
可用于防止它们被读取。如果使用它,这必须是命令行上的第一个选项。有关此选项和其他选项文件选项的其他信息,请参阅第 4.2.2.3 节,“影响选项文件处理的命令行选项”。
-
命令行格式 --old-style-user-limits[={OFF|ON}]
类型 布尔值 默认值 OFF
启用旧式用户限制。(在 MySQL 5.0.3 之前,帐户资源限制是针对用户连接的每个主机单独计算的,而不是
user
表中的每个帐户行。)请参阅 第 6.2.13 节,“设置帐户资源限制”。 -
命令行格式 --partition[={OFF|ON}]
被禁用 skip-partition
类型 布尔值 默认值 ON
在 MySQL 服务器中启用或禁用用户定义的分区支持。
--performance-schema-xxx
配置性能模式选项。有关详细信息,请参阅 第 22.14 节,“性能模式命令选项”。
-
命令行格式 --plugin-load=plugin_list
系统变量 plugin_load
范围 全球的 动态的 不 类型 细绳 此选项告诉服务器在启动时加载指定的插件。如果给出了多个
--plugin-load
选项,则只有最后一个适用。可以使用--plugin-load-add
选项指定要加载的其他插件。选项值是以分号分隔的
plugin_library
和 值列表。每个都是包含插件代码的库文件的名称,每个 都是要加载的插件的名称。如果一个插件库的命名没有任何前面的插件名称,服务器将加载库中的所有插件。使用前面的插件名称,服务器仅从库中加载指定的插件。服务器在系统变量 命名的目录中查找插件库文件 。name
=
plugin_library
plugin_library
name
plugin_dir
例如,如果名为
myplug1
和myplug2
的插件包含在插件库文件myplug1.so
和myplug2.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-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
前缀指定它们的选项。因此, 可以将--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=#
类型 整数 默认值 0
在某些系统上,当服务器停止时,TCP/IP 端口可能不会立即可用。如果服务器随后快速重新启动,则其重新打开端口的尝试可能会失败。此选项表示如果无法打开,服务器应等待 TCP/IP 端口空闲的秒数。默认是不等待。
打印程序名称和它从选项文件中获取的所有选项。如果使用它,它必须是命令行上的第一个选项,除非它可以紧接在
--defaults-file
或 之后使用--defaults-extra-file
。有关此选项和其他选项文件选项的其他信息,请参阅第 4.2.2.3 节,“影响选项文件处理的命令行选项”。
-
命令行格式 --remove [service_name]
特定于平台 视窗 (仅限 Windows)删除 MySQL Windows 服务。默认服务名称是
MySQL
如果没有service_name
给出值。有关详细信息,请参阅第 2.3.4.7 节,“将 MySQL 作为 Windows 服务启动”。 -
命令行格式 --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[={OFF|ON}]
类型 布尔值 默认值 OFF
此选项会影响服务器启动顺序:
--skip-grant-tables
导致服务器不读取mysql
系统数据库中的授权表,从而在根本不使用特权系统的情况下启动。这使任何有权访问服务器的人都可以 不受限制地访问所有数据库。要使启动的服务器
--skip-grant-tables
在运行时加载授权表,请执行权限刷新操作,可以通过以下方式完成:FLUSH PRIVILEGES
连接到服务器后 发出 MySQL语句。
特权刷新也可能由于启动后执行的其他操作而隐式发生,从而导致服务器开始使用授权表。例如, mysql_upgrade在升级过程中刷新权限。
--skip-grant-tables
导致服务器不加载在mysql
系统数据库中注册的某些其他对象:使用安装并在系统表中
INSTALL PLUGIN
注册的 插件。mysql.plugin
要使即使在使用 时也加载插件
--skip-grant-tables
,请使用--plugin-load
或--plugin-load-add
选项。使用系统表 安装
CREATE EVENT
并注册的计划事件。mysql.event
使用并在系统表中
CREATE FUNCTION
注册的 可加载函数 。mysql.func
-
命令行格式 --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 查找和主机缓存”。
禁用
InnoDB
存储引擎。在这种情况下,因为默认存储引擎是InnoDB
,服务器无法启动,除非您还使用--default-storage-engine
并将 默认值设置为永久和表--default-tmp-storage-engine
的其他引擎 。TEMPORARY
从 MySQL 5.6.21 开始,该
--skip-innodb
选项已弃用。它的使用会导致警告。期望在未来的 MySQL 版本中删除此选项。-
命令行格式 --skip-new
此选项禁用(过去考虑的)新的、可能不安全的行为。它导致这些设置:
delay_key_write=OFF
,concurrent_insert=NEVER
,automatic_sp_privileges=OFF
。它还会导致OPTIMIZE TABLE
映射到不支持ALTER TABLE
的存储引擎。OPTIMIZE TABLE
-
命令行格式 --skip-partition
--disable-partition
禁用用户定义的分区。可以使用
SHOW TABLES
或通过查询 表来查看分区表INFORMATION_SCHEMA.TABLES
,但不能创建或修改,也不能访问此类表中的数据。表中所有特定于分区的列都INFORMATION_SCHEMA.PARTITIONS
显示NULL
.由于
DROP TABLE
删除了表定义 (.frm
) 文件,因此即使使用该选项禁用分区,此语句也适用于分区表。但是,在这种情况下,该语句不会删除.par
与分区表关联的文件。因此,您应该避免在禁用分区的情况下删除分区表,或者采取措施.par
手动删除孤立文件。 -
命令行格式 --skip-show-database
系统变量 skip_show_database
范围 全球的 动态的 不 类型 布尔值 默认值 OFF
此选项设置
skip_show_database
系统变量,该变量控制允许谁使用该SHOW DATABASES
语句。请参阅 第 5.1.7 节,“服务器系统变量”。 -
命令行格式 --skip-stack-trace
不要写堆栈跟踪。当您在调试器下运行mysqld时,此选项很有用。在某些系统上,您还必须使用此选项来获取核心文件。参见 第 5.8 节,“调试 MySQL”。
-
命令行格式 --slow-start-timeout=#
类型 整数 默认值 15000
此选项控制 Windows 服务控制管理器的服务启动超时。该值是服务控制管理器在启动期间尝试终止 Windows 服务之前等待的最大毫秒数。默认值为 15000(15 秒)。如果 MySQL 服务启动时间过长,您可能需要增加此值。值为 0 表示没有超时。
-
命令行格式 --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[={OFF|ON}]
被禁用 skip-ssl
类型 布尔值 默认值 OFF
此选项指定服务器允许但不需要加密连接。
--ssl
可以通过设置 系统变量来暗示,如这些变量的描述中所示。ssl_
xxx
--ssl
可以以否定形式指定为--skip-ssl
或同义词 (--ssl=OFF
,--disable-ssl
)。在这种情况下,该选项指定服务器 不允许加密连接,无论 系统变量的设置如何。ssl_
xxx
有关配置服务器是否允许客户端使用 SSL 连接以及指示在哪里可以找到 SSL 密钥和证书的更多信息,请参阅 第 6.3.1 节,“配置 MySQL 以使用加密连接”。考虑至少在服务器端设置
ssl_cert
和ssl_key
系统变量,在客户端设置--ssl-ca
(or--ssl-capath
) 选项。 -
命令行格式 --standalone
特定于平台 视窗 仅适用于 Windows;指示 MySQL 服务器不作为服务运行。
-
命令行格式 --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 上有不同的效果:
在 Windows 上,启用符号链接使您能够通过创建包含实际目录路径 的文件来建立指向数据库目录的符号链接 。请参阅 第 8.12.3.3 节,“在 Windows 上使用数据库的符号链接”。db_name
.sym在 Unix 上,启用符号链接意味着您可以 使用 语句的or 选项将
MyISAM
索引文件或数据文件链接到另一个目录。如果您删除或重命名表,其符号链接指向的文件也会被删除或重命名。请参阅第 8.12.3.2 节,“在 Unix 上使用 MyISAM 表的符号链接”。INDEX DIRECTORY
DATA DIRECTORY
CREATE TABLE
-
命令行格式 --sysdate-is-now[={OFF|ON}]
类型 布尔值 默认值 OFF
SYSDATE()
默认情况下返回它执行的时间,而不是它出现的语句开始执行的时间。这与 的行为不同NOW()
。此选项导致SYSDATE()
成为的同义词NOW()
。有关二进制日志记录和复制的影响的信息,请参阅SYSDATE()
第 12.7 节“日期和时间函数”和SET TIMESTAMP
第 5.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[={OFF|ON}]
类型 布尔值 默认值 (Linux) ON
默认值(其他) OFF
除了在 Linux 上,此选项将被忽略。在 Linux 上,它会导致服务器创建的大多数临时文件使用一小组名称,而不是每个新文件的唯一名称。这解决了 Linux 内核中处理创建许多具有不同名称的新文件的问题。对于旧的行为,Linux 似乎“泄漏”了内存,因为它被分配到目录条目缓存而不是磁盘缓存。
-
命令行格式 --transaction-isolation=name
类型 枚举 默认值 REPEATABLE-READ
有效值 READ-UNCOMMITTED
READ-COMMITTED
REPEATABLE-READ
SERIALIZABLE
设置默认事务隔离级别。该
level
值可以是READ-UNCOMMITTED
、READ-COMMITTED
、REPEATABLE-READ
或SERIALIZABLE
。请参阅 第 13.3.6 节,“SET TRANSACTION 语句”。默认事务隔离级别也可以在运行时使用
SET TRANSACTION
语句或通过设置tx_isolation
系统变量来设置。 -
命令行格式 --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_name
user_id
启动 mysqld时, 此选项是必需的。服务器在其启动序列期间更改其用户 ID,导致它以该特定用户而不是 . 请参阅 第 6.1.1 节,“安全准则”。
root
root
为避免用户
--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
. 如果您不需要额外的检查,您可以在启动时禁用此选项以避免性能下降。将此选项与
--help
详细帮助选项一起使用。--version
,-V
显示版本信息并退出。