4.2.1.2.1.2. Настройки баз данных
Шаблоны файлов настройки базы данных есть в папке установке в подпапке server_home_template. Шаблоны обновляются при переустановке Astra.Historian и всегда соответствуют установленной версии.
|
Настройки в файле db.jsonc
Пример файла:
{
"format": "4x"
}
|
Для применения изменений в файле, нужно перезагрузить Astra.Historian.
|
Все параметры кроме format являются опциональными: при их отсутствии будет использоваться значение по умолчанию.
|
Параметр
|
Описание
|
|
format
|
Формат базы данных. Для базы данных 4x должно быть указано значение 4x.
|
|
config_policy
|
Привязка к политике конфигурации.
Если не указана, то возможность использования политики конфигурации будет отключена.
|
|
location
|
Папка хранения данных.
Если не указана, используется домашняя папка базы данных.
|
Настройки в файле local.jsonc
Пример файла:
{
"4x":
{
"cache":
{
"max_size": 128
},
"io":
{
"max_queue_size": 0
},
"data":
{
"write":
{
"commit_threads": 4,
"auto_commit_size": 1024,
"chunk_size": 128
},
"storage_limits":
{
"max_data_size": 0,
"max_depth": 0
},
"cleanup":
{
"volume_shrink_auto_mode": 0,
"volume_shrink_ratio": 0.0,
"allow_command": false
}
},
"tx":
{
"min":
{
"auto": 3.0,
"limit": 0
},
"max":
{
"auto": 6.0,
"limit": 0
},
"shrink":
{
"auto": true
}
}
}
}
|
Для применения изменений в файле, нужно перезагрузить Astra.Historian.
|
|
Параметр или группа параметров
|
Описание
| ||
|
4x
|
Группа настроек, специфичных для баз данных формата 4x.
| ||
|
4x/cache
|
Группа настроек работы кэша.
| ||
|
4x/cache/max_size
|
Максимальный размер кэша, МБ.
| ||
|
4x/io
|
Группа настроек диспетчера ввода/вывода.
| ||
|
4x/io/max_queue_size
|
Максимальный размер очереди активных (исполняющихся) операций ввода-вывода.
| ||
|
4x/data
|
Группа настроек работы с данными.
| ||
|
4x/data/write
|
Группа настроек записи в базу данных.
| ||
|
4x/data/write/commit_threads
|
Число потоков обработки записей.
| ||
|
4x/data/write/auto_commit_size
|
Совокупный размер добавленных записей в килобайтах, по достижении которого выполняется автоматическое подтверждение добавления (и они становятся доступными для чтения)
| ||
|
4x/data/write/chunk_size
|
Размер блока накопленных в ОЗУ данных для запуска операции сохранения на диск, МБ.
| ||
|
4x/data/storage_limits
|
Группа настроек пределов содержимого базы данных.
| ||
|
4x/data/storage_limits/max_data_size
|
Предельный объём базы данных, МБ. При его превышении запускается очистка.
0 – без ограничений.
| ||
|
4x/data/storage_limits/max_depth
|
Максимальная глубина хранения данных, суток. Записи, чья метка времени окажется меньше границы, вычисленной с помощью этого параметра, будут удалены.
0 – без ограничений.
| ||
|
4x/data/cleanup
|
Группа настроек очистки содержимого базы данных.
| ||
|
4x/data/cleanup/volume_shrink_auto_mode
|
Режим автоматического сокращения по достижении установленного предельного объёма. Возможные значения:
0 - отключена (по умолчанию): Автоматическое сокращение объёма не выполняется даже если достигнут/превышен предельный объём.
1 - инкрементальная: по достижении предельного объёма выполняется удаление самых старых секций до тех пор, пока совокупный объём подтверждённых данных не станет ниже предельного.
| ||
|
4x/data/cleanup/volume_shrink_ratio
|
Процент от предельного объёма базы данных, который будет очищен при превышении предельного объёма данных.
Возможные значения: от 0.0 до 100.0.
| ||
|
4x/data/cleanup/allow_command
|
Флаг разрешения вызова команды очистки через JSON API.
false – вызов команды запрещён.
true – вызов команды разрешён.
| ||
|
4x/tx
|
Группа настроек работы журнала транзакций.
| ||
|
4x/tx/min
|
Предпочтительная минимальная граница размера.
Используется для сохранения резервного свободного пространства в журнале при усечении его размера.
| ||
|
4x/tx/min/auto
|
Коэффициент автоматической оценки минимальной границы.
Итоговая оценка зависит также от значения параметра 'data/write/chunk_size' и фактического количества секций элементов, по которым хранится история (1 секция - 32768 элементов).
| ||
|
4x/tx/min/limit
|
Предельная минимальная граница, в мегабайтах. Если указано значение 0, то не используется.
Данная граница (если задана) имеет приоритет, если автоматически вычисленная граница находится левее.
| ||
|
4x/tx/max
|
Максимальная граница размера. Используется для ограничения роста файла журнала.
Если максимальная граница размера достигнута, то при отсутствии свободного места в журнале приём данных блокируется до тех пор, пока в журнале не освободится место.
| ||
|
4x/tx/max/auto
|
Коэффициент автоматической оценки максимальной границы.
Оценка вычисляется так же, как и для минимальной границы, имеет те же зависимости.
| ||
|
4x/tx/max/limit
|
Предельная максимальная граница, в мегабайтах. Если указано значение 0, то не используется.
Данная граница (если задана) имеет приоритет, если автоматически вычисленная граница находится правее.
| ||
|
4x/tx/shrink
|
Опции усечения размера журнала.
Используется для сокращения размера файла журнала до минимального предпочтительного размера в случае, если файл увеличился (вследствие продолжительной повышенной нагрузки или ошибок сохранения на диск).
| ||
|
4x/tx/shrink/auto
|
Флаг включения автоматического усечения.
Если данный флаг включен, то при наличии возможности (верхняя граница занятого пространства находится левее предпочтительного минимума) выполняется автоматическое сокращение размера файла журнала.
|