Обновлена 15 сентября 2026 г. в 08:55

cfg_basic

background

Начиная с версии 1.6.2.

Запуск сервера в качестве фоновой задачи. Для работы этого параметра значения параметров log и pid_file должны быть заданы.

Тип: boolean

Значение по умолчанию: false

Переменная окружения: TT_BACKGROUND

Динамический: нет

coredump

Создание файлов дампа памяти (coredump).

Обычно для получения дампов памяти администратору необходимо выполнить ulimit -c unlimited (или задать соответствующие параметры в файле модуля systemd) перед запуском процесса Tarantool. Если параметр coredump включен, Tarantool самостоятельно устанавливает соответствующее ограничение ресурса, и администратору не нужно выполнять ulimit -c unlimited (см. man 3 setrlimit).

Этот параметр также задает состояние атрибута dumpable, который включен по умолчанию, но может быть сброшен при определенных обстоятельствах (см. man 2 prctl, PR_SET_DUMPABLE).

Тип: boolean

Переменная окружения: TT_COREDUMP

Значение по умолчанию: false

Динамический: нет

custom_proc_title

Начиная с версии 1.6.7.

Добавляет указанную строку к заголовку процесса сервера (отображается в колонке COMMAND для команд ps -ef и top -c).

Например, обычно ps -ef отображает процесс сервера Tarantool следующим образом:


$ ps -ef | grep tarantool1000     14939 14188  1 10:53 pts/2    00:00:13 tarantool <running>

Но если в параметрах конфигурации указано custom_proc_title='sessions', то вывод будет выглядеть так:


$ ps -ef | grep tarantool1000     14939 14188  1 10:53 pts/2    00:00:16 tarantool <running>: sessions

Тип: string

Значение по умолчанию: null

Переменная окружения: TT_CUSTOM_PROC_TITLE

Динамический: да

listen

Начиная с версии 1.6.4.

Номер порта для чтения/записи данных или строка URI (универсальный идентификатор ресурса). Значение по умолчанию отсутствует, поэтому параметр должен быть указан, если подключения осуществляются от удаленных клиентов, не использующих "административный порт". Подключения, созданные с помощью listen = {URI}, называются подключениями по «бинарному порту» или «бинарному протоколу».

Типичное значение – 3301.


box.cfg { listen = 3301 }box.cfg { listen = "127.0.0.1:3301" }

Начиная с версии 2.10.0 можно указать несколько URI, а номер порта всегда хранится как целочисленное значение.

Тип: integer или string

Значение по умолчанию: null

Переменная окружения: TT_LISTEN

Динамический: да

memtx_dir

Начиная с версии 1.7.4.

Каталог, в котором memtx хранит файлы снимков (.snap). Относительный путь в этом параметре интерпретируется относительно work_dir.

По умолчанию файлы снимков и WAL хранятся в одном каталоге. Однако можно задать разные значения для параметров memtx_dir и wal_dir, чтобы хранить их на разных физических дисках для повышения производительности.

Тип: string

Значение по умолчанию: "."

Переменная окружения: TT_MEMTX_DIR

Динамический: нет

pid_file

Начиная с версии 1.4.9.

Идентификатор процесса сохраняется в этом файле. Путь может быть относительным к work_dir. Типичное значение – «tarantool.pid».

Тип: string

Значение по умолчанию: null

Переменная окружения: TT_PID_FILE

Динамический: нет

read_only

Начиная с версии 1.7.1.

Укажите box.cfg{read_only=true...}, чтобы перевести экземпляр сервера в режим только для чтения. После этого любые запросы, пытающиеся изменить постоянные данные, завершатся с ошибкой ER_READONLY. Режим только для чтения следует использовать для репликации типа мастер-реплика. Режим только для чтения не влияет на запросы на изменение данных для спейсов, определенных как временные. Хотя режим только для чтения предотвращает запись сервера в WAL, он не препятствует записи диагностических сообщений с помощью модуля логирования.

Тип: boolean

Значение по умолчанию: false

Переменная окружения: TT_READ_ONLY

Динамический: да

Установка значения read_only == true по-разному влияет на спейсы в зависимости от параметров, заданных при вызове box.schema.space.create, как показано в таблице:

