-DCOMPILATION_COMMENT=string

Описательный комментарий к среде компиляции.

-DDEFAULT_CHARSET=charset_name

Набор символов сервера. По умолчанию MySQL использует набор символов latin1 (cp1252 Западная Европа).

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 использует latin1_swedish_ci. Используйте оператор SHOW COLLATION для определения доступных правил сортировки для каждого набора символов.

Это значение можно установить при запуске сервера с помощью опции --collation_server.

-DDISABLE_PSI_COND=bool

Включить или исключить инструментарий для проверки условия Performance Schema. По умолчанию OFF (включить).

-DDISABLE_PSI_FILE=bool

Включить или исключить инструментарий для работы с файлами Performance Schema. По умолчанию OFF (включить).

-DDISABLE_PSI_IDLE=bool

Включить или исключить инструментарий для работы в режиме ожидания Performance Schema. По умолчанию OFF (включить).

-DDISABLE_PSI_MEMORY=bool

Включить или исключить инструментарий для работы с памятью Performance Schema. По умолчанию OFF (включить).

-DDISABLE_PSI_METADATA=bool

Включить или исключить инструментарий для работы с метаданными Performance Schema. По умолчанию OFF (включить).

-DDISABLE_PSI_MUTEX=bool

Включить или исключить инструментарий для работы с мьютексами Performance Schema. По умолчанию OFF (включить).

-DDISABLE_PSI_RWLOCK=bool

Включить или исключить инструментарий для работы с rwlock Performance Schema. По умолчанию OFF (включить).

-DDISABLE_PSI_SOCKET=bool

Включить или исключить инструментарий для работы с сокетами Performance Schema. По умолчанию OFF (включить).

-DDISABLE_PSI_SP=bool

Включить или исключить инструментарий для работы с хранимыми процедурами Performance Schema. По умолчанию OFF (включить).

-DDISABLE_PSI_STAGE=bool

Включить или исключить инструментарий для работы с этапами Performance Schema. По умолчанию OFF (включить).

-DDISABLE_PSI_STATEMENT=bool

Включить или исключить инструментарий для работы с операторами Performance Schema. По умолчанию OFF (включить).

-DDISABLE_PSI_STATEMENT_DIGEST=bool

Включить или исключить инструментарий для работы с дайджестами операторов Performance Schema. По умолчанию OFF (включить).

-DDISABLE_PSI_TABLE=bool

Включить или исключить инструментарий для работы с таблицами Performance Schema. По умолчанию OFF (включить).

-DDISABLE_PSI_PS=bool

Исключить инструментарий Performance Schema для экземпляров подготовленных операторов. По умолчанию OFF (включить).

-DDISABLE_PSI_THREAD=bool

Исключить инструментарий Performance Schema для потоков. По умолчанию OFF (включить).

Отключать потоки следует только при сборке без какого-либо инструментария, так как другие инструментарии зависят от потоков.

-DDISABLE_PSI_TRANSACTION=bool

Исключить инструментарий Performance Schema для транзакций. По умолчанию OFF (включить).

-DDOWNLOAD_BOOST=bool

Скачать библиотеку Boost. По умолчанию OFF.

См. опцию WITH_BOOST для дополнительной информации об использовании Boost.

-DDOWNLOAD_BOOST_TIMEOUT=seconds

Время ожидания в секундах для загрузки библиотеки Boost. По умолчанию 600 секунд.

См. опцию WITH_BOOST для дополнительной информации об использовании Boost.

-DENABLE_DOWNLOADS=bool

Скачать необязательные файлы. Например, при включенной этой опции CMake загружает дистрибутив Google Test, который используется набором тестов для запуска юнит-тестов.

-DENABLE_DTRACE=bool

Включить поддержку зондирования DTrace. Для информации о DTrace см. Раздел 5.8.4, “Отслеживание mysqld с помощью DTrace”

Эта опция устарела, так как поддержка DTrace устарела в MySQL 5.7 и удалена в MySQL 8.0.

-DENABLE_GCOV=bool

Включить поддержку gcov (только Linux).

-DENABLE_GPROF=bool

Включить gprof (только оптимизированные сборки Linux).

-DENABLED_LOCAL_INFILE=bool

Данная опция управляет включенной по умолчанию возможностью LOCAL для библиотеки MySQL клиента. Клиенты, которые не принимают явных решений, поэтому имеют возможность LOCAL отключенной или включенной в соответствии с настройкой ENABLED_LOCAL_INFILE, указанной во время сборки MySQL.

По умолчанию библиотека клиента в дистрибутивах MySQL бинарных файлов скомпилирована с ENABLED_LOCAL_INFILE выключенной. (До MySQL 5.7.6 она была включена по умолчанию.) Если вы компилируете MySQL из исходников, настройте его с ENABLED_LOCAL_INFILE выключенной или включенной в зависимости от того, должны ли клиенты, не принимающие явных решений, иметь возможность LOCAL выключенной или включенной соответственно.

