-DBUILD_CONFIG=mysql_release

このオプションは、オラクルが公式な MySQL リリースのバイナリ配布を生成するために使用するのと同じビルドオプションでソース配布を構成します。

-DBUNDLE_RUNTIME_LIBRARIES=bool

ランタイムライブラリを Windows 用のサーバー MSI および Zip パッケージにバンドルするかどうか。

-DCMAKE_BUILD_TYPE=type

生成するビルドのタイプ

-DCPACK_MONOLITHIC_INSTALL=bool

このオプションは、make package 操作が複数のインストールパッケージファイルを作成するか、単独のファイルを作成するかに影響します。 無効の場合、この操作は複数のインストールパッケージファイルを作成します。これは完全な MySQL インストールのサブセットのみをインストールする場合に便利です。 有効の場合、すべてをインストールするための単独のファイルを作成します。

-DFORCE_INSOURCE_BUILD=bool

ソース内ビルドを強制するかどうかを定義します。 アウトオブソースビルドでは同じソースからの複数のビルドが許可されるため、ビルドディレクトリを削除することでクリーンアップを迅速に実行できます。 ソース内ビルドを強制するには、-DFORCE_INSOURCE_BUILD=ON を使用して CMake を起動します。

-DCMAKE_INSTALL_PREFIX=dir_name

インストールのベースディレクトリ。

この値は、サーバー起動時に --basedir オプションで設定できます。

-DINSTALL_BINDIR=dir_name

ユーザープログラムをインストールする場所。

-DINSTALL_DOCDIR=dir_name

ドキュメントをインストールする場所。

-DINSTALL_DOCREADMEDIR=dir_name

README ファイルをインストールする場所。

-DINSTALL_INCLUDEDIR=dir_name

ヘッダーファイルをインストールする場所。

-DINSTALL_INFODIR=dir_name

Info ファイルをインストールする場所。

-DINSTALL_LAYOUT=name

事前定義インストールレイアウトを選択します。

事前定義のレイアウトを選択できますが、ほかのオプションを指定することによって、個々のコンポーネントのインストール場所を変更できます。 例:

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

INSTALL_LAYOUT の値によって、secure_file_priv、keyring_encrypted_file_data および keyring_file_data システム変数のデフォルト値が決まります。 セクション5.1.8「サーバーシステム変数」 および セクション6.4.4.13「キーリングシステム変数」 のこれらの変数の説明を参照してください。

-DINSTALL_LIBDIR=dir_name

ライブラリファイルをインストールする場所。

-DINSTALL_MANDIR=dir_name

マニュアルページをインストールする場所。

-DINSTALL_MYSQLKEYRINGDIR=dir_path

keyring_file プラグインデータファイルの場所として使用するデフォルトのディレクトリ。 デフォルト値はプラットフォーム固有で、INSTALL_LAYOUT CMake オプションの値によって異なります。セクション5.1.8「サーバーシステム変数」 の keyring_file_data システム変数の説明を参照してください。

-DINSTALL_MYSQLSHAREDIR=dir_name

共有データファイルをインストールする場所。

-DINSTALL_MYSQLTESTDIR=dir_name

mysql-test ディレクトリをインストールする場所。 このディレクトリのインストールを抑制するには、オプションを空の値 (-DINSTALL_MYSQLTESTDIR=) に明示的に設定します。

-DINSTALL_PKGCONFIGDIR=dir_name

pkg-config で使用する mysqlclient.pc ファイルをインストールするディレクトリ。 INSTALL_LIBDIR が/mysql で終わっていないかぎり、デフォルト値は INSTALL_LIBDIR/pkgconfig です。この場合は、最初に削除されます。

-DINSTALL_PLUGINDIR=dir_name

プラグインディレクトリの場所。

この値は、サーバー起動時に --plugin_dir オプションで設定できます。

-DINSTALL_PRIV_LIBDIR=dir_name

動的ライブラリディレクトリの場所。

デフォルトの場所: RPM = /usr/lib64/mysql/private/、DEB = /usr/lib/mysql/private/および TAR = lib/private/。

このオプションは MySQL 8.0.18 で追加されました。

Protobuf 用: これはプライベートな場所であるため、ローダー (Linux 上の ld-linux.so など) はヘルプなしで libprotobuf.so ファイルを見つけることができない場合があります。 ローダーをガイドするために、値 $ORIGIN/../$INSTALL_PRIV_LIBDIR を持つ RPATH が mysqld および mysqlxtest に追加されます。 これはほとんどの場合に機能しますが、Resource Group 機能を使用する場合、mysqld は setsuid であり、ローダーは $ORIGIN を含む RPATH を無視します。 これを解決するには、ターゲットの宛先が既知であるため、ディレクトリへの明示的なフルパスが mysqld の DEB および RPM バリアントに設定されます。 tarball インストールでは、patchelf などのツールを使用した mysqld のパッチ適用が必要です。

-DINSTALL_SBINDIR=dir_name

mysqld サーバーをインストールする場所。

-DINSTALL_SECURE_FILE_PRIVDIR=dir_name

secure_file_priv システム変数のデフォルト値。 デフォルト値はプラットフォーム固有で、INSTALL_LAYOUT CMake オプションの値によって異なります。セクション5.1.8「サーバーシステム変数」 の secure_file_priv システム変数の説明を参照してください。

-DINSTALL_SHAREDIR=dir_name

