Alpha.Community

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

Настройки баз данных 4x

Шаблоны файлов настройки базы данных есть в папке установке в подпапке server_home_template. Шаблоны обновляются при переустановке Alpha.Historian и всегда соответствуют установленной версии.

Настройки в файле db.jsonc

Пример файла:

{
  "format": "4x"
}

Для применения изменений в файле, нужно перезагрузить Alpha.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
      }
    }
  }
}

Для применения изменений в файле, нужно подать команду перезагрузки конфигурации.

  Параметр или группа параметров Описание
 4x Группа настроек, специфичных для баз данных формата 4x.
   cache Группа настроек работы кэша.
   max_size Максимальный размер кэша, МБ.
 io Группа настроек диспетчера ввода/вывода.
   max_queue_size

Максимальный размер очереди активных (исполняющихся) операций ввода-вывода.

 data Группа настроек работы с данными.
   write Группа настроек записи в базу данных.
  commit_threads Число потоков обработки записей.
auto_commit_size Совокупный размер добавленных записей в килобайтах, по достижении которого выполняется автоматическое подтверждение добавления (и они становятся доступными для чтения)
chunk_size Размер блока накопленных в ОЗУ данных для запуска операции сохранения на диск, МБ.
 storage_limits Группа настроек пределов содержимого базы данных.
  max_data_size

Предельный объём базы данных, МБ. При его превышении запускается очистка.

0 – без ограничений.

max_depth

Максимальная глубина хранения данных, суток. Записи, чья метка времени окажется меньше границы, вычисленной с помощью этого параметра, будут удалены.

0 – без ограничений.

 cleanup Группа настроек очистки содержимого базы данных.
  volume_shrink_auto_mode

Режим автоматической очистки. Возможные значения:

  • 0 – отключена, при превышении предельного объёма очистка не выполняется.
  • 1 – по достижении предельного объёма, выполняется удаление самых старых секций до тех пор, пока совокупный объём данных не станет ниже предельного.
volume_shrink_ratio

Процент от предельного объёма базы данных, который будет очищен при превышении предельного объёма данных.

Возможные значения: от 0.0 до 100.0.

allow_command

Флаг разрешения вызова команды очистки через JSON API.1JSON API не описан в текущей версии документации. Его описание появится в следующих редакциях.

  • false – вызов команды запрещён.
  • true – вызов команды разрешён.
 tx Группа настроек работы журнала транзакций.
   min Группа настроек минимальной границы размера журнала транзакций.
  auto  
limit  
 max Группа настроек максимальной границы размера журнала транзакций.
  auto  
limit  
 shrink Группа настроек усечения размера журнала транзакций.
  auto