-DBUILD_CONFIG=mysql_release -DBUILD_CONFIG=mysql_release

此选项使用所使用的相同构建选项配置源发行版由 Oracle 为官方 MySQL 版本生成二进制发行版。This option configures a source distribution with the same build options used by Oracle to produce binary distributions for official MySQL releases.

-DWITH_BUILD_ID=bool -DWITH_BUILD_ID=bool

在 Linux 系统上，生成一个唯一的构建 ID，该 ID 用作 build_id 系统变量的值，并在启动时写入 MySQL 服务器日志。将此选项设置为 OFF 可禁用此功能。On Linux systems, generates a unique build ID which is used as the value of the build_id system variable and written to the MySQL server log on startup. Set this option to OFF to disable this feature.

此选项对 Linux 以外的平台没有影响。This option has no effect on platforms other than Linux.

-DBUNDLE_RUNTIME_LIBRARIES=bool -DBUNDLE_RUNTIME_LIBRARIES=bool

是否将运行时库与 Windows 的服务器 MSI 和 Zip 包捆绑在一起。Whether to bundle runtime libraries with server MSI and Zip packages for Windows.

-DCMAKE_BUILD_TYPE=type -DCMAKE_BUILD_TYPE=type

要生成的构建类型：The type of build to produce:

不支持选项值 None 和 MinSizeRel。The option values None and MinSizeRel are not supported.

-DCPACK_MONOLITHIC_INSTALL=bool -DCPACK_MONOLITHIC_INSTALL=bool

此选项影响ma​​ke package操作是生成多个安装包文件还是单个文件。如果禁用，该操作会生成多个安装包文件，如果您只想安装完整 MySQL 安装的子集，这可能很有用。如果启用，它会生成一个文件来安装所有内容。This option affects whether the make package operation produces multiple installation package files or a single file. If disabled, the operation produces multiple installation package files, which may be useful if you want to install only a subset of a full MySQL installation. If enabled, it produces a single file for installing everything.

-DFORCE_INSOURCE_BUILD=bool -DFORCE_INSOURCE_BUILD=bool

定义是否强制进行源内构建。建议使用源外构建，因为它们允许来自同一源的多个构建，并且可以通过删除构建目录来快速执行清理。要强制进行源内构建，请使用 -DFORCE_INSOURCE_BUILD=ON 调用 CMake。Defines whether to force an in-source build. Out-of-source builds are recommended, as they permit multiple builds from the same source, and cleanup can be performed quickly by removing the build directory. To force an in-source build, invoke CMake with -DFORCE_INSOURCE_BUILD=ON.

-DFORCE_COLORED_OUTPUT=bool -DFORCE_COLORED_OUTPUT=bool

定义是否为 gcc 和 clang 在命令行上编译时。默认为 OFF。Defines whether to enable colorized compiler output for gcc and clang when compiling on the command line. Defaults to OFF.

-DCMAKE_INSTALL_PREFIX=dir_name -DCMAKE_INSTALL_PREFIX=dir_name

安装基目录。The installation base directory.

可以在服务器启动时使用--basedir选项设置该值。This value can be set at server startup using the --basedir option.

-DINSTALL_BINDIR=dir_name -DINSTALL_BINDIR=dir_name

安装用户程序的位置。Where to install user programs.

-DINSTALL_DOCDIR=dir_name -DINSTALL_DOCDIR=dir_name

安装文档的位置。Where to install documentation.

-DINSTALL_DOCREADMEDIR=dir_name -DINSTALL_DOCREADMEDIR=dir_name

README 文件的安装位置。Where to install README files.

-DINSTALL_INCLUDEDIR=dir_name -DINSTALL_INCLUDEDIR=dir_name

安装头文件的位置。Where to install header files.

-DINSTALL_INFODIR=dir_name -DINSTALL_INFODIR=dir_name

信息文件的安装位置。Where to install Info files.

-DINSTALL_LAYOUT=name -DINSTALL_LAYOUT=name

选择预定义的安装布局：Select a predefined installation layout:

您可以选择预定义的布局，但可以通过指定其他选项来修改各个组件的安装位置。例如：You can select a predefined layout but modify individual component installation locations by specifying other options. For example:

cmake . -DINSTALL_LAYOUT=SVR4 -DMYSQL_DATADIR=/var/mysql/data

INSTALL_LAYOUT 值确定 secure_file_priv 系统变量的默认值。请参阅第 7.1.8 节“服务器系统变量”中对此变量的说明。The INSTALL_LAYOUT value determines the default value of the secure_file_priv system variable. See the description of this variable in Section 7.1.8, “Server System Variables”.

-DINSTALL_LIBDIR=dir_name -DINSTALL_LIBDIR=dir_name

安装库文件的位置。Where to install library files.

-DINSTALL_MANDIR=dir_name -DINSTALL_MANDIR=dir_name

安装手册页的位置。Where to install manual pages.

-DINSTALL_MYSQLSHAREDIR=dir_name -DINSTALL_MYSQLSHAREDIR=dir_name

安装共享数据文件的位置。Where to install shared data files.

-DINSTALL_MYSQLTESTDIR=dir_name -DINSTALL_MYSQLTESTDIR=dir_name

安装 mysql-test 目录的位置。要禁止安装此目录，请显式将该选项设置为空值 (-DINSTALL_MYSQLTESTDIR=)。Where to install the mysql-test directory. To suppress installation of this directory, explicitly set the option to the empty value (-DINSTALL_MYSQLTESTDIR=).

-DINSTALL_PKGCONFIGDIR=dir_name -DINSTALL_PKGCONFIGDIR=dir_name

安装mysqlclient.pc 文件供 pkg-config 使用。默认值为 INSTALL_LIBDIR/pkgconfig，除非 INSTALL_LIBDIR 以 /mysql 结尾，在这种情况下，首先将其删除。The directory in which to install the mysqlclient.pc file for use by pkg-config. The default value is INSTALL_LIBDIR/pkgconfig, unless INSTALL_LIBDIR ends with /mysql, in which case that is removed first.

-DINSTALL_PLUGINDIR=dir_name -DINSTALL_PLUGINDIR=dir_name

插件目录的位置。The location of the plugin directory.

可以在服务器启动时使用以下命令设置此值： --plugin_dir 选项。This value can be set at server startup with the --plugin_dir option.

-DINSTALL_PRIV_LIBDIR=dir_name -DINSTALL_PRIV_LIBDIR=dir_name

动态库目录的位置。The location of the dynamic library directory.

默认位置。 对于 RPM 构建，这是 /usr/lib64/mysql/private/，对于 DEB 来说是 /usr/lib/mysql/private/，对于 TAR 来说是 lib/private/。Default location.  For RPM builds, this is /usr/lib64/mysql/private/, for DEB it is /usr/lib/mysql/private/, and for TAR it is lib/private/.

Protobuf。 由于这是私有位置，因此加载程序（例如 Linux 上的 ld-linux.so）可能无法在没有帮助的情况下找到 libprotobuf.so 文件。为了引导加载程序，将 RPATH=$ORIGIN/../$INSTALL_PRIV_LIBDIR 添加到 mysqld 和 mysqlxtest 中。这适用于大多数情况，但当使用 资源组 功能时，mysqld 是 setsuid，并且加载器忽略任何包含 $ORIGIN 的 RPATH。为了克服这个问题，在 mysqld 的 DEB 和 RPM 版本中设置了该目录的显式完整路径，因为目标目的地是已知的。对于 tarball 安装，需要使用 patchelf 等工具修补 mysqld。Protobuf.  Because this is a private location, the loader (such as ld-linux.so on Linux) may not find the libprotobuf.so files without help. To guide the loader, RPATH=$ORIGIN/../$INSTALL_PRIV_LIBDIR is added to mysqld and mysqlxtest. This works for most cases but when using the Resource Group feature, mysqld is setsuid, and the loader ignores any RPATH which contains $ORIGIN. To overcome this, an explicit full path to the directory is set in the DEB and RPM versions of mysqld, since the target destination is known. For tarball installs, patching of mysqld with a tool like patchelf is required.