aclocal/mysql.m4 をインストールする場所。

-DINSTALL_STATIC_LIBRARIES=bool

静的ライブラリをインストールするかどうか。 デフォルトは ON です。 OFF に設定されている場合、これらのライブラリはインストールされません: libmysqlclient.a、libmysqlservices.a。

-DINSTALL_SUPPORTFILESDIR=dir_name

追加のサポートファイルをインストールする場所。

-DLINK_RANDOMIZE=bool

mysqld バイナリ内のシンボルの順序をランダム化するかどうか。 デフォルトは OFF です。 このオプションは、デバッグ目的でのみ有効にしてください。

-DLINK_RANDOMIZE_SEED=val

LINK_RANDOMIZE オプションのシード値。 値は文字列です。 デフォルトは、任意の選択肢である mysql です。

-DMYSQL_DATADIR=dir_name

MySQL データディレクトリの場所。

この値は、サーバー起動時に --datadir オプションで設定できます。

-DODBC_INCLUDES=dir_name

ODBC インクルードディレクトリの場所。Connector/ODBC の構成中に使用されることがあります。

-DODBC_LIB_DIR=dir_name

ODBC ライブラリディレクトリの場所。Connector/ODBC の構成中に使用されることがあります。

-DSYSCONFDIR=dir_name

デフォルトの my.cnf オプションファイルディレクトリ。

この場所はサーバー起動時にはセットできませんが、--defaults-file=file_name オプションを使用して、指定されたオプションファイルでサーバーを起動できます。ここで、file_name はファイルへのフルパス名です。

-DSYSTEMD_PID_DIR=dir_name

systemd によって MySQL が管理されている場合に PID ファイルを作成するディレクトリの名前。 デフォルトは/var/run/mysqld です。これは、INSTALL_LAYOUT の値に従って暗黙的に変更される場合があります。

WITH_SYSTEMD が有効になっていないかぎり、このオプションは無視されます。

-DSYSTEMD_SERVICE_NAME=name

MySQL が systemd によって管理されている場合に使用する MySQL サービスの名前。 デフォルトは mysqld です。これは、INSTALL_LAYOUT の値に従って暗黙的に変更される場合があります。

WITH_SYSTEMD が有効になっていないかぎり、このオプションは無視されます。

-DTMPDIR=dir_name

tmpdir システム変数に使用されるデフォルトの場所。 指定しない場合は、値はデフォルトで P_tmpdir in <stdio.h> になります。

-DADD_GDB_INDEX=bool

このオプションは、バイナリでの .gdb_index セクションの生成を有効にするかどうかを決定します。これにより、デバッガへのロードが高速になります。 このオプションはデフォルトで無効になっています。lld リンカーが使用され、lld または GNU gold 以外のリンカーが使用されている場合は無効になります。

このオプションは MySQL 8.0.18 で追加されました。

-DCOMPILATION_COMMENT=string

コンパイル環境に関する説明コメント。 MySQL 8.0.14 では、mysqld は COMPILATION_COMMENT_SERVER を使用します。 他のプログラムは引き続き COMPILATION_COMMENT を使用します。

-DCOMPRESS_DEBUG_SECTIONS=bool

バイナリ実行可能ファイルのデバッグセクションを圧縮するかどうか (Linux のみ)。 実行可能デバッグセクションを圧縮すると、構築プロセス中に余分な CPU 時間がかかるため、領域を節約できます。

デフォルトは OFF です。 このオプションが明示的に設定されていないが、COMPRESS_DEBUG_SECTIONS 環境変数が設定されている場合、このオプションはその変数から値を取得します。

このオプションは MySQL 8.0.22 で追加されました。

-DCOMPILATION_COMMENT_SERVER=string

mysqld で使用するコンパイル環境に関する説明コメント (version_comment システム変数の設定など)。 このオプションは MySQL 8.0.14 で追加されました。 8.0.14 より前では、サーバーは COMPILATION_COMMENT を使用します。

-DDEFAULT_CHARSET=charset_name

サーバーの文字セット。 デフォルトでは、MySQL は utf8mb4 文字セットを使用します。

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、utf8、utf8mb4、utf16、utf16le、utf32 のいずれかにできます。 許可される文字セットは、cmake/character_sets.cmake ファイルに CHARSETS_AVAILABLE の値としてリストされています。

この値は、サーバー起動時に --character_set_server オプションで設定できます。

-DDEFAULT_COLLATION=collation_name

サーバーの照合順序。 デフォルトでは、MySQL は utf8mb4_0900_ai_ci を使用します。 各文字セットにどの照合順序を使用するかを決めるには SHOW COLLATION ステートメントを使用します。

この値は、サーバー起動時に --collation_server オプションで設定できます。

-DDISABLE_PSI_COND=bool

パフォーマンススキーマ条件インストゥルメンテーションを除外するかどうか。 デフォルトは OFF (include) です。

-DDISABLE_PSI_FILE=bool

パフォーマンススキーマファイルインストゥルメンテーションを除外するかどうか。 デフォルトは OFF (include) です。

-DDISABLE_PSI_IDLE=bool

パフォーマンススキーマアイドルインストゥルメンテーションを除外するかどうか。 デフォルトは OFF (include) です。

-DDISABLE_PSI_MEMORY=bool

パフォーマンススキーマメモリーインストゥルメンテーションを除外するかどうか。 デフォルトは OFF (include) です。

