2.9.4. MySQL Source-Configuration Options

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

shell> cmake . -LHshell> ccmake .

Можно также влиять на CMake использование определенных переменных окружения. См. Раздел 2.12, "Переменные окружения".

Следующая таблица показывает доступные варианты CMake. В Default столбец, PREFIX стенды для значения CMAKE_INSTALL_PREFIX опция, которая определяет каталог основы установки. Это значение используется в качестве родительского расположения для нескольких из подкаталогов установки.

Таблица 2.13. MySQL Source-Configuration Option Reference (CMake)

Форматы	Описание	Значение по умолчанию	Представленный
`BUILD_CONFIG`	Используйте то же самое создает опции как официальные выпуски
`CMAKE_BUILD_TYPE`	Тип создает, чтобы произвести	`RelWithDebInfo`
`CMAKE_INSTALL_PREFIX`	Каталог основы установки	`/usr/local/mysql`
`COMPILATION_COMMENT`	Комментарий о среде компиляции
`CPACK_MONOLITHIC_INSTALL`	Создает ли пакет, производит единственный файл	`OFF`
`DEFAULT_CHARSET`	Набор символов сервера значения по умолчанию	`latin1`
`DEFAULT_COLLATION`	Сопоставление сервера значения по умолчанию	`latin1_swedish_ci`
`ENABLE_DEBUG_SYNC`	Включить ли поддержке Синхронизации Отладки	`ON`
`ENABLE_DOWNLOADS`	Загрузить ли дополнительные файлы	`OFF`
`ENABLE_DTRACE`	Включать ли поддержку DTrace
`ENABLE_GCOV`	Включать ли поддержку gcov
`ENABLE_GPROF`	Включите gprof (оптимизировал Linux, создает только),	`OFF`
`ENABLED_LOCAL_INFILE`	Включить ли ЛОКАЛЬНЫЙ для ДАННЫХ ЗАГРУЗКИ INFILE	`OFF`
`ENABLED_PROFILING`	Включить ли коду профилирования запроса	`ON`
`IGNORE_AIO_CHECK`	С-DBUILD_CONFIG=mysql_release проигнорируйте проверку libaio	`OFF`
`INSTALL_BINDIR`	Пользовательский исполнимый каталог	`PREFIX/bin`
`INSTALL_DOCDIR`	Каталог документации	`PREFIX/docs`
`INSTALL_DOCREADMEDIR`	Каталог файла README	`PREFIX`
`INSTALL_INCLUDEDIR`	Каталог заголовочного файла	`PREFIX/include`
`INSTALL_INFODIR`	Каталог информационного файла	`PREFIX/docs`
`INSTALL_LAYOUT`	Выберите предопределенное расположение установки	`STANDALONE`
`INSTALL_LIBDIR`	Каталог файла библиотеки	`PREFIX/lib`
`INSTALL_MANDIR`	Каталог страницы руководства	`PREFIX/man`
`INSTALL_MYSQLSHAREDIR`	Совместно используемый каталог данных	`PREFIX/share`
`INSTALL_MYSQLTESTDIR`	mysql-тестовый каталог	`PREFIX/mysql-test`
`INSTALL_PLUGINDIR`	Сменный каталог	`PREFIX/lib/plugin`
`INSTALL_SBINDIR`	Исполнимый каталог сервера	`PREFIX/bin`
`INSTALL_SCRIPTDIR`	Каталог сценариев	`PREFIX/scripts`
`INSTALL_SHAREDIR`	каталог установки aclocal/mysql.m4	`PREFIX/share`
`INSTALL_SQLBENCHDIR`	каталог sql-места-размещения	`PREFIX`
`INSTALL_SUPPORTFILESDIR`	Дополнительный каталог файлов поддержки	`PREFIX/support-files`
`MAX_INDEXES`	Максимум индексирует на таблицу	`64`	5.7.1
`MYSQL_DATADIR`	Каталог данных
`MYSQL_MAINTAINER_MODE`	Включить ли MySQL обслуживающая специфичная среда разработки	`OFF`
`MYSQL_PROJECT_NAME`	Название проекта Windows/Mac OS X	`3306`
`MYSQL_TCP_PORT`	Номер порта TCP/IP	`3306`
`MYSQL_UNIX_ADDR`	Файл сокета Unix	`/tmp/mysql.sock`
`ODBC_INCLUDES`	ODBC включает каталог
`ODBC_LIB_DIR`	Каталог библиотеки ODBC
`OPTIMIZER_TRACE`	Поддерживать ли трассировку оптимизатора
`SYSCONFDIR`	Каталог файла опции
`WITH_DEBUG`	Включать ли поддержку отладки	`OFF`
`WITH_DEFAULT_COMPILER_OPTIONS`	Использовать ли опции компилятора значения по умолчанию	`ON`
`WITH_DEFAULT_FEATURE_SET`	Использовать ли набор функций значения по умолчанию	`ON`
`WITH_EDITLINE`	Какой libedit/editline библиотекой пользоваться	`bundled`	5.7.2
`WITH_EMBEDDED_SERVER`	Создать ли встроенный сервер	`OFF`
`WITH_xxx_STORAGE_ENGINE`	Скомпилируйте механизм хранения xxx статически в сервер
`WITH_EXTRA_CHARSETS`	Какие дополнительные наборы символов включать	`all`
`WITH_INNODB_MEMCACHED`	Генерировать ли memcached совместно использованные библиотеки.	`OFF`
`WITH_LIBWRAP`	Включать ли libwrap (обертки TCP) поддержка	`OFF`
`WITH_SSL`	Тип поддержки SSL	`no`
`WITH_UNIXODBC`	Включите поддержке unixODBC	`OFF`
`WITH_ZLIB`	Тип поддержки zlib	`system`
`WITHOUT_xxx_STORAGE_ENGINE`	Исключите механизм хранения xxx из, создают