ENABLED_LOCAL_INFILE управляет по умолчанию возможностью LOCAL на стороне клиента. Для сервера, переменная local_infile управляет возможностью LOCAL на стороне сервера. Чтобы явно заставить сервер отказать или разрешить операторы LOAD DATA LOCAL (независимо от того, как конфигурируются программы и библиотеки клиентов во время компиляции или выполнения), запустите mysqld с --local-infile выключенной или включенной соответственно. local_infile также может быть установлено во время выполнения. См. Раздел 6.1.6, “Учет безопасности для LOAD DATA LOCAL”.

-DENABLED_PROFILING=bool

Включать ли код профилирования запросов (для операторов SHOW PROFILE и SHOW PROFILES).

-DFORCE_UNSUPPORTED_COMPILER=bool

По умолчанию CMake проверяет минимальные версии поддерживаемых компиляторов: Visual Studio 2013 (Windows); GCC 4.4 или Clang 3.3 (Linux); Developer Studio 12.5 (Solaris server); Developer Studio 12.2 или GCC 4.4 (Solaris client library); Clang 3.3 (macOS), Clang 3.3 (FreeBSD). Чтобы отключить эту проверку, используйте -DFORCE_UNSUPPORTED_COMPILER=ON.

-DIGNORE_AIO_CHECK=bool

Если задан параметр -DBUILD_CONFIG=mysql_release в Linux, библиотека libaio должна быть по умолчанию связана. Если у вас нет libaio или вы не хотите устанавливать её, вы можете подавить проверку, указав -DIGNORE_AIO_CHECK=1.

-DMAX_INDEXES=num

Максимальное количество индексов на таблицу. Значение по умолчанию — 64. Максимальное значение — 255. Значения меньше 64 игнорируются, и используется значение по умолчанию 64.

-DMYSQL_MAINTAINER_MODE=bool

Включать ли среду разработки, специфичную для сопровождающих MySQL. Если включено, этот параметр приводит к тому, что предупреждения компилятора становятся ошибками.

-DMUTEX_TYPE=type

Тип мьютекса, используемый InnoDB. Варианты включают:

-DMYSQLX_TCP_PORT=port_num

Номер порта, на котором X Plugin прослушивает TCP/IP-подключения. Значение по умолчанию — 33060.

Это значение можно установить при запуске сервера с помощью системной переменной mysqlx_port.

-DMYSQLX_UNIX_ADDR=file_name

Путь к файлу Unix-соккета, на котором сервер прослушивает подключения X Plugin сокета. Это должно быть абсолютное имя пути. Значение по умолчанию — /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

Поддерживать ли трассировку оптимизатора. Смотрите Раздел 8.15, «Трассировка оптимизатора».

-DREPRODUCIBLE_BUILD=bool

Для сборок в Linux-системах этот параметр управляет тем, следует ли проявлять дополнительную осторожность при создании результата сборки, независимого от местоположения и времени сборки.

Этот параметр был добавлен в MySQL 5.7.19.

-DWIN_DEBUG_NO_INLINE=bool

Отключать ли встраивание функций в Windows. Значение по умолчанию — OFF (встраивание включено).

-DWITH_ASAN=bool

Включать ли AddressSanitizer для компиляторов, которые его поддерживают. Значение по умолчанию — OFF.

-DWITH_ASAN_SCOPE=bool

Включать ли флаг AddressSanitizer -fsanitize-address-use-after-scope Clang для обнаружения использования после выхода из области видимости. Значение по умолчанию — выключено. Для использования этого параметра, -DWITH_ASAN также должен быть включен.

-DWITH_AUTHENTICATION_LDAP=bool

Сообщать ли об ошибке, если плагины аутентификации LDAP не могут быть собраны:

Для получения информации об аутентификации LDAP, см. Раздел 6.4.1.9, «LDAP Pluggable Authentication». Этот параметр был добавлен в MySQL 5.7.19.

-DWITH_AUTHENTICATION_PAM=bool

Компилировать ли плагин аутентификации PAM для деревьев исходных кодов, которые включают этот плагин. (См. Раздел 6.4.1.7, «PAM Pluggable Authentication».) Если этот параметр указан, и плагин не может быть скомпилирован, сборка завершается неудачей.

-DWITH_AWS_SDK=path_name

Расположение пакета разработки Amazon Web Services.

Этот параметр был добавлен в MySQL 5.7.19.

-DWITH_BOOST=path_name

Библиотека Boost необходима для сборки MySQL. Эти параметры 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. Однако, если версия Boost, необходимая для MySQL, изменится, и локально установленная версия не будет обновлена, у вас могут возникнуть проблемы со сборкой. Использование параметров CMake должно обеспечить успешную сборку.