-DDISABLE_PSI_METADATA=bool

パフォーマンススキーマメタデータの計測を除外するかどうか。 デフォルトは OFF (include) です。

-DDISABLE_PSI_MUTEX=bool

パフォーマンススキーマミューテックスのインストゥルメンテーションを除外するかどうか。 デフォルトは OFF (include) です。

-DDISABLE_PSI_RWLOCK=bool

パフォーマンススキーマ rwlock インストゥルメンテーションを除外するかどうか。 デフォルトは OFF (include) です。

-DDISABLE_PSI_SOCKET=bool

パフォーマンススキーマソケットインストゥルメンテーションを除外するかどうか。 デフォルトは OFF (include) です。

-DDISABLE_PSI_SP=bool

パフォーマンススキーマストアドプログラムインストゥルメンテーションを除外するかどうか。 デフォルトは OFF (include) です。

-DDISABLE_PSI_STAGE=bool

パフォーマンススキーマステージインストゥルメンテーションを除外するかどうか。 デフォルトは OFF (include) です。

-DDISABLE_PSI_STATEMENT=bool

パフォーマンススキーマステートメントインストゥルメンテーションを除外するかどうか。 デフォルトは OFF (include) です。

-DDISABLE_PSI_STATEMENT_DIGEST=bool

パフォーマンススキーマ statement_digest インストゥルメンテーションを除外するかどうか。 デフォルトは OFF (include) です。

-DDISABLE_PSI_TABLE=bool

「パフォーマンススキーマ」テーブルインストゥルメンテーションを除外するかどうか。 デフォルトは OFF (include) です。

-DDISABLE_SHARED=bool

ビルド共有ライブラリを無効にし、位置依存コードをコンパイルするかどうか。 デフォルトは OFF (位置独立コードのコンパイル) です。

このオプションは未使用であり、MySQL 8.0.18 で削除されました。

-DDISABLE_PSI_PS=bool

パフォーマンススキーマプリペアドステートメントのインスタンスインストゥルメンテーションを除外します。 デフォルトは OFF (include) です。

-DDISABLE_PSI_THREAD=bool

パフォーマンススキーマスレッドインストゥルメンテーションを除外します。 デフォルトは OFF (include) です。

ほかのインストゥルメンテーションはスレッドに依存しているため、インストゥルメンテーションなしで構築する場合にのみスレッドを無効にします。

-DDISABLE_PSI_TRANSACTION=bool

パフォーマンススキーマのトランザクションインストゥルメンテーションを除外します。 デフォルトは OFF (include) です。

-DDISABLE_PSI_DATA_LOCK=bool

パフォーマンススキーマデータロックインストゥルメンテーションを除外します。 デフォルトは OFF (include) です。

-DDISABLE_PSI_ERROR=bool

パフォーマンススキーマサーバーエラーの計測を除外します。 デフォルトは OFF (include) です。

-DDOWNLOAD_BOOST=bool

Boost ライブラリをダウンロードするかどうか デフォルトは OFF です。

Boost の使用方法の詳細は、WITH_BOOST オプションを参照してください。

-DDOWNLOAD_BOOST_TIMEOUT=seconds

Boost ライブラリをダウンロードするためのタイムアウト (秒)。 デフォルトは 600 秒です。

Boost の使用方法の詳細は、WITH_BOOST オプションを参照してください。

-DENABLE_DOWNLOADS=bool

オプションファイルをダウンロードするかどうか。 たとえば、このオプションを有効にすると、CMake は、ユニットテストを実行するためにテストスイートで使用される Google テストディストリビューション、または GCS Java ラッパーの構築に必要な Ant と JUnit をダウンロードします。

-DENABLE_EXPERIMENTAL_SYSVARS=bool

実験的な InnoDB システム変数を有効にするかどうか。 試験的なシステム変数は、MySQL 開発に関与するものを対象としており、開発環境またはテスト環境でのみ使用する必要があり、将来の MySQL リリースでは予告なしに削除される可能性があります。 実験システム変数については、MySQL ソースツリーの/storage/innobase/handler/ha_innodb.cc を参照してください。 試験的なシステム変数は、「PLUGIN_VAR_EXPERIMENTAL」 を検索することで識別できます。

-DENABLE_GCOV=bool

gcov サポートをインクルードするかどうか (Linux のみ)。

-DENABLE_GPROF=bool

gprof を有効にするかどうか (最適化された Linux ビルドのみ)。

-DENABLED_LOCAL_INFILE=bool

このオプションは、MySQL クライアントライブラリのコンパイル済みのデフォルトの LOCAL 機能を制御します。 したがって、明示的な配置を行わないクライアントでは、MySQL ビルド時に指定された ENABLED_LOCAL_INFILE 設定に従って、LOCAL 機能が無効または有効になります。

デフォルトでは、MySQL バイナリディストリビューションのクライアントライブラリは、ENABLED_LOCAL_INFILE を無効にしてコンパイルされます。 ソースから MySQL をコンパイルする場合は、明示的な配置を行わないクライアントで LOCAL 機能をそれぞれ無効にするか有効にするかに基づいて、ENABLED_LOCAL_INFILE を無効または有効にして構成します。