Следующие разделы предоставляют больше информации об опциях CMake.

Для булевых опций значение может быть определено как 1 или ON включать опции, или как 0 или OFF отключить опцию.

Много опций конфигурируют значения по умолчанию времени компиляции, которые могут быть переопределены при запуске сервера. Например, CMAKE_INSTALL_PREFIX, MYSQL_TCP_PORT, и MYSQL_UNIX_ADDR опции, которые конфигурируют расположение каталога основы установки значения по умолчанию, номер порта TCP/IP, и файл сокета Unix, могут быть изменены при запуске сервера с --basedir, --port, и --socket опции для mysqld. Где применимый, описания параметра конфигурации указывают на соответствующую опцию запуска mysqld.

Общие параметры

-DBUILD_CONFIG=mysql_release

Эта опция конфигурирует исходное распределение с тем же самым, создают опции, используемые Oracle, чтобы произвести двоичные дистрибутивы для официальных выпусков MySQL.
-DCMAKE_BUILD_TYPE=type

Тип создает, чтобы произвести:
- RelWithDebInfo: Включите оптимизации и генерируйте отладочную информацию. Это - MySQL значения по умолчанию, создают тип.
- Debug: Отключите оптимизацию и генерируйте отладочную информацию. Это создает тип, также используется если WITH_DEBUG опция включается. Таким образом, -DWITH_DEBUG=1 имеет тот же самый эффект как -DCMAKE_BUILD_TYPE=Debug.
-DCPACK_MONOLITHIC_INSTALL=bool

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

Опции Расположения установки

CMAKE_INSTALL_PREFIX опция указывает на основной каталог установки. Другие опции с именами формы INSTALL_xxx это указывает, что компонентные расположения интерпретируются относительно префикса, и их значения являются относительными путями. Их значения не должны включать префикс.

-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

Где установить Информационные файлы.
-DINSTALL_LAYOUT=name

Выберите предопределенное расположение установки:
- STANDALONE: То же самое расположение как использующийся для .tar.gz и .zip пакеты. Это - значение по умолчанию.
- RPM: Расположение, подобное пакетам ОБ/МИН.
- SVR4: Расположение пакета Соляриса.
- DEB: (Экспериментальное) расположение пакета DEB.
Можно выбрать предопределенное расположение, но изменить отдельные компонентные расположения установки, определяя другие опции. Например:
```
shell> cmake . -DINSTALL_LAYOUT=SVR4
                    -DMYSQL_DATADIR=/var/mysql/data
```
-DINSTALL_LIBDIR=dir_name

Где установить файлы библиотеки.
-DINSTALL_MANDIR=dir_name

Где установить страницы руководства.
-DINSTALL_MYSQLSHAREDIR=dir_name

Где установить совместно используемые файлы данных.
-DINSTALL_MYSQLTESTDIR=dir_name

Где установить mysql-test каталог. С MySQL 5.7.2, чтобы подавить установку этого каталога, явно устанавливают опцию в пустое значение (-DINSTALL_MYSQLTESTDIR=).
-DINSTALL_PLUGINDIR=dir_name

Расположение сменного каталога.

Это значение может быть установлено при запуске сервера с --plugin_dir опция.
-DINSTALL_SBINDIR=dir_name

Где установить mysqld сервер.
-DINSTALL_SCRIPTDIR=dir_name

Где установить mysql_install_db.
-DINSTALL_SHAREDIR=dir_name

Где установить aclocal/mysql.m4.
-DINSTALL_SQLBENCHDIR=dir_name

