База данных

Настроить среду базы данных можно, перейдя в Системная консоль → Окружение → База данных или отредактировав файл config.json.

warning

Изменения параметров конфигурации в этом разделе требуют перезапуска сервера.

Имя драйвера

примечание

Доступно только в On-Premise инсталляции Time.

Установите драйвер базы данных в файле config.json.

• Путь к системной конфигурации: Окружение → База данных (только для чтения)
• Переменная среды: TIME_SQLSETTINGS_DRIVERNAME
• Значения:
  • postgres: (По умолчанию) Включает драйвер для базы данных PostgreSQL.

Источник данных

примечание

Доступно только в On-Premise инсталляции Time.

Строка подключения к основной базе данных.

Формат поля: string.

• Путь к системной конфигурации: Окружение → База данных (только для чтения)
• Переменная среды: TIME_SQLSETTINGS_DATASOURCE

к сведению

Подробнее про формат значения параметра: Database Connection Control Functions.

Максимальное число неактивных соединений (DEPRECATED)

примечание

Доступно только в On-Premise инсталляции Time.

Максимальное количество неактивных соединений, которые остаются открытыми для базы данных.

Формат ввода: Numeric. По умолчанию: 10.

• Путь к системной конфигурации: Окружение → База данных
• Переменная среды: TIME_SQLSETTINGS_MAXIDLECONNS

Максимальное число открытых соединений

примечание

Доступно только в On-Premise инсталляции Time.

Максимальное количество открытых соединений, которые остаются открытыми для базы данных.

Формат ввода: Numeric. По умолчанию: 30.

• Путь к системной конфигурации: Окружение → База данных
• Переменная среды: TIME_SQLSETTINGS_MAXOPENCONNS

Тайм-аут запроса

примечание

Доступно только в On-Premise инсталляции Time.

Количество секунд ожидания ответа от базы данных после открытия соединения и отправки запроса.

Ошибки в пользовательском интерфейсе или в журналах в результате тайм-аута запроса, могут различаться в зависимости от типа запроса.

Время ожидания ответа от базы данных в секундах после открытия соединения и отправки запроса.

Формат ввода: Numeric в секундах. По умолчанию: 30 (секунд).

• Путь к системной конфигурации: Окружение → База данных
• Переменная среды: TIME_SQLSETTINGS_QUERYTIMEOUT

Максимальное время жизни соединения

примечание

Доступно только в On-Premise инсталляции Time.

Максимальное время жизни соединения с базой данных, в миллисекундах.

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

Формат ввода: Numeric в миллисекундах. По умолчанию 3600000 миллисекунд (1 час).

• Путь к системной конфигурации: Окружение → База данных
• Переменная среды: TIME_SQLSETTINGS_CONNMAXLIFETIMEMILLISECONDS

Максимальное время ожидания при подключении

примечание

Доступно только в On-Premise инсталляции Time.

Максимальное время ожидания (в миллисекундах) при подключении к базе данных.

Формат ввода: Numeric в миллисекундах. По умолчанию: 60000 (5 минут).

• Путь к системной конфигурации: Окружение → База данных
• Переменная среды: TIME_SQLSETTINGS_CONNMAXIDLETIMEMILLISECONDS

Минимальная длина хэштега

примечание

Доступно только в On-Premise инсталляции Time.

Минимальное количество символов в хэштеге.

Это значение должно быть больше или равно 2.

• Путь к системной конфигурации: Окружение → База данных
• Переменная среды: TIME_SQLSETTINGS_MINIMUMHASHTAGLENGTH

Вести лог SQL-запросов

примечание

Доступно только в On-Premise инсталляции Time.

(Режим разработчика) Исполняемые SQL запросы могут быть записаны в журнал.

• Путь к системной конфигурации: Окружение → База данных
• Переменная среды: TIME_SQLSETTINGS_TRACE
• Значения:
  • да: Все исполняемые SQL-запросы будут записаны в лог.
  • нет: (По умолчанию) SQL-запросы не записываются в журнал.

Переработка соединений базы данных (DEPRECATED)

примечание

Доступно только в On-Premise инсталляции Time.

Для повторного подключения к настроенной базе данных необходимо нажать кнопку Обновить подключение базы данных. Все старые соединения закрываются через 20 секунд.

Варианты развертывания с использованием нескольких баз данных могут переключаться с одной основной базы данных на другую без перезапуска сервера путем обновления файла config.json для новой требуемой конфигурации и использования функции Окружение → Веб-сервер → Перезагрузить конфигурацию с диска для загрузки новых настроек во время работы сервера. После этого, администратор должен использовать функцию Обновить подключения баз данных для обновления соединения с базой данных на основе новых настроек.

• Путь к системной конфигурации: Окружение → База данных
• Переменная среды: N/A

Отключить поиск в базе данных

примечание

Доступно только в On-Premise инсталляции Time.

Когда настроены другие поисковые системы, например Elasticsearch, база данных может быть отключена для выполнения поиска.

• Путь к системной конфигурации: Окружение → База данных
• Переменная среды: TIME_SQLSETTINGS_DISABLEDATABASESEARCH
• Значения:

  • да: Отключает использование базы данных для выполнения поиска.

    Если не настроена другая поисковая система, установка этого значения в да приведет к пустым результатам поиска.

  • нет: (По умолчанию) Поиск в базе данных не отключен.

к сведению

Поведение поиска зависит от того, какие поисковые системы включены.

• Когда Elasticsearch включен, система будет пытаться использовать его первым.
• Если Elasticsearch/OpenSearch не работает или отключен, система пытается искать в базе данных напрямую, если это разрешено.
• Если все вышеперечисленные методы не работают или отключены, результаты поиска будут пустыми.