ENABLED_LOCAL_INFILE は、クライアント側の LOCAL 機能のデフォルトを制御します。 サーバーの場合、local_infile システム変数はサーバー側の LOCAL 機能を制御します。 サーバーが LOAD DATA LOCAL ステートメントを明示的に拒否または許可するようにするには (構築時または実行時にクライアントプログラムおよびライブラリがどのように構成されているかに関係なく)、それぞれ local_infile を無効または有効にして mysqld を起動します。local_infile は実行時に設定することもできます。 セクション6.1.6「LOAD DATA LOCAL のセキュリティー上の考慮事項」を参照してください。

-DENABLED_PROFILING=bool

クエリープロファイリングコードを有効にするかどうか (SHOW PROFILE および SHOW PROFILES ステートメントで)。

-DFORCE_UNSUPPORTED_COMPILER=bool

デフォルトでは、CMake はサポートされているコンパイラの最小バージョンをチェック: Visual Studio 2015 (Windows)、GCC 4.8 または Clang 3.4 (Linux)、Developer Studio 12.5 (Solaris サーバー)、Developer Studio 12.4 または GCC 4.8 (Solaris クライアントライブラリ)、Clang 3.6 (macOS)、Clang 3.4 (FreeBSD)。 このチェックを無効にするには、-DFORCE_UNSUPPORTED_COMPILER=ON を使用します。

-DFPROFILE_GENERATE=bool

プロファイルガイド付き最適化 (PGO) データを生成するかどうか。 このオプションは、GCC を使用した PGO の実験に使用できます。 FPROFILE_GENERATE および FPROFILE_USE の使用の詳細は、MySQL ソース配布の cmake/fprofile.cmake ファイルを参照してください。 これらのオプションは GCC 8 および 9 でテストされています。

このオプションは MySQL 8.0.19 で追加されました。

-DFPROFILE_USE=bool

プロファイルガイド付き最適化 (PGO) データを使用するかどうか。 このオプションは、GCC を使用した PGO の実験に使用できます。 FPROFILE_GENERATE および FPROFILE_USE の使用の詳細は、MySQL ソース配布の cmake/fprofile.cmake ファイルを参照してください。 これらのオプションは GCC 8 および 9 でテストされています。

FPROFILE_USE を有効にすると、WITH_LTO も有効になります。

このオプションは MySQL 8.0.19 で追加されました。

-DIGNORE_AIO_CHECK=bool

Linux で -DBUILD_CONFIG=mysql_release オプションが与えられた場合、デフォルトで libaio ライブラリがリンクされていなければなりません。 libaio がない場合、またはインストールしない場合、-DIGNORE_AIO_CHECK=1 を指定するとそのチェックを抑制できます。

-DMAX_INDEXES=num

テーブル当たりのインデックスの最大数。 デフォルトは 64 です。 最大値は 255 です。 64 より小さい値は無視され、デフォルトの 64 が使用されます。

-DMYSQL_MAINTAINER_MODE=bool

MySQL 管理者固有の開発環境を有効にするかどうか。 有効の場合、このオプションによりコンパイラの警告はエラーになります。

-DMUTEX_TYPE=type

InnoDB で使用される mutex タイプ。 次のようなオプションがあります。

-DMYSQLX_TCP_PORT=port_num

X プラグイン が TCP/IP 接続をリスニングするポート番号。 デフォルトは 33060 です。

この値は、サーバーの起動時に mysqlx_port システム変数を使用して設定できます。

-DMYSQLX_UNIX_ADDR=file_name

サーバーが X プラグイン ソケット接続をリスニングする Unix ソケットファイルのパス。 これは絶対パス名でなければなりません。 デフォルトは/tmp/mysqlx.sock です。

この値は、サーバーの起動時に mysqlx_port システム変数を使用して設定できます。

-DMYSQL_PROJECT_NAME=name

Windows または macOS の場合、プロジェクトファイル名に組み込むプロジェクト名。

-DMYSQL_TCP_PORT=port_num

サーバーが TCP/IP 接続を待機するポート番号。 デフォルトは 3306 です。

この値は、サーバー起動時に --port オプションで設定できます。

-DMYSQL_UNIX_ADDR=file_name

サーバーがソケット接続を待機する Unix ソケットファイルのパス。 これは絶対パス名でなければなりません。 デフォルトは /tmp/mysql.sock です。

この値は、サーバー起動時に --socket オプションで設定できます。

-DOPTIMIZER_TRACE=bool

オプティマイザのトレースをサポートするかどうか。 「MySQL Internals: Tracing the Optimizer」を参照してください。

-DREPRODUCIBLE_BUILD=bool

Linux システム上のビルドの場合、このオプションはビルドの場所と時間に関係なくビルド結果を作成するために特別な注意を払うかどうかを制御します。

このオプションは MySQL 8.0.11 で追加されました。 MySQL 8.0.12 では、RelWithDebInfo ビルド用の ON にデフォルト設定されます。

-DUSE_LD_GOLD=bool

GNU gold リンカーが使用可能で明示的に無効になっていない場合、CMake は構築プロセスを GNU gold リンカーにリンクします。 このリンカーの使用を無効にするには、-DUSE_LD_GOLD=OFF オプションを指定します。

-DUSE_LD_LLD=bool

構築プロセスが使用可能であり、明示的に無効になっていない場合、CMake はその構築プロセスを Clang 用の llvm lld リンカーにリンクします。 このリンカーの使用を無効にするには、-DUSE_LD_LLD=OFF オプションを指定します。

このオプションは MySQL 8.0.16 で追加されました。

-DWIN_DEBUG_NO_INLINE=bool