-DINSTALL_SBINDIR=dir_name -DINSTALL_SBINDIR=dir_name

安装 mysqld 服务器的位置。Where to install the mysqld server.

-DINSTALL_SECURE_FILE_PRIVDIR=dir_name -DINSTALL_SECURE_FILE_PRIVDIR=dir_name

secure_file_priv 系统变量的默认值。默认值是特定于平台的，取决于 INSTALL_LAYOUT CMake 选项的值；请参阅第 7.1.8 节“服务器系统变量”中对 secure_file_priv 系统变量的说明。The default value for the secure_file_priv system variable. The default value is platform specific and depends on the value of the INSTALL_LAYOUT CMake option; see the description of the secure_file_priv system variable in Section 7.1.8, “Server System Variables”.

-DINSTALL_SHAREDIR=dir_name -DINSTALL_SHAREDIR=dir_name

安装位置 aclocal/mysql.m4.Where to install aclocal/mysql.m4.

-DINSTALL_STATIC_LIBRARIES=bool -DINSTALL_STATIC_LIBRARIES=bool

是否安装静态库。默认值为ON。如果设置为 OFF，则不会安装这些库文件：libmysqlclient.a、libmysqlservices.a。Whether to install static libraries. The default is ON. If set to OFF, these library files are not installed: libmysqlclient.a, libmysqlservices.a.

-DINSTALL_SUPPORTFILESDIR=dir_name -DINSTALL_SUPPORTFILESDIR=dir_name

安装额外支持文件的位置。Where to install extra support files.

-DLINK_RANDOMIZE=bool -DLINK_RANDOMIZE=bool

是否随机化 mysqld 二进制文件中的符号顺序。默认值为OFF。仅应出于调试目的启用此选项。Whether to randomize the order of symbols in the mysqld binary. The default is OFF. This option should be enabled only for debugging purposes.

-DLINK_RANDOMIZE_SEED=val -DLINK_RANDOMIZE_SEED=val

LINK_RANDOMIZE 选项的种子值。该值是一个字符串。默认为 mysql，任意选择。Seed value for the LINK_RANDOMIZE option. The value is a string. The default is mysql, an arbitrary choice.

-DMYSQL_DATADIR=dir_name -DMYSQL_DATADIR=dir_name

MySQL 数据目录的位置。The location of the MySQL data directory.

可以在服务器启动时使用 --datadir 选项设置此值。This value can be set at server startup with the --datadir option.

-DODBC_INCLUDES=dir_name -DODBC_INCLUDES=dir_name

ODBC 的位置包括目录，在配置时可以使用该目录连接器/ODBC。The location of the ODBC includes directory, which may be used while configuring Connector/ODBC.

-DODBC_LIB_DIR=dir_name -DODBC_LIB_DIR=dir_name

ODBC 库目录的位置，其中可以在配置 Connector/ODBC 时使用。The location of the ODBC library directory, which may be used while configuring Connector/ODBC.

-DSYSCONFDIR=dir_name -DSYSCONFDIR=dir_name

默认 my.cnf 选项文件目录。The default my.cnf option file directory.

此位置无法在服务器启动时设置，但您可以使用 --defaults-file=file_name 选项启动带有给定选项文件的服务器，其中 file_name 是文件的完整路径名。This location cannot be set at server startup, but you can start the server with a given option file using the --defaults-file=file_name option, where file_name is the full path name to the file.

-DSYSTEMD_PID_DIR=dir_name -DSYSTEMD_PID_DIR=dir_name

MySQL 由 systemd 管理时在其中创建 PID 文件的目录名称。默认为 /var/run/mysqld；这可能会根据 INSTALL_LAYOUT 值隐式更改。The name of the directory in which to create the PID file when MySQL is managed by systemd. The default is /var/run/mysqld; this might be changed implicitly according to the INSTALL_LAYOUT value.

此选项将被忽略，除非WITH_SYSTEMDThis option is ignored unless WITH_SYSTEMD is enabled.

-DSYSTEMD_SERVICE_NAME=name -DSYSTEMD_SERVICE_NAME=name

MySQL 管理时使用的 MySQL 服务的名称systemd。默认为mysqld；这可能会根据 INSTALL_LAYOUT 值隐式更改。The name of the MySQL service to use when MySQL is managed by systemd. The default is mysqld; this might be changed implicitly according to the INSTALL_LAYOUT value.

此选项将被忽略，除非WITH_SYSTEMDThis option is ignored unless WITH_SYSTEMD is enabled.

-DTMPDIR=dir_name -DTMPDIR=dir_name

用于tmpdir系统变量的默认位置。如果未指定，该值默认为P_tmpdir在<stdio.h>.The default location to use for the tmpdir system variable. If unspecified, the value defaults to P_tmpdir in <stdio.h>.

-DADD_GDB_INDEX=bool -DADD_GDB_INDEX=bool

此选项确定是否启用 .gdb_index 部分，这使得在调试器中加载它们的速度更快。默认情况下该选项处于禁用状态。使用 lld 链接器，并通过以下方式禁用。如果使用 lld 或 GNU gold 以外的链接器，则无效。This option determines whether to enable generation of a .gdb_index section in binaries, which makes loading them in a debugger faster. The option is disabled by default. lld linker is used, and is disabled by It has no effect if a linker other than lld or GNU gold is used.

-DCOMPILATION_COMMENT=string -DCOMPILATION_COMMENT=string

有关编译环境的描述性注释。虽然 mysqld 使用 COMPILATION_COMMENT_SERVER，但其他程序使用 COMPILATION_COMMENT。A descriptive comment about the compilation environment. While mysqld uses COMPILATION_COMMENT_SERVER, other programs use COMPILATION_COMMENT.

-DCOMPRESS_DEBUG_SECTIONS=bool -DCOMPRESS_DEBUG_SECTIONS=bool

是否压缩二进制可执行文件的调试部分（仅限 Linux）。压缩可执行调试部分可以节省空间，但代价是构建过程中需要额外的 CPU 时间。Whether to compress the debug sections of binary executables (Linux only). Compressing executable debug sections saves space at the cost of extra CPU time during the build process.

默认值为 OFF。如果未显式设置此选项，但设置了 COMPRESS_DEBUG_SECTIONS 环境变量，则该选项将从该变量获取其值。The default is OFF. If this option is not set explicitly but the COMPRESS_DEBUG_SECTIONS environment variable is set, the option takes its value from that variable.

-DCOMPILATION_COMMENT_SERVER=string -DCOMPILATION_COMMENT_SERVER=string

有关 mysqld 使用的编译环境的描述性注释（例如，设置version_comment 系统变量）。服务器以外的程序使用 COMPILATION_COMMENT。A descriptive comment about the compilation environment for use by mysqld (for example, to set the version_comment system variable). Programs other than the server use COMPILATION_COMMENT.

-DDEFAULT_CHARSET=charset_name -DDEFAULT_CHARSET=charset_name

服务器字符集。默认情况下，MySQL 使用 utf8mb4 字符集。The server character set. By default, MySQL uses the utf8mb4 character set.

charset_name 可以是 binary、armscii8、ascii、big5、cp1250、cp1251、cp1256、cp1257、cp850、cp852、cp866、cp932、dec8、eucjpms、euckr、gb2312、gbk、geostd8、greek、hebrew、hp8、keybcs2、koi8r、koi8u、latin1、latin2、latin5、latin7、macce、macroman、sjis、swe7、tis620、ucs2、ujis、utf8mb3、utf8mb4、utf16、utf16le、utf32。charset_name may be one of binary, armscii8, ascii, big5, cp1250, cp1251, cp1256, cp1257, cp850, cp852, cp866, cp932, dec8, eucjpms, euckr, gb2312, gbk, geostd8, greek, hebrew, hp8, keybcs2, koi8r, koi8u, latin1, latin2, latin5, latin7, macce, macroman, sjis, swe7, tis620, ucs2, ujis, utf8mb3, utf8mb4, utf16, utf16le, utf32.