С приведенными выше настройками, которые позволяют загружать Boost в указанное место, когда необходимая версия Boost изменится, вам нужно удалить папку 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.

Этот параметр был добавлен в MySQL 5.7.19.

-DWITH_DEBUG=bool

Включать ли поддержку отладки.

Настройка MySQL с поддержкой отладки позволяет использовать параметр --debug="d,parser_debug" при запуске сервера. Это приводит к тому, что синтаксический анализатор Bison, используемый для обработки операторов SQL, выгружает трассировку анализатора в стандартный вывод ошибок сервера. Обычно этот вывод записывается в лог ошибок.

Проверка синхронизации отладки для движка хранения InnoDB определяется в UNIV_DEBUG и доступна, когда поддержка отладки компилируется с использованием параметра WITH_DEBUG. Когда поддержка отладки компилируется, параметр конфигурации innodb_sync_debug может использоваться для включения или отключения проверки синхронизации отладки InnoDB.

Начиная с MySQL 5.7.18, включение WITH_DEBUG также включает отладку синхронизации. Описание функции отладки синхронизации и порядок использования точек синхронизации см. в разделе MySQL Internals: Test Synchronization.

-DWITH_DEFAULT_FEATURE_SET=bool

Использовать ли флаги из cmake/build_configurations/feature_set.cmake.

-DWITH_EDITLINE=value

Какую библиотеку libedit/editline использовать. Допустимые значения: bundled (по умолчанию) и system.

WITH_EDITLINE заменяет WITH_LIBEDIT, который был удален.

-DWITH_EMBEDDED_SERVER=bool

Создавать ли библиотеку встроенного сервера libmysqld.

-DWITH_EMBEDDED_SHARED_LIBRARY=bool

Создавать ли общую библиотеку встроенного сервера libmysqld.

-DWITH_EXTRA_CHARSETS=name

Какие дополнительные кодировки включить:

-DWITH_GMOCK=path_name

Путь к дистрибутиву googlemock, для использования с модульными тестами на основе Google Test. Значение параметра — путь к дистрибутивному Zip-файлу. В качестве альтернативы задайте переменную среды WITH_GMOCK с именем пути. Также можно использовать -DENABLE_DOWNLOADS=1, в этом случае CMake загрузит дистрибутив с GitHub.

Если вы создаете MySQL без модульных тестов Google Test (настраивая без WITH_GMOCK), CMake отобразит сообщение о том, как его загрузить.

-DWITH_INNODB_EXTRA_DEBUG=bool

Включать ли дополнительную поддержку отладки InnoDB.

Включение WITH_INNODB_EXTRA_DEBUG включает дополнительные проверки отладки InnoDB. Этот параметр может быть включен только тогда, когда включен WITH_DEBUG.

-DWITH_INNODB_MEMCACHED=bool

Создавать ли общие библиотеки memcached (libmemcached.so и innodb_engine.so).

-DWITH_KEYRING_TEST=bool

Создавать ли тестовую программу, которая сопровождает плагин keyring_file. Значение по умолчанию — OFF. Исходный код тестового файла находится в каталоге plugin/keyring/keyring-test.

Этот параметр был добавлен в MySQL 5.7.11.

-DWITH_LDAP=value

Только для внутреннего использования. Этот параметр был добавлен в MySQL 5.7.29.

-DWITH_LIBEVENT=string

Какую библиотеку libevent использовать. Допустимые значения: bundled (по умолчанию) и system. До MySQL 5.7.31, если вы указываете system, используется системная библиотека libevent, если она присутствует, и возникает ошибка в противном случае. В MySQL 5.7.31 и более поздних версиях, если указано system и не найдена системная библиотека libevent, возникает ошибка независимо от этого, и встроенная libevent не используется.

Библиотека libevent необходима для memcached и плагина X.

-DWITH_LIBWRAP=bool

Включать ли поддержку libwrap (TCP wrappers).

-DWITH_LZ4=lz4_type

Параметр WITH_LZ4 указывает источник поддержки zlib:

-DWITH_MECAB={disabled|system|path_name}

Используйте этот параметр для компиляции парсера MeCab. Если вы установили MeCab в его каталог установки по умолчанию, установите -DWITH_MECAB=system. Параметр system применяется к установкам MeCab, выполненным из исходного кода или из двоичных файлов с помощью утилиты управления пакетами. Если вы установили MeCab в пользовательский каталог установки, укажите путь к установке MeCab, например, -DWITH_MECAB=/opt/mecab. Если параметр system не работает, указание пути установки MeCab должно работать во всех случаях.

Для получения дополнительной информации см. Раздел 12.9.9, «Плагин парсера полнотекстового поиска MeCab».