Windows で関数のインライン化を無効にするかどうか。 デフォルトは off (インライン化が有効) です。

-DWITH_ANT=path_name

GCS Java ラッパーの構築時に必要な Ant へのパスを設定します。 既存の WITH_BOOST CMake オプションと同様の方法で動作します。 Ant tarball またはすでに解凍されたアーカイブが保存されているディレクトリのパスに WITH_ANT を設定します。 WITH_ANT が設定されていない場合、または特別な値 system を使用して設定されている場合、ビルドでは $PATH にバイナリ ant が存在すると想定されます。

-DWITH_ASAN=bool

AddressSanitizer をサポートするコンパイラに対して有効にするかどうか。 デフォルトはオフです。

-DWITH_ASAN_SCOPE=bool

use-after-scope 検出に対して AddressSanitizer -fsanitize-address-use-after-scope Clang フラグを有効にするかどうか。 デフォルトはオフです。 このオプションを使用するには、-DWITH_ASAN も有効にする必要があります。

-DWITH_AUTHENTICATION_LDAP=bool

LDAP 認証プラグインを構築できない場合にエラーを報告するかどうか:

-DWITH_AUTHENTICATION_PAM=bool

このプラグインを含むソースツリーの PAM 認証プラグインを構築するかどうか。 (セクション6.4.1.5「PAM プラガブル認証」を参照してください。) このオプションが指定され、プラグインをコンパイルできない場合、ビルドは失敗します。

-DWITH_AWS_SDK=path_name

Amazon Web Services ソフトウェア開発キットの場所。

-DWITH_BOOST=path_name

MySQL をビルドするには Boost ライブラリが必要です。 これらの CMake オプションを使用すると、ライブラリのソースの場所、およびそれを自動的にダウンロードするかどうかを制御できます:

たとえば、通常、MySQL ソースツリーの bld サブディレクトリにオブジェクト出力を配置して MySQL をビルドする場合は、次のように Boost を使用してビルドできます:

mkdir bld
cd bld
cmake .. -DDOWNLOAD_BOOST=ON -DWITH_BOOST=$HOME/my_boost

これにより、Boost がホームディレクトリの下の my_boost ディレクトリにダウンロードされます。 必要な Boost バージョンがすでに存在する場合、ダウンロードは行われません。 必要な Boost バージョンが変更されると、新しいバージョンがダウンロードされます。

Boost がすでにローカルにインストールされていて、コンパイラが Boost ヘッダーファイルを単独で検出した場合は、前述の CMake オプションを指定する必要はありません。 ただし、MySQL に必要な Boost のバージョンが変更され、ローカルにインストールされたバージョンがアップグレードされていない場合は、ビルドの問題が発生している可能性があります。 CMake オプションを使用すると、ビルドが成功します。

指定した場所へのブーストダウンロードを許可する前述の設定では、必要なブーストバージョンが変更された場合、bld フォルダを削除して再作成し、cmake ステップを再度実行する必要があります。 そうしないと、新しい Boost バージョンがダウンロードされず、コンパイルが失敗する可能性があります。

-DWITH_CLIENT_PROTOCOL_TRACING=bool

クライアントライブラリにクライアント側プロトコルトレースフレームワークをビルドするかどうか。 デフォルトでは、このオプションは有効です。

プロトコルトレースクライアントプラグインの記述の詳細は、Writing Protocol Trace Plugins を参照してください。

WITH_TEST_TRACE_PLUGIN オプションも参照してください。

-DWITH_CURL=curl_type

curl ライブラリの場所。curl_type は、system (システム curl ライブラリを使用) または curl ライブラリへのパス名です。

-DWITH_DEBUG=bool

デバッグサポートを含めるかどうか。

デバッグサポートを有効にして MySQL を構成することにより、サーバーを起動するときに --debug="d,parser_debug" オプションを使用できるようになります。 これにより、SQL ステートメントの処理に使用される Bison パーサーが、パーサートレースをサーバーの標準エラー出力にダンプします。 一般的に、この出力はエラーログに書き込まれます。

InnoDB ストレージエンジンの同期デバッグチェックは UNIV_DEBUG で定義され、WITH_DEBUG オプションを使用してデバッグサポートをコンパイルするときに使用できます。 デバッグサポートがでコンパイルされている場合は、innodb_sync_debug 構成オプションを使用して、InnoDB 同期デバッグチェックを有効または無効にできます。

WITH_DEBUG を有効にすると、デバッグ同期も有効になります。 この機能はテストとデバッグに使用されます。 コンパイルされる場合、実行時には Debug Sync はデフォルトで無効です。 有効にするには、mysqld を --debug-sync-timeout=N オプションを使用して起動します。ここで、N は 0 より大きいタイムアウト値です。 (デフォルト値は 0 で、Debug Sync を無効にします。) N はそれぞれの同期ポイントのデフォルトのタイムアウトになります。

InnoDB ストレージエンジンの同期デバッグチェックは、WITH_DEBUG オプションを使用してデバッグサポートがコンパイルされている場合に使用できます。

Debug Sync 機能および同期点の使用方法についての説明は、「MySQL Internals: Test Synchronization」を参照してください。

-DWITH_DEFAULT_FEATURE_SET=bool

cmake/build_configurations/feature_set.cmake からのフラグを使用するかどうか。 このオプションは MySQL 8.0.22 で削除されました。