此值可以在服务器启动时使用 --character-set-server 设置选项。This value can be set at server startup with the --character-set-server option.

-DDEFAULT_COLLATION=collation_name -DDEFAULT_COLLATION=collation_name

服务器排序规则。默认情况下，MySQL 使用 utf8mb4_0900_ai_ci。使用 SHOW COLLATION 语句确定每个字符集可用的排序规则。The server collation. By default, MySQL uses utf8mb4_0900_ai_ci. Use the SHOW COLLATION statement to determine which collations are available for each character set.

可以在服务器启动时使用 --collation_server 选项。This value can be set at server startup with the --collation_server option.

-DDISABLE_PSI_COND=bool -DDISABLE_PSI_COND=bool

是否排除性能架构条件检测。默认值为 OFF（包含）。Whether to exclude the Performance Schema condition instrumentation. The default is OFF (include).

-DDISABLE_PSI_FILE=bool -DDISABLE_PSI_FILE=bool

是否排除性能架构文件检测。默认值为 OFF（包含）。Whether to exclude the Performance Schema file instrumentation. The default is OFF (include).

-DDISABLE_PSI_IDLE=bool -DDISABLE_PSI_IDLE=bool

是否排除性能模式空闲检测。默认值为 OFF（包含）。Whether to exclude the Performance Schema idle instrumentation. The default is OFF (include).

-DDISABLE_PSI_MEMORY=bool -DDISABLE_PSI_MEMORY=bool

是否排除性能架构内存检测。默认值为 OFF（包含）。Whether to exclude the Performance Schema memory instrumentation. The default is OFF (include).

-DDISABLE_PSI_METADATA=bool -DDISABLE_PSI_METADATA=bool

是否排除性能模式元数据检测。默认值为 OFF（包含）。Whether to exclude the Performance Schema metadata instrumentation. The default is OFF (include).

-DDISABLE_PSI_MUTEX=bool -DDISABLE_PSI_MUTEX=bool

是否排除性能架构互斥检测。默认值为 OFF（包含）。Whether to exclude the Performance Schema mutex instrumentation. The default is OFF (include).

-DDISABLE_PSI_RWLOCK=bool -DDISABLE_PSI_RWLOCK=bool

是否排除性能架构 rwlock 检测。默认值为 OFF（包含）。Whether to exclude the Performance Schema rwlock instrumentation. The default is OFF (include).

-DDISABLE_PSI_SOCKET=bool -DDISABLE_PSI_SOCKET=bool

是否排除性能架构套接字检测。默认值为 OFF（包含）。Whether to exclude the Performance Schema socket instrumentation. The default is OFF (include).

-DDISABLE_PSI_SP=bool -DDISABLE_PSI_SP=bool

是否排除性能模式存储程序检测。默认值为 OFF（包含）。Whether to exclude the Performance Schema stored program instrumentation. The default is OFF (include).

-DDISABLE_PSI_STAGE=bool -DDISABLE_PSI_STAGE=bool

是否排除 Performance Schema 阶段检测。默认值为 OFF（包含）。Whether to exclude the Performance Schema stage instrumentation. The default is OFF (include).

-DDISABLE_PSI_STATEMENT=bool -DDISABLE_PSI_STATEMENT=bool

是否排除 Performance Schema 语句检测。默认值为 OFF（包含）。Whether to exclude the Performance Schema statement instrumentation. The default is OFF (include).

-DDISABLE_PSI_STATEMENT_DIGEST=bool -DDISABLE_PSI_STATEMENT_DIGEST=bool

是否排除性能模式语句摘要检测。默认值为 OFF（包含）。Whether to exclude the Performance Schema statement digest instrumentation. The default is OFF (include).

-DDISABLE_PSI_TABLE=bool -DDISABLE_PSI_TABLE=bool

是否排除性能架构表检测。默认值为 OFF（包含）。Whether to exclude the Performance Schema table instrumentation. The default is OFF (include).

-DDISABLE_PSI_PS=bool -DDISABLE_PSI_PS=bool

排除性能模式准备好的语句实例检测。默认值为 OFF（包含）。Exclude the Performance Schema prepared statements instances instrumentation. The default is OFF (include).

-DDISABLE_PSI_THREAD=bool -DDISABLE_PSI_THREAD=bool

排除性能架构线程检测。默认值为 OFF（包含）。Exclude the Performance Schema thread instrumentation. The default is OFF (include).

仅在没有任何检测的情况下构建时禁用线程，因为其他检测依赖于线程。Only disable threads when building without any instrumentation, because other instrumentations have a dependency on threads.

-DDISABLE_PSI_TRANSACTION=bool -DDISABLE_PSI_TRANSACTION=bool

排除性能架构事务检测。默认值为 OFF（包含）。Exclude the Performance Schema transaction instrumentation. The default is OFF (include).

-DDISABLE_PSI_DATA_LOCK=bool -DDISABLE_PSI_DATA_LOCK=bool

排除性能架构数据锁定检测。默认值为 OFF（包含）。Exclude the performance schema data lock instrumentation. The default is OFF (include).

-DDISABLE_PSI_ERROR=bool -DDISABLE_PSI_ERROR=bool

排除性能架构服务器错误检测。默认值为 OFF（包含）。Exclude the performance schema server error instrumentation. The default is OFF (include).

-DENABLE_EXPERIMENTAL_SYSVARS=bool -DENABLE_EXPERIMENTAL_SYSVARS=bool

是否启用实验性InnoDB系统变量。实验系统变量适用于那些从事 MySQL 开发的人员，只能在开发或测试环境中使用，并且可能会在未来的 MySQL 版本中删除，恕不另行通知。有关实验性系统变量的信息，请参阅 MySQL 源代码树中的 /storage/innobase/handler/ha_innodb.cc。实验系统变量可以通过搜索“PLUGIN_VAR_EXPERIMENTAL”来识别。Whether to enable experimental InnoDB system variables. Experimental system variables are intended for those engaged in MySQL development, should only be used in a development or test environment, and may be removed without notice in a future MySQL release. For information about experimental system variables, refer to /storage/innobase/handler/ha_innodb.cc in the MySQL source tree. Experimental system variables can be identified by searching for “PLUGIN_VAR_EXPERIMENTAL”.

-DENABLE_GCOV=bool -DENABLE_GCOV=bool

是否包含gcov 支持（仅限 Linux）。Whether to include gcov support (Linux only).

-DENABLE_GPROF=bool -DENABLE_GPROF=bool

是否启用gprof（仅限优化的 Linux 版本）。Whether to enable gprof (optimized Linux builds only).

-DENABLED_LOCAL_INFILE=bool -DENABLED_LOCAL_INFILE=bool

此选项控制 MySQL 客户端库的编译默认 LOCAL 功能。因此，未做出明确安排的客户端会根据 MySQL 构建时指定的 ENABLED_LOCAL_INFILE 设置禁用或启用 LOCAL 功能。This option controls the compiled-in default LOCAL capability for the MySQL client library. Clients that make no explicit arrangements therefore have LOCAL capability disabled or enabled according to the ENABLED_LOCAL_INFILE setting specified at MySQL build time.

默认情况下，MySQL 二进制发行版中的客户端库是使用 ENABLED_LOCAL_INFILE 已禁用。如果您从源代码编译 MySQL，请根据未做出明确安排的客户端是否应禁用或启用 LOCAL 功能来分别禁用或启用 ENABLED_LOCAL_INFILE 进行配置。By default, the client library in MySQL binary distributions is compiled with ENABLED_LOCAL_INFILE disabled. If you compile MySQL from source, configure it with ENABLED_LOCAL_INFILE disabled or enabled based on whether clients that make no explicit arrangements should have LOCAL capability disabled or enabled, respectively.