Где установить sql-bench каталог. Чтобы подавить установку этого каталога, явно установите опцию в пустое значение (-DINSTALL_SQLBENCHDIR=).
-DINSTALL_SUPPORTFILESDIR=dir_name

Где установить дополнительные файлы поддержки.
-DMYSQL_DATADIR=dir_name

Расположение каталога данных MySQL.

Это значение может быть установлено при запуске сервера с --datadir опция.
-DOPTIMIZER_TRACE=bool

Поддерживать ли трассировку оптимизатора. См. MySQL Internals: Трассировка Оптимизатора.
-DSYSCONFDIR=dir_name

Значение по умолчанию my.cnf каталог файла опции.

Это расположение не может быть установлено при запуске сервера, но можно запустить сервер с данного файла опции, используя --defaults-file=file_name опция, где file_name имя полного пути к файлу.
-DODBC_INCLUDES=dir_name

Расположение ODBC включает каталог, и может использоваться, конфигурируя Соединитель/ODBC.
-DODBC_LIB_DIR=dir_name

Расположение каталога библиотеки ODBC, и может использоваться, конфигурируя Соединитель/ODBC.

Опции Механизма хранения

Механизмы хранения создаются как плагины. Можно создать плагин как статический модуль (скомпилированный в сервер) или динамический модуль (созданный как динамическая библиотека, которая должна быть установлена в сервер, используя INSTALL PLUGIN оператор или --plugin-load опция прежде, чем это сможет использоваться). Некоторые плагины не могли бы поддерживать статическое или динамическое здание.

MyISAM, MERGE, MEMORY, и CSV механизмы обязательны (всегда скомпилированный в сервер) и не должны быть установлены явно.

Чтобы скомпилировать механизм хранения статически в сервер, использовать -DWITH_engine_STORAGE_ENGINE=1. Некоторые допустимые engine значения ARCHIVE, BLACKHOLE, EXAMPLE, FEDERATED, INNOBASE (InnoDB), PARTITION (делящий поддержку), и PERFSCHEMA (Схема производительности). Примеры:

-DWITH_INNOBASE_STORAGE_ENGINE=1-DWITH_ARCHIVE_STORAGE_ENGINE=1-DWITH_BLACKHOLE_STORAGE_ENGINE=1-DWITH_PERFSCHEMA_STORAGE_ENGINE=1

Чтобы исключить механизм хранения из создавания, использовать -DWITHOUT_engine_STORAGE_ENGINE=1. Примеры:

-DWITHOUT_EXAMPLE_STORAGE_ENGINE=1-DWITHOUT_FEDERATED_STORAGE_ENGINE=1-DWITHOUT_PARTITION_STORAGE_ENGINE=1

Если ни один -DWITH_engine_STORAGE_ENGINE ни -DWITHOUT_engine_STORAGE_ENGINE определяются для данного механизма хранения, механизм создается как совместно используемый модуль, или исключается, если он не может быть создан как совместно используемый модуль.

Опции функции

-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 опция.
-DENABLE_DEBUG_SYNC=bool

Скомпилировать ли средство Синхронизации Отладки в сервер. Это средство используется для тестирования и отладки. Эта опция включается по умолчанию, но не имеет никакого эффекта, если MySQL не конфигурируется с отладкой включенного. Если отладка включается, и Вы хотите отключить Синхронизацию Отладки, использовать -DENABLE_DEBUG_SYNC=0.

Когда компилирующийся в, Синхронизация Отладки отключается по умолчанию во времени выполнения. Чтобы включить этому, запустите mysqld с --debug-sync-timeout=N опция, где N значение тайм-аута, больше чем 0. (Значение по умолчанию 0, который отключает Синхронизацию Отладки.) N становится тайм-аутом значения по умолчанию для отдельных точек синхронизации.

Для описания средства Синхронизации Отладки и как использовать точки синхронизации, см. MySQL Internals: Тестовая Синхронизация.
-DENABLE_DOWNLOADS=bool

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

Включать ли поддержку зондов DTrace. Для получения информации о DTrace, крошечный Раздел 5.7, "Прослеживая mysqld Используя DTrace"
-DENABLE_GCOV=bool

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

Включить ли gprof (оптимизированный Linux создает только).
-DENABLED_LOCAL_INFILE=bool

Включить ли LOCAL возможность в клиентской библиотеке для LOAD DATA INFILE.

Эта опция управляет стороной клиента LOCAL возможность, но возможность может быть установлена на стороне сервера при запуске сервера с --local-infile опция. См. Раздел 6.1.6, "Вопросы безопасности с LOAD DATA LOCAL".
-DENABLED_PROFILING=bool