-DWITH_MSAN=bool

Включать ли MemorySanitizer для компиляторов, которые его поддерживают. По умолчанию отключено.

Для того чтобы этот параметр действовал, если он включен, все библиотеки, связанные с MySQL, также должны быть скомпилированы с включенным параметром.

-DWITH_MSCRT_DEBUG=bool

Включать ли трассировку утечек памяти Visual Studio CRT. Значение по умолчанию — OFF.

-DWITH_NUMA=bool

Явно задать политику распределения памяти NUMA. CMake устанавливает значение по умолчанию для WITH_NUMA на основе наличия поддержки NUMA на текущей платформе. Для платформ без поддержки NUMA CMake ведет себя следующим образом:

Эта опция была добавлена в MySQL 5.7.17.

-DWITH_PROTOBUF=protobuf_type

Какой пакет Protocol Buffers использовать. protobuf_type может принимать следующие значения:

Другие значения игнорируются, с возвратом к значению bundled.

Эта опция была добавлена в MySQL 5.7.12.

-DWITH_RAPID=bool

Включать или нет плагины для быстрого цикла разработки. При включении в дереве сборки создается директория rapid, содержащая эти плагины. При отключении директория rapid не создается. Значение по умолчанию — ON, если только директория rapid не удалена из дерева исходного кода, в этом случае значение по умолчанию становится OFF. Эта опция была добавлена в MySQL 5.7.12.

-DWITH_SASL=value

Только для внутреннего использования. Эта опция была добавлена в MySQL 5.7.29. Не поддерживается на Windows.

-DWITH_SSL={ssl_type|path_name}

Для поддержки шифрованных подключений, генерации случайных чисел и других операций, связанных с шифрованием, MySQL должен быть скомпилирован с использованием библиотеки SSL. Эта опция определяет, какую библиотеку SSL использовать.

Дополнительную информацию о настройке библиотеки SSL см. в разделе 2.8.6, «Настройка поддержки библиотеки SSL».

-DWITH_SYSTEMD=bool

Включить или нет установку файлов поддержки systemd. По умолчанию эта опция отключена. При включении устанавливаются файлы поддержки systemd, а скрипты, такие как mysqld_safe и скрипт инициализации System V, не устанавливаются. На платформах, где systemd недоступен, включение WITH_SYSTEMD приводит к ошибке в CMake.

Более подробную информацию об использовании systemd см. в разделе 2.5.10, «Управление MySQL-сервером с помощью systemd». В этом разделе также содержится информация о задании параметров, которые в противном случае указываются в группах опций [mysqld_safe]. Поскольку mysqld_safe не устанавливается при использовании systemd, такие параметры нужно указать другим способом.

-DWITH_TEST_TRACE_PLUGIN=bool

Включить или нет плагин клиента отслеживания трассировки протокола тестов (см. Использование плагина трассировки протокола тестов). По умолчанию эта опция отключена. Включение этой опции не имеет эффекта, если не включена опция WITH_CLIENT_PROTOCOL_TRACING. Если MySQL настроен с обеими включенными опциями, клиентская библиотека libmysqlclient компилируется с встроенным плагином трассировки протокола тестов, и все стандартные клиенты MySQL загружают этот плагин. Однако даже при включенном плагине тестов он по умолчанию не действует. Управление плагином осуществляется с помощью переменных среды; см. Использование плагина трассировки протокола тестов.

Сведения о написании плагинов трассировки см. в Руководстве по написанию плагинов трассировки протоколов.

-DWITH_UBSAN=bool

Включить или нет Undefined Behavior Sanitizer для компиляторов, поддерживающих эту функцию. По умолчанию отключено.

-DWITH_UNIT_TESTS={ON|OFF}

При включении MySQL компилируется с тестами модулей. По умолчанию — ON, если сервер не компилируется.

-DWITH_UNIXODBC=1

Включает поддержку unixODBC для Connector/ODBC.

-DWITH_VALGRIND=bool

Включить или нет заголовки Valgrind, которые предоставляют API Valgrind для кода MySQL. По умолчанию — OFF.

Для создания сборки отладки, поддерживающей Valgrind, опцию -DWITH_VALGRIND=1 обычно комбинируют с -DWITH_DEBUG=1. См. Настройка конфигураций отладки.

-DWITH_ZLIB=zlib_type

Некоторые функции требуют поддержки библиотек сжатия, таких как функции COMPRESS() и UNCOMPRESS(), и сжатия клиентского/серверного протокола. Опция WITH_ZLIB указывает источник поддержки zlib:

-DWITHOUT_SERVER=bool

Скомпилировать без MySQL-сервера. По умолчанию — ВЫКЛ., что означает компиляцию сервера.

Эта опция считается экспериментальной; предпочтительнее компилировать с сервером.