ENABLED_LOCAL_INFILE 控制客户端 LOCAL 功能的默认设置。对于服务器， local_infile 系统变量控制服务器端 LOCAL 功能。要显式地使服务器拒绝或允许 LOAD DATA LOCAL 语句（无论客户端程序和库在构建时或运行时如何配置），请启动 mysqld 分别禁用或启用 --local-infile。 local_infile 也可以在运行时设置。请参阅第 8.1.6 节“LOAD DATA LOCAL 的安全注意事项”。ENABLED_LOCAL_INFILE controls the default for client-side LOCAL capability. For the server, the local_infile system variable controls server-side LOCAL capability. To explicitly cause the server to refuse or permit LOAD DATA LOCAL statements (regardless of how client programs and libraries are configured at build time or runtime), start mysqld with --local-infile disabled or enabled, respectively. local_infile can also be set at runtime. See Section 8.1.6, “Security Considerations for LOAD DATA LOCAL”.

-DENABLED_PROFILING=bool -DENABLED_PROFILING=bool

是否启用查询分析代码（对于SHOW PROFILE 和 SHOW PROFILES 语句）。Whether to enable query profiling code (for the SHOW PROFILE and SHOW PROFILES statements).

-DFORCE_UNSUPPORTED_COMPILER=bool -DFORCE_UNSUPPORTED_COMPILER=bool

默认情况下，CMake 检查支持的编译器的最低版本；要禁用此检查，请使用 -DFORCE_UNSUPPORTED_COMPILER=ON。By default, CMake checks for minimum versions of supported compilers; to disable this check, use -DFORCE_UNSUPPORTED_COMPILER=ON.

-DFPROFILE_GENERATE=bool -DFPROFILE_GENERATE=bool

Whether to generate profile guided optimization (PGO) data. This option is available for experimenting with PGO with GCC. See cmake/fprofile.cmake in the MySQL source distribution for information about using FPROFILE_GENERATE以及FPROFILE_USE. These options have been tested with GCC 8 and 9.Whether to generate profile guided optimization (PGO) data. This option is available for experimenting with PGO with GCC. See cmake/fprofile.cmake in the MySQL source distribution for information about using FPROFILE_GENERATE and FPROFILE_USE. These options have been tested with GCC 8 and 9.

-DFPROFILE_USE=bool -DFPROFILE_USE=bool

Whether to use profile guided optimization (PGO) data. This option is available for experimenting with PGO with GCC. See the cmake/fprofile.cmake file in a MySQL source distribution for information about using FPROFILE_GENERATE以及FPROFILE_USE. These options have been tested with GCC 8 and 9.Whether to use profile guided optimization (PGO) data. This option is available for experimenting with PGO with GCC. See the cmake/fprofile.cmake file in a MySQL source distribution for information about using FPROFILE_GENERATE and FPROFILE_USE. These options have been tested with GCC 8 and 9.

启用 FPROFILE_USE 还会启用WITH_LTO。Enabling FPROFILE_USE also enables WITH_LTO.

-DHAVE_PSI_MEMORY_INTERFACE=bool -DHAVE_PSI_MEMORY_INTERFACE=bool

是否为过度对齐类型的动态存储中使用的内存分配函数（ut::aligned_name库函数）启用性能架构内存跟踪模块。Whether to enable the performance schema memory tracing module for memory allocation functions (ut::aligned_name library functions) used in dynamic storage of over-aligned types.

-DIGNORE_AIO_CHECK=bool -DIGNORE_AIO_CHECK=bool

如果-DBUILD_CONFIG=mysql_release 选项在 Linux 上给出，默认情况下必须链接 libaio 库。如果您没有 libaio 或不想安装它，可以通过指定 -DIGNORE_AIO_CHECK=1 来禁止对其进行检查。If the -DBUILD_CONFIG=mysql_release option is given on Linux, the libaio library must be linked in by default. If you do not have libaio or do not want to install it, you can suppress the check for it by specifying -DIGNORE_AIO_CHECK=1.

-DMAX_INDEXES=num -DMAX_INDEXES=num

每个表的最大索引数。默认值为 64。最大值为 255。小于 64 的值将被忽略，并使用默认值 64。The maximum number of indexes per table. The default is 64. The maximum is 255. Values smaller than 64 are ignored and the default of 64 is used.

-DMYSQL_MAINTAINER_MODE=bool -DMYSQL_MAINTAINER_MODE=bool

是否启用 MySQL 维护者特定的开发环境。如果启用，此选项会导致编译器警告变为错误。Whether to enable a MySQL maintainer-specific development environment. If enabled, this option causes compiler warnings to become errors.

-DWITH_DEVELOPER_ENTITLEMENTS=bool -DWITH_DEVELOPER_ENTITLEMENTS=bool

是否向所有可执行文件添加 get-task-allow 权限，以便在服务器意外停止时生成核心转储。Whether to add the get-task-allow entitlement to all executables to generate a core dump in the event of an unexpected server halt.

在 macOS 11+ 上，核心转储仅限于具有 com.apple.security.get-task-allow 权限的进程，此 CMake 选项启用此功能。该权利允许其他进程附加和读取/修改进程内存，并允许 --core-file 按预期运行。On macOS 11+, core dumps are limited to processes with the com.apple.security.get-task-allow entitlement, which this CMake option enables. The entitlement allows other processes to attach and read/modify the processes memory, and allows --core-file to function as expected.

-DMUTEX_TYPE=type -DMUTEX_TYPE=type

InnoDB 使用的互斥类型。选项包括：The mutex type used by InnoDB. Options include:

-DMYSQLX_TCP_PORT=port_num -DMYSQLX_TCP_PORT=port_num

X Plugin 侦听 TCP/IP 的端口号连接。默认值为 33060。The port number on which X Plugin listens for TCP/IP connections. The default is 33060.

可以在服务器启动时使用 mysqlx_port 系统变量设置该值。This value can be set at server startup with the mysqlx_port system variable.

-DMYSQLX_UNIX_ADDR=file_name -DMYSQLX_UNIX_ADDR=file_name

服务器侦听 X 插件套接字连接的 Unix 套接字文件路径。这必须是绝对路径名。默认为 /tmp/mysqlx.sock。The Unix socket file path on which the server listens for X Plugin socket connections. This must be an absolute path name. The default is /tmp/mysqlx.sock.

可以在服务器启动时使用 mysqlx_port 系统变量设置该值。This value can be set at server startup with the mysqlx_port system variable.

-DMYSQL_PROJECT_NAME=name -DMYSQL_PROJECT_NAME=name

对于 Windows 或 macOS，要合并到项目文件名中的项目名称。For Windows or macOS, the project name to incorporate into the project file name.

-DMYSQL_TCP_PORT=port_num -DMYSQL_TCP_PORT=port_num

服务器侦听 TCP/IP 连接的端口号。默认值为 3306。The port number on which the server listens for TCP/IP connections. The default is 3306.

可以在服务器启动时使用 --port 选项设置该值。This value can be set at server startup with the --port option.

-DMYSQL_UNIX_ADDR=file_name -DMYSQL_UNIX_ADDR=file_name

服务器侦听套接字连接的 Unix 套接字文件路径。这必须是绝对路径名。默认值为 /tmp/mysql.sock。The Unix socket file path on which the server listens for socket connections. This must be an absolute path name. The default is /tmp/mysql.sock.

可以在服务器启动时使用 --socket 选项设置该值。This value can be set at server startup with the --socket option.

-DOPTIMIZER_TRACE=bool -DOPTIMIZER_TRACE=bool

是否支持优化器跟踪。请参阅第 10.15 节“跟踪优化器”。Whether to support optimizer tracing. See Section 10.15, “Tracing the Optimizer”.

-DREPRODUCIBLE_BUILD=bool -DREPRODUCIBLE_BUILD=bool

对于 Linux 系统上的构建，此选项控制是否格外小心地创建独立于构建位置和时间的构建结果。For builds on Linux systems, this option controls whether to take extra care to create a build result independent of build location and time.

对于 RelWithDebInfo，此选项默认为 ON构建。This option defaults to ON for RelWithDebInfo builds.

-DSHOW_SUPPRESSED_COMPILER_WARNINGS=bool -DSHOW_SUPPRESSED_COMPILER_WARNINGS=bool