-DWITH_EDITLINE=value

どの libedit/editline ライブラリを使用するか。 許可される値は、bundled (デフォルト) および system です。

-DWITH_GMOCK=path_name

Google テストベースのユニットテストで使用する googlemock ディストリビューションへのパス。 オプション値は、配布 Zip ファイルへのパスです。 または、WITH_GMOCK 環境変数をパス名に設定します。 CMake が GitHub からディストリビューションをダウンロードできるように、-DENABLE_DOWNLOADS=1 を使用することもできます。

Google テストベースのユニットテストを使用せずに (WITH_GMOCK を構成して) MySQL をビルドすると、CMake によってダウンロード方法を示すメッセージが表示されます。

-DWITH_ICU={icu_type|path_name}

MySQL では、International Components for Unicode (ICU) を使用して正規表現操作をサポートしています。 WITH_ICU オプションは、含める ICU サポートのタイプまたは使用する ICU インストールのパス名を示します。

-DWITH_INNODB_EXTRA_DEBUG=bool

追加の InnoDB デバッグサポートを含めるかどうか。

WITH_INNODB_EXTRA_DEBUG を有効にすると、追加の InnoDB デバッグチェックが有効になります。 このオプションは、WITH_DEBUG が有効な場合にのみ有効にできます。

-DWITH_INNODB_MEMCACHED=bool

memcached 共有ライブラリ (libmemcached.so および innodb_engine.so) を生成するかどうか。

-DWITH_JEMALLOC=bool

-ljemalloc とリンクするかどうか。 有効にすると、組込み malloc(), calloc(), realloc() および free() ルーチンは無効になります。 デフォルトは OFF です。

WITH_JEMALLOC と WITH_TCMALLOC は相互に排他的です。

このオプションは MySQL 8.0.16 で追加されました。

-DWITH_KEYRING_TEST=bool

keyring_file プラグインに付属するテストプログラムをビルドするかどうか。 デフォルトは OFF です。 テストファイルのソースコードは、plugin/keyring/keyring-test ディレクトリにあります。

-DWITH_LIBEVENT=string

どの libevent ライブラリを使用するか。 許可される値は、bundled (デフォルト) および system です。 MySQL 8.0.21 より前では、system を指定すると、システム libevent ライブラリが存在する場合はそれが使用され、それ以外の場合はエラーが発生します。 MySQL 8.0.21 以降では、system が指定されていて、システム libevent ライブラリが見つからない場合、エラーが発生し、バンドルされている libevent は使用されません。

libevent ライブラリは、InnoDB memcached、X プラグイン、および MySQL Router に必要です。

-DWITH_LIBWRAP=bool

libwrap (TCP ラッパー) サポートを含めるかどうか。

-DWITH_LOCK_ORDER=bool

LOCK_ORDER ツールを有効にするかどうか。 デフォルトでは、このオプションは無効になっており、サーバービルドにツールは含まれていません。 ツールが有効な場合、LOCK_ORDER ツールは使用可能であり、セクション5.9.3「LOCK_ORDER ツール」 で説明されているように使用できます。

このオプションは MySQL 8.0.17 で追加されました。

-DWITH_LSAN=bool

AddressSanitizer を使用せずに LeakSanitizer を実行するかどうか。 デフォルトは OFF です。

このオプションは MySQL 8.0.16 で追加されました。

-DWITH_LTO=bool

コンパイラでサポートされている場合に、リンク時オプティマイザを有効にするかどうか。 FPROFILE_USE が有効でないかぎり、デフォルトは OFF です。

このオプションは MySQL 8.0.13 で追加されました。

-DWITH_LZ4=lz4_type

WITH_LZ4 は、zlib サポートのソースを示します:

-DWITH_LZMA=lzma_type

含める LZMA ライブラリサポートのタイプ。lzma_type は、次のいずれかの値です:

このオプションは MySQL 8.0.16 で削除されました。

-DWITH_MECAB={disabled|system|path_name}

このオプションを使用して、MeCab パーサーをコンパイルします。 MeCab をデフォルトのインストールディレクトリにインストールした場合は、-DWITH_MECAB=system を設定します。 system オプションは、ネイティブパッケージ管理ユーティリティを使用してソースまたはバイナリから実行される MeCab インストールに適用されます。 MeCab をカスタムインストールディレクトリにインストールした場合は、MeCab インストールへのパスを指定します。 たとえば、-DWITH_MECAB=/opt/mecab です。 system オプションが機能しない場合は、すべての場合に MeCab インストールパスを指定する必要があります。

関連情報については、セクション12.10.9「MeCab フルテキストパーサープラグイン」を参照してください。

-DWITH_MSAN=bool

MemorySanitizer をサポートするコンパイラに対して有効にするかどうか。 デフォルトはオフです。

このオプションを有効にするには、MySQL にリンクされているすべてのライブラリもオプションを有効にしてコンパイルされている必要があります。

-DWITH_MSCRT_DEBUG=bool

Visual Studio CRT メモリーリークトレースを有効にするかどうか。 デフォルトは OFF です。

-DWITH_MYSQLX=bool

X プラグイン のサポート付きでビルドするかどうか。 デフォルトの ON。 第20章「ドキュメントストアとしての MySQL の使用」を参照してください。

-DWITH_NUMA=bool