Параметр	Можно	Можно	Реплицируется?	Хранится
(по умолчанию)	нет	нет	да	да
temporary	нет	да	нет	нет
is_local	нет	да	нет	да

Параметр

Можно

Реплицируется?

Хранится

(по умолчанию)

нет

да

temporary

нет

да

нет

is_local

нет

да

нет

да

#### sql_cache_size {params[anchor=cfg_basic-sql_cache_size]} Начиная с версии 2.3.1.

Максимальный объем памяти в байтах для кэша подготовленных SQL-выражений. (Фактически используемый объем памяти в байтах можно узнать с помощью box.info.sql().cache.size.)

Тип: number

Значение по умолчанию: 5242880

Переменная окружения: TT_SQL_CACHE_SIZE

Динамический: да

vinyl_dir

Начиная с версии 1.7.1.

Каталог, в котором будут храниться файлы или подкаталоги vinyl. Путь может быть относительным к work_dir. Если не указан, используется значение work_dir.

Тип: string

Значение по умолчанию: "."

Переменная окружения: TT_VINYL_DIR

Динамический: нет

vinyl_timeout

Начиная с версии 1.7.5.

В движке хранения vinyl есть планировщик, выполняющий компактизацию. При нехватке доступной памяти планировщик компактизации может не успевать обрабатывать входящие запросы на обновление. В такой ситуации запросы могут завершаться по истечении времени ожидания в vinyl_timeout секунд. Это должно происходить редко, так как обычно vinyl ограничивает скорость вставки при нехватке ресурсов для компактизации. Компактизацию также можно запустить вручную с помощью index_object:compact().

Тип: float

Значение по умолчанию: 60

Переменная окружения: TT_VINYL_TIMEOUT

Динамический: да

username

Начиная с версии 1.4.9.

Имя пользователя UNIX, на которое переключается процесс после запуска.

Тип: string

Значение по умолчанию: null

Переменная окружения: TT_USERNAME

Динамический: нет

wal_dir

Начиная с версии 1.6.2.

Каталог, в котором хранятся файлы журнала предзаписи (.xlog). Относительный путь в этом параметре интерпретируется относительно work_dir.

По умолчанию файлы WAL и снимки хранятся в одном каталоге. Однако можно задать разные значения для параметров wal_dir и memtx_dir, чтобы хранить их на разных физических дисках для повышения производительности.

Тип: string

Значение по умолчанию: "."

Переменная окружения: TT_WAL_DIR

Динамический: нет

work_dir

Начиная с версии 1.4.9.

Каталог, в котором будут храниться рабочие файлы базы данных. После запуска экземпляр сервера переключается в work_dir с помощью chdir(2). Путь может быть относительным к текущему каталогу. Если не указан, используется текущий каталог. Другие параметры каталогов могут быть относительными к work_dir, например:


box.cfg{    work_dir = '/home/user/A',    wal_dir = 'B',    memtx_dir = 'C'}

файлы xlog будут помещены в /home/user/A/B, файлы снимков – в /home/user/A/C, а все остальные файлы или подкаталоги – в /home/user/A.

Тип: string

Значение по умолчанию: null

Переменная окружения: TT_WORK_DIR

Динамический: нет

worker_pool_threads

Начиная с версии 1.7.5.

Максимальное количество потоков, используемых при выполнении определенных внутренних процессов (в настоящее время socket.getaddrinfo() и coio_call()).

Тип: integer

Значение по умолчанию: 4

Переменная окружения: TT_WORKER_POOL_THREADS

Динамический: да

strip_core

Начиная с версии 2.2.2.

Определяет, должны ли файлы дампа памяти включать память, выделенную для кортежей. (Этот объем может быть большим, если Tarantool работает под высокой нагрузкой.) Значение true означает «не включать». В более ранней версии Tarantool значением по умолчанию для этого параметра было false.

Тип: boolean

Значение по умолчанию: true

Переменная окружения: TT_STRIP_CORE

Динамический: нет

memtx_use_mvcc_engine

Начиная с версии 2.6.1.

Если установлено значение true, включается менеджер транзакций.

Тип: boolean

Значение по умолчанию: false

Переменная окружения: TT_MEMTX_USE_MVCC_ENGINE

Динамический: нет

Была ли статья полезна?

Была ли статья полезна?