显示抑制的编译器警告，并且这样做不会因-Werror而失败。默认为 OFF。Show suppressed compiler warnings, and do so without failing with -Werror. Defaults to OFF.

-DWIN_DEBUG_NO_INLINE=bool -DWIN_DEBUG_NO_INLINE=bool

是否在 Windows 上禁用函数内联。默认值为 OFF（启用内联）。Whether to disable function inlining on Windows. The default is OFF (inlining enabled).

-DWITH_LD=string -DWITH_LD=string

CMake 默认使用标准链接器。可以选择传入 lld 或 mold 来指定备用链接器。 mold 必须是版本 2 或更高版本。CMake uses the standard linker by default. Optionally pass in lld or mold to specify an alternative linker. mold must be version 2 or newer.

此选项可用于除 Enterprise Linux 之外的基于 Linux 的系统，Enterprise Linux 始终使用 ld 链接器。This option can be used on Linux-based systems other than Enterprise Linux, which always uses the ld linker.

-DWITH_ANT=path_name -DWITH_ANT=path_name

设置 Ant 的路径，构建 GCS Java 包装器时需要。将 WITH_ANT 设置为保存 Ant tarball 或解压存档的目录路径。当未设置 WITH_ANT 时，或者使用特殊值 system 设置时，构建过程会假定 $PATH 中存在二进制 ant。Set the path to Ant, required when building GCS Java wrapper. Set WITH_ANT to the path of a directory where the Ant tarball or unpacked archive is saved. When WITH_ANT is not set, or is set with the special value system, the build process assumes a binary ant exists in $PATH.

-DWITH_ASAN=bool -DWITH_ASAN=bool

是否启用 AddressSanitizer，对于支持它的编译器。默认值为 OFF。Whether to enable the AddressSanitizer, for compilers that support it. The default is OFF.

-DWITH_ASAN_SCOPE=bool -DWITH_ASAN_SCOPE=bool

是否启用 AddressSanitizer -fsanitize-address-use-after-scope Clang 标志以进行范围后使用检测。默认关闭。要使用此选项，还必须启用 -DWITH_ASAN。Whether to enable the AddressSanitizer -fsanitize-address-use-after-scope Clang flag for use-after-scope detection. The default is off. To use this option, -DWITH_ASAN must also be enabled.

-DWITH_AUTHENTICATION_CLIENT_PLUGINS=bool -DWITH_AUTHENTICATION_CLIENT_PLUGINS=bool

如果构建了任何相应的服务器身份验证插件，则会自动启用此选项。因此，其值取决于其他 CMake 选项，不应显式设置。This option is enabled automatically if any corresponding server authentication plugins are built. Its value thus depends on other CMake options and it should not be set explicitly.

-DWITH_AUTHENTICATION_LDAP=bool -DWITH_AUTHENTICATION_LDAP=bool

如果无法构建 LDAP 身份验证插件是否报告错误：Whether to report an error if the LDAP authentication plugins cannot be built:

-DWITH_AUTHENTICATION_PAM=bool -DWITH_AUTHENTICATION_PAM=bool

是否为包含此插件的源代码树构建 PAM 身份验证插件。 （请参阅第 8.4.1.5 节“PAM 可插入身份验证”。）如果指定此选项并且无法编译插件，则构建会失败。Whether to build the PAM authentication plugin, for source trees that include this plugin. (See Section 8.4.1.5, “PAM Pluggable Authentication”.) If this option is specified and the plugin cannot be compiled, the build fails.

-DWITH_AWS_SDK=path_name -DWITH_AWS_SDK=path_name

Amazon Web Services 软件开发工具包的位置。The location of the Amazon Web Services software development kit.

-DWITH_CLIENT_PROTOCOL_TRACING=bool -DWITH_CLIENT_PROTOCOL_TRACING=bool

是否将客户端协议跟踪框架构建到客户端库中。默认情况下，此选项处于启用状态。Whether to build the client-side protocol tracing framework into the client library. By default, this option is enabled.

有关编写协议跟踪客户端插件的信息，请参阅编写协议跟踪插件。For information about writing protocol trace client plugins, see Writing Protocol Trace Plugins.

另请参阅WITH_TEST_TRACE_PLUGIN 选项。See also the WITH_TEST_TRACE_PLUGIN option.

-DWITH_CURL=curl_type -DWITH_CURL=curl_type

curl 库的位置。 curl_type 可以是 system（使用系统 curl 库）、curl 库的路径名、no|off|none 禁用 curl 支持，或者 bundled 在 extra/curl/ 中使用捆绑的 curl 发行版。The location of the curl library. curl_type can be system (use the system curl library), a path name to the curl library, no|off|none to disable curl support, or bundled to use the bundled curl distribution in extra/curl/.

-DWITH_DEBUG=bool -DWITH_DEBUG=bool

是否包含调试支持。Whether to include debugging support.

通过调试支持配置 MySQL，您可以在启动服务器时使用 --debug="d,parser_debug" 选项。这会导致用于处理 SQL 语句的 Bison 解析器将解析器跟踪转储到服务器的标准错误输出。通常，此输出会写入错误日志。Configuring MySQL with debugging support enables you to use the --debug="d,parser_debug" option when you start the server. This causes the Bison parser that is used to process SQL statements to dump a parser trace to the server's standard error output. Typically, this output is written to the error log.

InnoDB 存储引擎的同步调试检查在 UNIV_DEBUG 下定义，并且在使用 WITH_DEBUG 选项编译调试支持时可用。编译调试支持后，innodb_sync_debug 配置选项可用于启用或禁用 InnoDB 同步调试检查。Sync debug checking for the InnoDB storage engine is defined under UNIV_DEBUG and is available when debugging support is compiled in using the WITH_DEBUG option. When debugging support is compiled in, the innodb_sync_debug configuration option can be used to enable or disable InnoDB sync debug checking.

启用WITH_DEBUG也会启用调试同步（Debug Sync）。该功能用于测试和调试。当编译时包含此功能，运行时默认禁用调试同步。要启用它，可通过启动mysqld并使用--debug-sync-timeout=N选项来实现，其中N是大于 0 的超时值。（默认值为 0，表示禁用调试同步。）N成为单个同步点的默认超时值。Enabling WITH_DEBUG also enables Debug Sync. This facility is used for testing and debugging. When compiled in, Debug Sync is disabled by default at runtime. To enable it, start mysqld with the --debug-sync-timeout=N option, where N is a timeout value greater than 0. (The default value is 0, which disables Debug Sync.) N becomes the default timeout for individual synchronization points.

该选项InnoDB译调试支持时，存储引擎的WITH_DEBUG同步调试检查Sync debug checking for the InnoDB storage engine is available when debugging support is compiled in using the WITH_DEBUG option.

有关调试同步工具以及如何使用同步点的说明，请参阅 MySQL 内部结构：测试同步。For a description of the Debug Sync facility and how to use synchronization points, see MySQL Internals: Test Synchronization.

-DWITH_EDITLINE=value -DWITH_EDITLINE=value

哪个libedit/editline库。允许的值为bundled（默认）和system.Which libedit/editline library to use. The permitted values are bundled (the default) and system.

-DWITH_ICU={icu_type|path_name} -DWITH_ICU={icu_type|path_name}

MySQL 使用 Unicode 国际组件 (ICU) 来支持正则表达式操作。 WITH_ICU 选项指示要包含的 ICU 支持类型或要使用的 ICU 安装路径名称。MySQL uses International Components for Unicode (ICU) to support regular expression operations. The WITH_ICU option indicates the type of ICU support to include or the path name to the ICU installation to use.

-DWITH_INNODB_EXTRA_DEBUG=bool -DWITH_INNODB_EXTRA_DEBUG=bool

是否包含额外的 InnoDB 调试支持。Whether to include extra InnoDB debugging support.

启用 WITH_INNODB_EXTRA_DEBUG 打开额外的 InnoDB 调试检查。仅当启用 WITH_DEBUG 时才能启用此选项。Enabling WITH_INNODB_EXTRA_DEBUG turns on extra InnoDB debug checks. This option can only be enabled when WITH_DEBUG is enabled.