NUMA メモリー割当てポリシーを明示的に設定します。 CMake では、現在のプラットフォームに NUMA サポートがあるかどうかに基づいて、デフォルトの WITH_NUMA 値が設定されます。 NUMA がサポートされていないプラットフォームでは、CMake は次のように動作します:

-DWITH_PROTOBUF=protobuf_type

使用するプロトコルバッファパッケージ。protobuf_type は、次のいずれかの値です:

その他の値は無視され、bundled にフォールバックされます。

-DWITH_RAPID=bool

迅速な開発サイクルプラグインを構築するかどうか。 有効にすると、これらのプラグインを含むビルドツリーに rapid ディレクトリが作成されます。 無効にすると、ビルドツリーに rapid ディレクトリは作成されません。 rapid ディレクトリがソースツリーから削除されないかぎり、デフォルトは ON です。この場合、デフォルトは OFF になります。

-DWITH_RAPIDJSON=rapidjson_type

含める RapidJSON ライブラリサポートのタイプ。rapidjson_type は、次のいずれかの値です:

このオプションは MySQL 8.0.13 で追加されました。

-DWITH_RE2=re2_type

含める RE2 ライブラリサポートのタイプ。re2_type は、次のいずれかの値です:

MySQL 8.0.18 の時点で、MySQL は RE2 ライブラリを使用しなくなり、このオプションは削除されました。

-DWITH_ROUTER=bool

MySQL Router をビルドするかどうか。 デフォルトは ON です。

このオプションは MySQL 8.0.16 で追加されました。

-DWITH_SSL={ssl_type|path_name}

暗号化された接続、乱数生成のエントロピ、およびその他の暗号化関連の操作をサポートするには、SSL ライブラリを使用して MySQL を構築する必要があります。 このオプションは、使用する SSL ライブラリを指定します。

SSL ライブラリの構成の詳細は、を参照してください セクション2.9.6「SSL ライブラリサポートの構成」.

-DWITH_SYSTEMD=bool

systemd サポートファイルのインストールを有効にするかどうか。 デフォルトでは、このオプションは無効です。 有効にすると、systemd サポートファイルがインストールされ、mysqld_safe や System V 初期化スクリプトなどのスクリプトはインストールされません。 systemd を使用できないプラットフォームでは、WITH_SYSTEMD を有効にすると、CMake からエラーが発生します。

systemd の使用の詳細は、セクション2.5.9「systemd を使用した MySQL Server の管理」 を参照してください。 このセクションでは、[mysqld_safe]オプショングループで以前に指定されたオプションの指定についても説明します。 systemd の使用時に mysqld_safe はインストールされないため、このようなオプションは別の方法で指定する必要があります。

-DWITH_SYSTEM_LIBS=bool

このオプションは、明示的に設定されていない次の CMake オプションのいずれかの system 値を設定する「アンブレラ」オプションとして機能: 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

systemd を使用して MySQL を実行するプラットフォームについて、追加の systemd デバッグ情報を生成するかどうか。 デフォルトは OFF です。

このオプションは MySQL 8.0.22 で追加されました。

-DWITH_TCMALLOC=bool

-ltcmalloc とリンクするかどうか。 有効にすると、組込み malloc(), calloc(), realloc() および free() ルーチンは無効になります。 デフォルトは OFF です。

WITH_TCMALLOC と WITH_JEMALLOC は相互に排他的です。

このオプションは MySQL 8.0.22 で追加されました。

-DWITH_TEST_TRACE_PLUGIN=bool

テストプロトコルトレースクライアントプラグインをビルドするかどうか (Using the Test Protocol Trace Plugin を参照)。 デフォルトでは、このオプションは無効です。 WITH_CLIENT_PROTOCOL_TRACING オプションが有効になっていないかぎり、このオプションを有効にしても効果はありません。 MySQL が両方のオプションを有効にして構成されている場合、libmysqlclient クライアントライブラリはテストプロトコルトレースプラグインが組み込まれた状態で構築され、すべての標準 MySQL クライアントがプラグインをロードします。 ただし、テストプラグインが有効になっていても、デフォルトでは何の効果もありません。 プラグインの制御は、環境変数を使用して行います。Using the Test Protocol Trace Plugin を参照してください。

トレースプラグインの書込みの詳細は、Writing Protocol Trace Plugins を参照してください。

-DWITH_TSAN=bool

ThreadSanitizer をサポートするコンパイラに対して有効にするかどうか。 デフォルトはオフです。

-DWITH_UBSAN=bool

未定義の動作サニタイザをサポートするコンパイラに対して、サニタイザを有効にするかどうか。 デフォルトはオフです。

-DWITH_UNIT_TESTS={ON|OFF}

有効な場合は、ユニットテストを使用して MySQL をコンパイルします。 サーバーがコンパイルされていない場合を除き、デフォルトは ON です。

-DWITH_UNIXODBC=1

Connector/ODBC に関して、unixODBC サポートを有効にします。

-DWITH_VALGRIND=bool

Valgrind ヘッダーファイルをコンパイルするかどうか。これにより、Valgrind API が MySQL コードに公開されます。 デフォルトは OFF です。

Valgrind 対応のデバッグビルドを生成するには、-DWITH_VALGRIND=1 は通常 -DWITH_DEBUG=1 と組み合わされます。 Building Debug Configurations を参照してください。

-DWITH_ZLIB=zlib_type