Включить ли коду профилирования запроса (для SHOW PROFILE и SHOW PROFILES операторы).
-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 обслуживающая специфичная среда разработки. Если включено, эта опция заставляет предупреждения компилятора становиться ошибками.
-DMYSQL_PROJECT_NAME=name

Для Windows или Mac OS X, название проекта, чтобы соединиться в имя файла проекта.
-DMYSQL_TCP_PORT=port_num

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

Это значение может быть установлено при запуске сервера с --port опция.
-DMYSQL_UNIX_ADDR=file_name

Путь к файлу сокета Unix, на котором сервер прислушивается к сокетным соединениям. Это должно быть абсолютным путем. Значение по умолчанию /tmp/mysql.sock.

Это значение может быть установлено при запуске сервера с --socket опция.
-DWITH_DEBUG=bool

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

Конфигурирование MySQL с отладкой поддержки позволяет Вам использовать --debug="d,parser_debug" опция, когда Вы запускаете сервер. Это вызывает синтаксический анализатор Бизона, который используется, чтобы обработать SQL-операторы, чтобы вывести трассировку синтаксического анализатора к стандартному выводу ошибок сервера. Как правило, этот вывод пишется журналу ошибок.
-DWITH_DEFAULT_COMPILER_OPTIONS=bool

Использовать ли флаги от cmake/build_configurations/compiler_options.cmake.
-DWITH_DEFAULT_FEATURE_SET=bool

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

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

WITH_EDITLINE был добавлен в MySQL 5.7.2. Это заменяет WITH_LIBEDIT, который был удален.
-DWITH_EMBEDDED_SERVER=bool

Создать ли libmysqld встроенная библиотека сервера.
-DWITH_EXTRA_CHARSETS=name

Какие дополнительные наборы символов включать:
- all: Все наборы символов. Это - значение по умолчанию.
- complex: Сложные наборы символов.
- none: Никакие дополнительные наборы символов.
-DWITH_INNODB_EXTRA_DEBUG=bool

Включать ли дополнительный InnoDB, отлаживая поддержку.

Включение WITH_INNODB_EXTRA_DEBUG включает дополнительные проверки отладки InnoDB. Эта опция может только быть включена когда WITH_DEBUG включается.
-DWITH_INNODB_MEMCACHED=bool

Генерировать ли memcached совместно использованные библиотеки (libmemcached.so и innodb_engine.so).
-DWITH_LIBWRAP=bool

Включать ли libwrap (Обертки TCP) поддержка.
-DWITH_SSL={ssl_type|path_name}

Тип SSL поддерживает, чтобы включать или путь в установку OpenSSL, чтобы использовать.
- ssl_type может быть одно из следующих значений:
  - yes: Пользуйтесь системной библиотекой SSL если существующий, еще библиотека, связанная распределением.
  - bundled: Пользуйтесь библиотекой SSL, связанной распределением. Это - значение по умолчанию.
  - system: Пользуйтесь системной библиотекой SSL.
- path_name путь к установке OpenSSL, чтобы использовать. Используя это может быть предпочтительным для использования ssl_type значение system, поскольку это может препятствовать тому, чтобы CMake обнаружил и использовал более старую или неправильную версию OpenSSL, установленную на системе. (Другой разрешенный способ сделать ту же самую вещь состоит в том, чтобы установить CMAKE_PREFIX_PATH опция к path_name.)
Для получения информации об использовании поддержки SSL см. Раздел 6.3.9, "Используя SSL для Безопасных Соединений".
-DWITH_ZLIB=zlib_type

Некоторые функции требуют, чтобы сервер был создан с поддержкой библиотеки сжатия, такой как COMPRESS() и UNCOMPRESS() функции, и сжатие клиент-серверного протокола. WITH_ZLIB указывает на источник zlib поддержка:
- bundled: Используйте zlib библиотека связывалась с распределением.
- system: Используйте систему zlib библиотека. Это - значение по умолчанию.
-DWITH_UNIXODBC=1

Включает поддержке unixODBC, для Соединителя/ODBC.

Флаги компилятора

Чтобы определить флаги компилятора, установите CFLAGS и CXXFLAGS переменные окружения прежде, чем выполнить CMake. Пример:

shell> CFLAGS=-DHAVE_EMBEDDED_PRIVILEGE_CONTROLshell> CXXFLAGS=-DHAVE_EMBEDDED_PRIVILEGE_CONTROLshell> export CFLAGS CXXFLAGSshell> cmake
        [options]

Следующие флаги управляют функциями конфигурации:

HAVE_EMBEDDED_PRIVILEGE_CONTROL

По умолчанию аутентификация для соединений со встроенным сервером отключается. Чтобы включить аутентификации соединения, определите этот флаг.