-DWITH_JEMALLOC=bool -DWITH_JEMALLOC=bool

是否与-ljemalloc链接。如果启用，内置 malloc()、calloc()、realloc() 和 free() 例程将被禁用。默认值为 OFF。Whether to link with -ljemalloc. If enabled, built-in malloc(), calloc(), realloc(), and free() routines are disabled. The default is OFF.

WITH_JEMALLOC 和 WITH_TCMALLOC 是互斥的。WITH_JEMALLOC and WITH_TCMALLOC are mutually exclusive.

-DWITH_LIBEVENT=string -DWITH_LIBEVENT=string

要使用哪个libevent库。允许的值为bundled（默认）和system。如果指定了 system 并且找不到系统 libevent 库，则无论如何都会发生错误，并且不会使用捆绑的 libevent。Which libevent library to use. Permitted values are bundled (default) and system. If system is specified and no system libevent library can be found, an error occurs regardless, and the bundled libevent is not used.

X Plugin 和 MySQL Router 需要 libevent 库。The libevent library is required by X Plugin and MySQL Router.

-DWITH_LIBWRAP=bool -DWITH_LIBWRAP=bool

是否包含 libwrap（TCP 包装器）支持。Whether to include libwrap (TCP wrappers) support.

-DWITH_LOCK_ORDER=bool -DWITH_LOCK_ORDER=bool

是否启用 LOCK_ORDER 工具。默认情况下，此选项处于禁用状态，并且服务器版本不包含任何工具。如果启用了工具，则 LOCK_ORDER 工具可用，并且可以按照第 7.9.3 节“LOCK_ORDER 工具”中的说明使用。Whether to enable LOCK_ORDER tooling. By default, this option is disabled and server builds contain no tooling. If tooling is enabled, the LOCK_ORDER tool is available and can be used as described in Section 7.9.3, “The LOCK_ORDER Tool”.

-DWITH_LSAN=bool -DWITH_LSAN=bool

是否运行 LeakSanitizer，不运行 AddressSanitizer。默认为 OFF。Whether to run LeakSanitizer, without AddressSanitizer. The default is OFF.

-DWITH_LTO=bool -DWITH_LTO=bool

是否启用链接时优化器（如果编译器支持）。默认值为 OFF，除非启用 FPROFILE_USE。Whether to enable the link-time optimizer, if the compiler supports it. The default is OFF unless FPROFILE_USE is enabled.

-DWITH_LZ4=lz4_type -DWITH_LZ4=lz4_type

WITH_LZ4 选项指示 zlib 支持的来源：The WITH_LZ4 option indicates the source of zlib support:

-DWITH_MECAB={disabled|system|path_name} -DWITH_MECAB={disabled|system|path_name}

使用此选项编译 MeCab 解析器。如果您已将 MeCab 安装到默认安装目录，请设置 -DWITH_MECAB=system。 system 选项适用于使用本机包管理实用程序从源代码或二进制文件执行的 MeCab 安装。如果您将 MeCab 安装到自定义安装目录，请指定 MeCab 安装路径，例如 -DWITH_MECAB=/opt/mecab。如果 system 选项不起作用，则指定 MeCab 安装路径应该在所有情况下都起作用。Use this option to compile the MeCab parser. If you have installed MeCab to its default installation directory, set -DWITH_MECAB=system. The system option applies to MeCab installations performed from source or from binaries using a native package management utility. If you installed MeCab to a custom installation directory, specify the path to the MeCab installation, for example, -DWITH_MECAB=/opt/mecab. If the system option does not work, specifying the MeCab installation path should work in all cases.

有关信息，请参阅第 14.9.9 节“MeCab 全文解析器”插件”。For related information, see Section 14.9.9, “MeCab Full-Text Parser Plugin”.

-DWITH_MSAN=bool -DWITH_MSAN=bool

是否启用 MemorySanitizer，对于支持的编译器它。默认关闭。Whether to enable MemorySanitizer, for compilers that support it. The default is off.

要使此选项在启用后生效，链接到 MySQL 的所有库也必须在启用该选项的情况下进行编译。For this option to have an effect if enabled, all libraries linked to MySQL must also have been compiled with the option enabled.

-DWITH_MSCRT_DEBUG=bool -DWITH_MSCRT_DEBUG=bool

是否启用 Visual Studio CRT 内存泄漏跟踪。默认值为 OFF。Whether to enable Visual Studio CRT memory leak tracing. The default is OFF.

-DMSVC_CPPCHECK=bool -DMSVC_CPPCHECK=bool

是否启用 MSVC 代码分析。默认为ON。Whether to enable MSVC code analysis. The default is ON.

-DWITH_MYSQLX=bool -DWITH_MYSQLX=bool

是否构建支持 X 插件。默认值为ON。请参阅第 22 章，使用 MySQL 作为文档存储。Whether to build with support for X Plugin. The default is ON. See Chapter 22, Using MySQL as a Document Store.

-DWITH_NUMA=bool -DWITH_NUMA=bool

显式设置 NUMA 内存分配策略。 CMake 根据当前平台是否支持 NUMA 设置默认的 WITH_NUMA 值。对于不支持 NUMA 的平台，CMake 的行为如下：Explicitly set the NUMA memory allocation policy. CMake sets the default WITH_NUMA value based on whether the current platform has NUMA support. For platforms without NUMA support, CMake behaves as follows:

-DWITH_PACKAGE_FLAGS=bool -DWITH_PACKAGE_FLAGS=bool

对于通常用于 RPM 和 Debian 软件包的标志，是否将它们添加到这些平台上的独立构建中。对于非调试版本，默认值为 ON。For flags typically used for RPM and Debian packages, whether to add them to standalone builds on those platforms. The default is ON for nondebug builds.

-DWITH_PROTOBUF=protobuf_type -DWITH_PROTOBUF=protobuf_type

要使用的 Protocol Buffers 包。 protobuf_type 可以是以下值之一：Which Protocol Buffers package to use. protobuf_type can be one of the following values:

其他值将被忽略，并回退到 bundled.Other values are ignored, with a fallback to bundled.

-DWITH_RAPID=bool -DWITH_RAPID=bool

是否构建快速开发周期插件。启用后，将在包含这些插件的构建树中创建一个 rapid 目录。禁用后，不会在构建树中创建 rapid 目录。默认值为 ON，除非 rapid 目录已从源代码树中删除，在这种情况下，默认值为 OFF。Whether to build the rapid development cycle plugins. When enabled, a rapid directory is created in the build tree containing these plugins. When disabled, no rapid directory is created in the build tree. The default is ON, unless the rapid directory is removed from the source tree, in which case the default becomes OFF.

-DWITH_RAPIDJSON=rapidjson_type -DWITH_RAPIDJSON=rapidjson_type

要包含的 RapidJSON 库支持的类型。 rapidjson_type 可以是以下值之一：The type of RapidJSON library support to include. rapidjson_type can be one of the following values:

-DWITH_ROUTER=bool -DWITH_ROUTER=bool

是否构建 MySQL Router。默认为 ON。Whether to build MySQL Router. The default is ON.

-DWITH_SASL=value -DWITH_SASL=value

内部使用仅。 Windows 上不支持。Internal use only. Not supported on Windows.

-DWITH_SSL={ssl_type|path_name} -DWITH_SSL={ssl_type|path_name}

为了支持加密连接、随机数生成的熵以及其他与加密相关的操作，MySQL 必须使用 SSL 库构建。此选项指定要使用哪个 SSL 库。For support of encrypted connections, entropy for random number generation, and other encryption-related operations, MySQL must be built using an SSL library. This option specifies which SSL library to use.

有关配置 SSL 库的更多信息，请参阅 第 2.8.6 节，“配置 SSL 库支持”。For additional information about configuring the SSL library, see Section 2.8.6, “Configuring SSL Library Support”.