一部の機能では、サーバーが COMPRESS() および UNCOMPRESS() 関数などの圧縮ライブラリサポートでビルドされていること、およびクライアント/サーバープロトコルの圧縮を必要とします。 WITH_ZLIB は zlib サポートのソースを示します。

-DWITH_ZSTD=zstd_type

zstd アルゴリズムを使用した接続圧縮 (セクション4.2.8「接続圧縮制御」 を参照) では、zstd ライブラリのサポートを使用してサーバーを構築する必要があります。 WITH_ZSTD は、zstd サポートのソースを示します:

このオプションは MySQL 8.0.18 で追加されました。

-DCMAKE_C_FLAGS="flags"

C コンパイラのフラグ。

-DCMAKE_CXX_FLAGS="flags"

C++ コンパイラのフラグ。

-DWITH_DEFAULT_COMPILER_OPTIONS=bool

cmake/build_configurations/compiler_options.cmake からのフラグを使用するかどうか。

-DMEMCACHED_HOME=dir_name

dir_name によって示されるシステムディレクトリにインストールされている memcached (バージョン 1.6 以降) を使用してビルドを実行します。 ビルドに使用されるこのインストールからのファイルは、memcached バイナリ、ヘッダーファイル、およびライブラリに加えて、memcached_utilities ライブラリおよびヘッダーファイル engine_testapp.h を含みます。

ndbmemcache を、バンドルの memcached ソースを使用してビルドする場合 (WITH_BUNDLED_MEMCACHED オプション)、このオプションはセットしないでください。すなわち、デフォルトでバンドルのソースが使用されます。

SASL 承認および dtrace サポートを提供するための追加の CMake オプションは外部ソースから memcached をコンパイルするときに使用できますが、NDB Cluster にバンドルされている memcached ソースではこれらのオプションは現在有効になっていません。

-NDB_UTILS_LINK_DYNAMIC={ON|OFF}

ndb_drop_table などの NDB ユーティリティーを ndbclient と静的にリンクするか (OFF)、動的にリンクするか (ON) を制御します。OFF (静的リンク) がデフォルトです。 通常、静的リンクは、LD_LIBRARY_PATH の問題を回避するため、または複数のバージョンの ndbclient がインストールされている場合に、これらを構築する場所で使用されます。 このオプションは、Docker イメージを作成することを目的としており、ターゲット環境が正確に制御される可能性があり、イメージサイズを小さくすることが望ましい場合もあります。

NDB 8.0.22 に追加されました。

-DWITH_BUNDLED_LIBEVENT={ON|OFF}

ndbmemcached サポートを使用して NDB Cluster を構築する場合は、NDB Cluster ソースに含まれている libevent を使用します。 デフォルトで有効。 OFF では、かわりにシステム libevent が使用されます。

-DWITH_BUNDLED_MEMCACHED={ON|OFF}

NDB Cluster ソースツリーに含まれる memcached ソースを構築し、ndbmemcache エンジンの構築時に結果の memcached サーバーを使用します。 この場合、make install は memcached バイナリをインストール bin ディレクトリに配置し、ndbmemcache エンジン共有ライブラリファイル ndb_engine.so をインストール lib ディレクトリに配置します。

このオプションはデフォルトで ON です。

-DWITH_CLASSPATH=path

NDB Cluster Connector for Java を構築するためのクラスパスを設定します。 デフォルトは空です。 -DWITH_NDB_JAVA=OFF を使用する場合、このオプションは無視されます。

-DWITH_ERROR_INSERT={ON|OFF}

NDB カーネルのエラーインジェクションを有効化します。 テスト専用です。本番環境のバイナリのビルドに使用することは意図していません。 デフォルトは OFF です。

-DWITH_NDBCLUSTER_STORAGE_ENGINE={ON|OFF}

これは WITH_NDBCLUSTER のエイリアスです。

-DWITH_NDBCLUSTER={ON|OFF}

mysqld で NDB (NDBCLUSTER) ストレージエンジンのサポートのビルドおよびリンク。 デフォルトは ON です。

-DWITH_NDBMTD={ON|OFF}

マルチスレッドデータノード実行可能ファイル ndbmtd を構築します。 デフォルトは ON です。

-DWITH_NDB_BINLOG={ON|OFF}

このオプションを使用して、mysqld ビルド内でデフォルトでバイナリロギングを有効にします。 デフォルトで ON です。

-DWITH_NDB_DEBUG={ON|OFF}

NDB Cluster バイナリのデバッグバージョンの構築を有効にします。 デフォルトで OFF です。

-DWITH_NDB_JAVA={ON|OFF}

ClusterJ を含む Java サポートを使用した NDB Cluster の構築を有効にします。

このオプションはデフォルトで ON です。 NDB Cluster を Java サポート付きでコンパイルしない場合は、CMake の実行時に -DWITH_NDB_JAVA=OFF を指定して明示的に無効にする必要があります。 そうしないと、Java が検出できない場合にビルドの構成が失敗します。

-DWITH_NDB_PORT=port

この port をデフォルトで使用するように構築された NDB Cluster 管理サーバー (ndb_mgmd) を生成します。 このオプションがセットされていない場合、結果の管理サーバーはデフォルトでポート 1186 を使用しようとします。

-DWITH_NDB_TEST={ON|OFF}

有効の場合、NDB API テストプログラムをインクルードします。 デフォルトは OFF です。

-DWITH_PLUGIN_NDBCLUSTER={ON|OFF}

WITH_NDBCLUSTER のエイリアス。