Примененные схемы миграций

Список всех миграций, которые были применены к хранилищу данных.

Путь к системной конфигурации: Окружение → База данных

Реплики для чтения

примечание

Доступно только в On-Premise инсталляции Time.

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

Параметр должен содержать все реплики, используемые для чтения.

Формат ввода в переменной среды - string (список, разделенный пробелом).

• Путь к системной конфигурации: N/A
• Переменная среды: TIME_SQLSETTINGS_DATASOURCEREPLICAS

подсказка

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

Реплики для ротации

примечание

Доступно только в On-Premise инсталляции Time.

Строки подключения ко всем хостам базы данных.

Параметр должен содержать в себе все реплики, используемые для чтения, и мастер.

warning

Параметр не должен содержать адрес отказоустойчивого мастера.

Если не указать данный параметр, то механизм ротации реплик будет использовать параметр DataSourceReplicas, что может привести к ситуации, что после смены одной из реплик на новый мастер предыдущий мастер не будет использоваться для будущих ротаций (даже после его восстановления).

Формат ввода в переменной среды - string (список, разделенный пробелом).

• Путь к системной конфигурации: N/A
• Переменная среды: TIME_SQLSETTINGS_ALLDATASOURCES

подсказка

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

Реплики для поиска

примечание

Доступно только в On-Premise инсталляции Time.

Строка подключения для поисковых реплик базы данных. Реплика поиска аналогична реплике чтения, но используется только для обработки поисковых запросов.

• Путь к системной конфигурации: N/A
• Переменная среды: TIME_SQLSETTINGS_DATASOURCESEARCHREPLICAS

подсказка

Каждая строка подключения к базе данных в массиве должна быть в той же форме, которая используется для настройки Источник данных

Включение ротаций реплик

примечание

Доступно только в On-Premise инсталляции Time.

Флаг, указывающий включать или нет механизм ротации реплик для чтения.

Если включен, система будет проверять жизнеспособность реплик и отключать запросы к недоступным репликам. Если роль хоста кластера PostgreSQL сменилась с реплики на мастер, то запросы на чтение не будут направлены на этот хост.

В случае, если был включен флаг ротации мастера, тогда time-server самостоятельно переназначит типы подключений в соответствии с ролью хостов PostgreSQL (запросы на запись пойдут на мастер, запросы на чтение — на реплику).

Формат ввода: bool.

По умолчанию: false

• Путь к системной конфигурации: N/A
• Переменная среды: TIME_SQLSETTINGS_ENABLEREPLICAROTATION

Включение ротаций мастера

примечание

Доступно только в On-Premise инсталляции Time.

Если включен, механизм ротации реплик переключит запросы на запись к новому мастеру при его переходе на одну из read реплик.

Это сделано для случаев, когда существует отказоустойчивый мастер, но его переключение при отказе занимает значительное время.

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

Зависит от включения механизма ротации реплик.

Флаг, указывающий включать или нет механизм ротации мастера.

Формат ввода: bool.

По умолчанию: false

• Путь к системной конфигурации: N/A
• Переменная среды: TIME_SQLSETTINGS_ENABLEMASTERROTATION

Таймаут на запрос проверки, является ли реплика мастером

примечание

Доступно только в On-Premise инсталляции Time.

Параметр задает значение таймаута (в секундах), в течение которого механизм ротации будет ожидать ответа, является ли реплика мастером.

Формат ввода: integer (по умолчанию: 5).

• Путь к системной конфигурации: N/A
• Переменная среды: TIME_SQLSETTINGS_REPLICAPINGCANCELCONTEXTTIMEINSECONDS

Временная задержка между неудачными попытками проверки жизнеспособности реплик

примечание

Доступно только в On-Premise инсталляции Time.

Параметр задает значение задержки (в секундах) до следующей проверки жизнеспособности реплики, если предыдущая проверка не удалась.

Формат ввода: integer (по умолчанию: 1).

• Путь к системной конфигурации: N/A
• Переменная среды: TIME_SQLSETTINGS_REPLICAPINGTIMEOUTINSECONDS

Максимальное количество попыток проверки жизнеспособности реплик

примечание

Доступно только в On-Premise инсталляции Time.

Параметр задает максимальное количество попыток проверки жизнеспособности реплик, прежде чем считать реплику недоступной и исключить запросы на нее.

Формат ввода: integer. По умолчанию: 3.

• Путь к системной конфигурации: N/A
• Переменная среды: TIME_SQLSETTINGS_REPLICAPINGATTEMPTS

Включение пакетной обработки событий о просмотренных каналах

примечание

Доступно только в On-Premise инсталляции Time.

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

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

Формат ввода: bool. По умолчанию: false.

• Путь к системной конфигурации: N/A
• Переменная среды: TIME_SQLSETTINGS_BATCHREQUESTS_CHANNELVIEW_ENABLE

Максимальное количество событий о просмотренных каналах в пакете

примечание

Доступно только в On-Premise инсталляции Time.

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

Формат ввода: integer. По умолчанию: 1000.

• Путь к системной конфигурации: N/A
• Переменная среды: TIME_SQLSETTINGS_BATCHREQUESTS_CHANNELVIEW_BUFFERSIZE

Максимальное время в секунадах через которое события о просмотренных каналах будут записаны в базу данных

примечание

Доступно только в On-Premise инсталляции Time.

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

Формат ввода: integer. По умолчанию: 60.

• Путь к системной конфигурации: N/A
• Переменная среды: TIME_SQLSETTINGS_BATCHREQUESTS_CHANNELVIEW_FLUSHINTERVALSECONDS