-DWITH_SHOW_PARSE_TREE=bool -DWITH_SHOW_PARSE_TREE=bool

在服务器中启用对 SHOW PARSE_TREE 的支持，仅用于开发和调试。不用于发布版本或在生产中受支持。Enables support for SHOW PARSE_TREE in the server, used in development and debugging only. Not used for release builds or supported in production.

-DWITH_SYSTEMD=bool -DWITH_SYSTEMD=bool

是否启用安装systemd 支持文件。默认情况下，此选项处于禁用状态。启用后，将安装 systemd 支持文件，但不会安装 mysqld_safe 等脚本和 System V 初始化脚本。在 systemd 不可用的平台上，启用 WITH_SYSTEMD 会导致 CMake 出现错误。Whether to enable installation of systemd support files. By default, this option is disabled. When enabled, systemd support files are installed, and scripts such as mysqld_safe and the System V initialization script are not installed. On platforms where systemd is not available, enabling WITH_SYSTEMD results in an error from CMake.

使用此选项构建服务器时， MySQL 在服务器的错误日志中包含所有 systemd 消息（请参阅第 7.4.2 节“错误日志”）。When the server was built using this option, MySQL includes all systemd messages in the server's error log (see Section 7.4.2, “The Error Log”).

有关使用 systemd 的更多信息，请参阅第 2.5.9 节，“使用 systemd 管理 MySQL 服务器”。该部分还包括有关指定选项的信息，否则在 [mysqld_safe] 选项组中指定。由于使用 systemd 时未安装 mysqld_safe，因此必须以其他方式指定此类选项。For more information about using systemd, see Section 2.5.9, “Managing MySQL Server with systemd”. That section also includes information about specifying options otherwise specified in [mysqld_safe] option groups. Because mysqld_safe is not installed when systemd is used, such options must be specified another way.

-DWITH_SYSTEM_LIBS=bool -DWITH_SYSTEM_LIBS=bool

此选项用作 “umbrella” 选项，用于设置以下任何未明确设置的 CMake 选项的 system 值：WITH_CURL、WITH_EDITLINE、WITH_ICU、WITH_LIBEVENT、WITH_LZ4、WITH_LZMA，WITH_PROTOBUF，WITH_RE2，WITH_SSL、WITH_ZLIB、WITH_ZSTD。This option serves as an “umbrella” option to set the system value of any of the following CMake options that are not set explicitly: WITH_CURL, WITH_EDITLINE, WITH_ICU, WITH_LIBEVENT, WITH_LZ4, WITH_LZMA, WITH_PROTOBUF, WITH_RE2, WITH_SSL, WITH_ZLIB, WITH_ZSTD.

-DWITH_SYSTEMD_DEBUG=bool -DWITH_SYSTEMD_DEBUG=bool

是否为使用systemd运行 MySQL 的平台生成额外的systemd调试信息。默认值为 OFF。Whether to produce additional systemd debugging information, for platforms on which systemd is used to run MySQL. The default is OFF.

-DWITH_TCMALLOC=bool -DWITH_TCMALLOC=bool

是否与-ltcmalloc链接。如果启用，内置 malloc()、calloc()、realloc() 和 free() 例程将被禁用。默认值为 OFF。Whether to link with -ltcmalloc. If enabled, built-in malloc(), calloc(), realloc(), and free() routines are disabled. The default is OFF.

从 MySQL 8.4.1 开始，源代码中包含 tcmalloc 库；您可以通过将此选项设置为 BUNDLED 来使构建使用捆绑版本。 BUNDLED 仅在 Linux 系统上受支持。Beginning with MySQL 8.4.1, a tcmalloc library is included in the source; you can cause the build to use the bundled version by setting this option to BUNDLED. BUNDLED is supported on Linux systems only.

WITH_TCMALLOC 和 WITH_JEMALLOC 是互斥的。WITH_TCMALLOC and WITH_JEMALLOC are mutually exclusive.

-DWITH_TEST_TRACE_PLUGIN=bool -DWITH_TEST_TRACE_PLUGIN=bool

是否构建测试协议跟踪客户端插件（请参阅使用测试协议跟踪插件）。默认情况下，此选项处于禁用状态。除非启用 WITH_CLIENT_PROTOCOL_TRACING 选项，否则启用此选项无效。如果 MySQL 配置为启用这两个选项，则使用内置的测试协议跟踪插件构建 libmysqlclient 客户端库，并且所有标准 MySQL 客户端都会加载该插件。然而，即使启用了测试插件，默认情况下也没有效果。使用环境变量可以控制插件；请参阅使用测试协议跟踪插件。Whether to build the test protocol trace client plugin (see Using the Test Protocol Trace Plugin). By default, this option is disabled. Enabling this option has no effect unless the WITH_CLIENT_PROTOCOL_TRACING option is enabled. If MySQL is configured with both options enabled, the libmysqlclient client library is built with the test protocol trace plugin built in, and all the standard MySQL clients load the plugin. However, even when the test plugin is enabled, it has no effect by default. Control over the plugin is afforded using environment variables; see Using the Test Protocol Trace Plugin.

有关编写跟踪插件的信息，请参阅编写协议跟踪插件。For information about writing trace plugins, see Writing Protocol Trace Plugins.

-DWITH_TSAN=bool -DWITH_TSAN=bool

是否启用 ThreadSanitizer，对于支持它的编译器。默认关闭。Whether to enable the ThreadSanitizer, for compilers that support it. The default is off.

-DWITH_UBSAN=bool -DWITH_UBSAN=bool

是否为编译器启用未定义行为清理程序支持它。默认关闭。Whether to enable the Undefined Behavior Sanitizer, for compilers that support it. The default is off.

-DWITH_UNIT_TESTS={ON|OFF} -DWITH_UNIT_TESTS={ON|OFF}

如果启用，则使用单元测试编译 MySQL。默认值为 ON，除非未编译服务器。If enabled, compile MySQL with unit tests. The default is ON unless the server is not being compiled.

-DWITH_UNIXODBC=1 -DWITH_UNIXODBC=1

为 Connector/ODBC 启用 unixODBC 支持。Enables unixODBC support, for Connector/ODBC.

-DWITH_VALGRIND=bool -DWITH_VALGRIND=bool

是否在 Valgrind 头文件中编译，这会公开 Valgrind API 到 MySQL 代码。默认值为 OFF。Whether to compile in the Valgrind header files, which exposes the Valgrind API to MySQL code. The default is OFF.

要生成 Valgrind 感知的调试版本，-DWITH_VALGRIND=1 通常与 -DWITH_DEBUG=1。请参阅构建调试配置。To generate a Valgrind-aware debug build, -DWITH_VALGRIND=1 normally is combined with -DWITH_DEBUG=1. See Building Debug Configurations.

-DWITH_WIN_JEMALLOC=string -DWITH_WIN_JEMALLOC=string

在 Windows 上，传入包含 jemalloc.dll 的目录路径以启用 jemalloc 功能。构建系统将 jemalloc.dll 复制到与 mysqld.exe 和/或 mysqld-debug.exe 相同的目录，并利用它进行内存管理操作。如果未找到 jemalloc.dll 或未导出所需函数，则使用标准内存函数。信息级别日志消息记录是否找到并使用 jemalloc。On Windows, pass in a path to a directory containing jemalloc.dll to enable jemalloc functionality. The build system copies jemalloc.dll to the same directory as mysqld.exe and/or mysqld-debug.exe and utilizes it for memory management operations. Standard memory functions are used if jemalloc.dll is not found or does not export the required functions. An INFORMATION level log message records whether or not jemalloc is found and used.

此选项针对 Windows 的官方 MySQL 二进制文件启用。This option is enabled for official MySQL binaries for Windows.

-DWITH_ZLIB=zlib_type -DWITH_ZLIB=zlib_type

某些功能要求服务器构建时支持压缩库，例如 COMPRESS() 和 UNCOMPRESS() 函数，以及客户端/服务器协议的压缩。 WITH_ZLIB 选项指示 zlib 支持的来源：Some features require that the server be built with compression library support, such as the COMPRESS() and UNCOMPRESS() functions, and compression of the client/server protocol. The WITH_ZLIB option indicates the source of zlib support:

zlib 支持的最低版本为 1.2.13。The minimum supported version of zlib is 1.2.13.

-DWITH_ZSTD=zstd_type -DWITH_ZSTD=zstd_type

使用 zstd 算法进行连接压缩（请参阅第 6.2.8 节“连接压缩控制”）要求使用 zstd 库支持构建服务器。 WITH_ZSTD 选项指示 zstd 支持的来源：Connection compression using the zstd algorithm (see Section 6.2.8, “Connection Compression Control”) requires that the server be built with zstd library support. The WITH_ZSTD option indicates the source of zstd support:

-DWITHOUT_SERVER=bool -DWITHOUT_SERVER=bool

是否在没有 MySQL Server 的情况下构建。默认值为“关闭”，这会构建服务器。Whether to build without MySQL Server. The default is OFF, which does build the server.

这被认为是一个实验性选项；最好与服务器一起构建。This is considered an experimental option; it is preferred to build with the server.

此选项还可以阻止构建 NDB 存储引擎或任何 NDB 二进制文件，包括管理和数据节点程序。This option also prevents building of the NDB storage engine or any NDB binaries including management and data node programs.

-DCMAKE_C_FLAGS="flags" -DCMAKE_C_FLAGS="flags"

C 编译器的标志。Flags for the C compiler.

-DCMAKE_CXX_FLAGS="flags" -DCMAKE_CXX_FLAGS="flags"

C++ 编译器的标志。Flags for the C++ compiler.

-DWITH_DEFAULT_COMPILER_OPTIONS=bool -DWITH_DEFAULT_COMPILER_OPTIONS=bool

是否使用cmake/build_configurations/compiler_options.cmake中的标志。Whether to use the flags from cmake/build_configurations/compiler_options.cmake.

-DOPTIMIZE_SANITIZER_BUILDS=bool -DOPTIMIZE_SANITIZER_BUILDS=bool

是否将 -O1 -fno-inline 添加到 sanitizer 版本。默认值为 ON。Whether to add -O1 -fno-inline to sanitizer builds. The default is ON.

-DNDB_UTILS_LINK_DYNAMIC={ON|OFF} -DNDB_UTILS_LINK_DYNAMIC={ON|OFF}

控制 NDB 实用程序，例如 ndb_drop_table与 ndbclient 静态（OFF）或动态（ON）链接； OFF（静态链接）是默认值。通常在构建它们时使用静态链接以避免 LD_LIBRARY_PATH 出现问题，或者在安装多个版本的 ndbclient 时使用静态链接。此选项用于创建 Docker 映像以及可能的其他情况，在这些情况下，目标环境需要精确控制，并且需要减小映像大小。Controls whether NDB utilities such as ndb_drop_table are linked with ndbclient statically (OFF) or dynamically (ON); OFF (static linking) is the default. Normally static linking is used when building these to avoid problems with LD_LIBRARY_PATH, or when multiple versions of ndbclient are installed. This option is intended for creating Docker images and possibly other cases in which the target environment is subject to precise control and it is desirable to reduce image size.

-DWITH_CLASSPATH=path -DWITH_CLASSPATH=path

设置用于构建 Java 的 MySQL NDB Cluster Connector 的类路径。默认为空。如果使用 -DWITH_NDB_JAVA=OFF，则忽略此选项。Sets the classpath for building MySQL NDB Cluster Connector for Java. The default is empty. This option is ignored if -DWITH_NDB_JAVA=OFF is used.

-DWITH_ERROR_INSERT={ON|OFF} -DWITH_ERROR_INSERT={ON|OFF}

在 NDB 内核中启用错误注入。仅用于测试；不适用于构建生产二进制文件。默认为 OFF。Enables error injection in the NDB kernel. For testing only; not intended for use in building production binaries. The default is OFF.

-DWITH_NDB={ON|OFF} -DWITH_NDB={ON|OFF}

构建 MySQL NDB 集群；构建 NDB 插件和所有 NDB Cluster 程序。Build MySQL NDB Cluster; build the NDB plugin and all NDB Cluster programs.

-DWITH_NDBAPI_EXAMPLES={ON|OFF} -DWITH_NDBAPI_EXAMPLES={ON|OFF}

在 storage/ndb/ndbapi-examples/。有关这些的信息，请参阅 NDB API 示例。Build NDB API example programs in storage/ndb/ndbapi-examples/. See NDB API Examples, for information about these.

-DWITH_NDBCLUSTER_STORAGE_ENGINE={ON|OFF} -DWITH_NDBCLUSTER_STORAGE_ENGINE={ON|OFF}

（仅）控制构建中是否包含 NDBCLUSTER 存储引擎； WITH_NDB 自动启用此选项，因此建议您使用 WITH_NDB。Controls (only) whether the NDBCLUSTER storage engine is included in the build; WITH_NDB enables this option automatically, so it is recommended that you use WITH_NDB instead.

-DWITH_NDBCLUSTER={ON|OFF}（已弃用） -DWITH_NDBCLUSTER={ON|OFF} (DEPRECATED)

构建和链接以支持NDB mysqld 中的存储引擎。Build and link in support for the NDB storage engine in mysqld.

此选项已弃用，最终将被删除；请改用 WITH_NDB。This option is deprecated and subject to eventual removal; use WITH_NDB instead.

-DWITH_NDBMTD={ON|OFF} -DWITH_NDBMTD={ON|OFF}

构建多线程数据节点可执行文件ndbmtd。默认值为 ON。Build the multithreaded data node executable ndbmtd. The default is ON.

-DWITH_NDB_DEBUG={ON|OFF} -DWITH_NDB_DEBUG={ON|OFF}

启用构建 NDB Cluster 二进制文件的调试版本。默认情况下，这是 OFF。Enable building the debug versions of the NDB Cluster binaries. This is OFF by default.

-DWITH_NDB_JAVA={ON|OFF} -DWITH_NDB_JAVA={ON|OFF}

启用使用 Java 支持构建 NDB Cluster，包括对 ClusterJ 的支持（请参阅适用于 Java 的 MySQL NDB Cluster Connector）。Enable building NDB Cluster with Java support, including support for ClusterJ (see MySQL NDB Cluster Connector for Java).

此选项默认为ON。如果您不希望编译带有 Java 支持的 NDB Cluster，则必须在运行 CMake 时指定 -DWITH_NDB_JAVA=OFF 显式禁用它。否则，如果找不到 Java，则构建配置将失败。This option is ON by default. If you do not wish to compile NDB Cluster with Java support, you must disable it explicitly by specifying -DWITH_NDB_JAVA=OFF when running CMake. Otherwise, if Java cannot be found, configuration of the build fails.

-DWITH_NDB_PORT=port -DWITH_NDB_PORT=port

导致 NDB Cluster 管理服务器（ndb_mgmd）默认情况下，构建为使用此port。如果未设置此选项，默认情况下生成的管理服务器会尝试使用端口 1186。Causes the NDB Cluster management server (ndb_mgmd) that is built to use this port by default. If this option is unset, the resulting management server tries to use port 1186 by default.

-DWITH_NDB_TEST={ON|OFF} -DWITH_NDB_TEST={ON|OFF}

如果启用，请包含一组 NDB API 测试程序。默认为OFF。If enabled, include a set of NDB API test programs. The default is OFF.

-DWITH_NDB_TLS_SEARCH_PATH=path -DWITH_NDB_TLS_SEARCH_PATH=path

设置ndb_sign_keys 和其他用于 TLS 证书和密钥文件的 NDB 程序。Set the default path searched by ndb_sign_keys and other NDB programs for TLS certificate and key files.

Windows 平台的默认值为 $HOMEDIR/ndb-tls；对于其他平台，例如 Linux，它是$HOME/ndb-tls。The default for Windows platforms is $HOMEDIR/ndb-tls; for other platforms, such as Linux, it is $HOME/ndb-tls.