Базы данных

База данных  - это свойство глобальной конфигурации сервера, которое определяет, как SberMobile Server сохраняет данные в свою базу данных. Поля этого свойства сопоставляются с файлом конфигурации сервера.

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

Доступно пять режимов:

Имя переменной в конфигурационном файле: databaseConfigurationStorage

Тип значения: Integer

Возможные значения: 1, 2, 3, 4

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

Эта настройка определяет, где хранятся конфигурации устройств.

Имя переменной в конфигурационном файле: databaseEventHistoryStorage

Тип значения: Integer

Возможные значения: 0, 1, 3

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

Эта настройка определяет, где хранятся события системы.

Имя переменной в конфигурационном файле: databaseBinaryDataStorage

Тип значения: Integer

Возможные значения: 1, 2, 4

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

Эта настройка определяет, где хранятся двоичные данные.

Имя переменной в конфигурационном файле: databaseCassandraUseEmbeddedService

Тип значения: Boolean

Возможные значения: true или false

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

Когда этот параметр включен, встроенная служба Cassandra будет запущена на SberMobile Server и будет использоваться в качестве основной базы данных. Если установлен параметр IP адрес сервера, он будет использоваться в качестве встроенного сервиса Cassandra, в противном случае он будет рассчитан автоматически

Если опция не активирована, укажите опцию Адрес сервера для подключения к внешней БД Cassandra.

Имя переменной в конфигурационном файле: databaseCassandraUseYamlConfiguration

Тип значения: Boolean

Возможные значения:true или false

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

Когда этот параметр включен, встроенная служба Cassandra будет использовать настройки не из конфигурации SberMobile Server (по умолчанию - файл server.xml), а из отдельного файла cassandra.yaml в домашней папке сервера. Это может быть полезно для более тонкой настройки встроенной службы Cassandra, когда необходимо изменить параметры БД, не доступные из конфигурации сервера.

Имя переменной в конфигурационном файле: databaseCassandraHost

Тип значения: String

Возможные значения: любой действительный IP адрес

Значение по умолчанию: "" (пусто)

IP адрес сервера Cassandra.

Имя переменной в конфигурационном файле: databaseCassandraNativePort

Тип значения: Integer

Возможные значения: 0 или больше

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

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

Имя ключа в файле конфигурации: databaseCassandraStorageDirectory

Тип значения: String

Возможные значения: любой действительный путь

Значение по умолчанию: "" (пусто)

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

Имя переменной в конфигурационном файле: databaseCassandraCommitlogDirectory

Тип значения: String

Возможные значения: любой действительный путь

Значение по умолчанию: "" (пусто)

Путь к папке, где хранятся commitlogs. Если путь не указан, директория будет размещена в папке установки SberMobile.

Имя переменной в конфигурационном файле: databaseCassandraCachesDirectory

Тип значения: String

Возможные значения: любой действительный путь

Значение по умолчанию: "" (пусто)

Путь к папке, где хранятся кэшированные данные. Если путь не указан, директория будет размещена в папке установки SberMobile.

Имя переменной в конфигурационном файле: databaseCassandraConfigurationKeyspace

Тип значения: String

Возможные значения: Любое действительное имя пространства ключей.

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

Пространство ключей, используемое Cassandra для хранения конфигураций. Используется для гарантии корректной работы единичного экземпляра ДБ Cassandra с несколькими серверами SberMobile.

Имя переменной в конфигурационном файле: databaseCassandraEventHistoryKeyspace

Тип значения: String

Возможные значения: Любое действительное имя пространства ключей.

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

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

Имя переменной в конфигурационном файле: databaseCassandraBinaryDataKeyspace

Тип значения: String

Возможные значения: Любое действительное имя пространства ключей.

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

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

Имя переменной в конфигурационном файле: databaseCassandraStatisticsKeyspace

Тип значения: String

Возможные значения: Любое действительное имя пространства ключей.

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

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

Имя переменной в конфигурационном файле: databaseCassandraInternalKeyspace

Тип значения: String

Возможные значения: Любое действительное имя пространства ключей.

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

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

Имя переменной в конфигурационном файле: databaseReplicationFactor

Тип значения: Integer

Возможные значения: 1 или больше

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

Фактор репликации описывает, как много копий данных будет сделано. Установите это значение больше одного, если вы хотите разделить данные между узлами кластера NoSQL.

Имя переменной в конфигурационном файле: databaseSeeds

Тип значения: String

Возможные значения: Список IP адресов, разделенных запятой

Значение по умолчанию: "" (пусто)

Список узлов, отвечающих за хранение и обработку конфигурации кластера NoSQL.

Имя переменной в конфигурационном файле: databaseCassandraBatchSize

Тип значения: Integer

Возможные значения: 0 или выше

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

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

Имя ключа в файле конфигурации: databaseCassandraBatchSizeThreshold

Тип значения: Integer

Возможные значения: 0 или выше

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

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

Имя переменной в конфигурационном файле: databaseCassandraUseAuthentication

Тип значения: Boolean

Возможные значения: true или false

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

Контролирует, используется ли аутентификация для соединений с кластером Cassandra.

Имя ключа в файле конфигурации: databaseCassandraLogin

Тип значения: String

Возможные значения: любое имя пользователя, подходящее для БД Cassandra

Значение по умолчанию: "" (пусто)

Имя пользователя для входа в хосты Cassandra.

Имя переменной в конфигурационном файле: databaseCassandraPassword

Тип значения: String

Возможные значения: любей пароль, подходящий для БД Cassandra

Значение по умолчанию: "" (пусто)

Пароль для входа в хосты Cassandra.

Имя переменной в конфигурационном файле: databaseCassandraCommitlogSize

Тип значения: Integer

Возможные значения: 8,16,32

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

Общее пространство, используемое под commitlogs. Меньший размер commitlog, как правило, увеличивает количество сбрасываний на диск в наименее активных таблицах.

Имя переменной в конфигурационном файле: databaseCassandraConsistencyLevel

Тип значения: String

Возможные значения: ONE, TWO, THREE, QUORUM, ALL, LOCAL_QUORUM, EACH_QUORUM, LOCAL_ONE

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

Уровень согласованности Cassandra.

Имя переменной в конфигурационном файле: databaseCassandraContactPoints

Тип значения: String

Возможные значения: Список IP адресов или названий хостов, разделенных запятой

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

Контактные точки Cassandra, т.е. IP адреса узлов.

Имя переменной в конфигурационном файле: databaseCassandraLoadBalancing

Тип значения: Data Table

Возможные значения: Round Robin, Latency Aware, DC Aware Round Robin

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

Политика балансировки нагрузки БД Cassandra.

Имя переменной в конфигурационном файле: databaseCassandraReconnectionPolicy

Тип значения: Data Table

Возможные значения: Экспоненциальное или постоянное для Политики переподключения, 1 или более миллисекунд для Начальной задержки, 1 или более миллисекунд для Максимальной задержки, 1 или более миллисекунд для Задержки

Значение по умолчанию: Экспоненциальное

Политика пепреподключения БД Cassandra.

Имя переменной в конфигурационном файле: databaseCassandraReadRequestTimeout

Тип значения: Integer

Возможные значения:

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

Таймаут чтения БД Cassandra на хост в миллисекундах.

Устанавливая данное значение, учитывайте следующее:

• Значение не должно превышать настройки таймаута, используемые на стороне БД Cassandra

• Таймаут запроса на чтение приблизительный и контролирует только таймаут для одного хоста БД Cassandra, а не для запроса в целом

Имя переменной в конфигурационном файле: databaseCluster

Тип значения: Boolean

Возможные значения: true или false

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

Если эта опция не включена, SberMobile Server работает с одной БД, т.е. речь идет о ее "классическом" поведении.

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

• Параметр URL базы данных не активирован.

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

Более подробно см. Отказоустойчивый кластер БД.

Имя переменной в конфигурационном файле: databaseDriver

Тип значения: String

Возможные значения: любое имя Java -класса, относящееся к драйверу JDBC

Значение по умолчанию: org.apache.derby.jdbc.EmbeddedDriver

Эта опция определяет, какой драйвер базы данных JDBC (Java Database Connectivity) будет использован. Технически это имя основного Java-класса драйвера. Например, для хранения данных в MySQL установите эту опцию в com.mysql.jdbc.Driver. Для определения нужного значения обратитесь к документации по драйверу JDBC.

Чтобы разрешить SberMobile Server загружать сторонние драйверы базы данных JDBC, файл JAR (Java Archive), содержащий этот драйвер, должен быть добавлен к classpath сервера в поддиректории /jar  установочной директории SberMobile Server'a, или же можно использовать Файл свойств загрузчика SberMobile Server.

Имя переменной в конфигурационном файле: databaseUrl

Тип значения: String

Возможные значения: строка пути, зависящая от версии БД

Значение по умолчанию: jdbc:derby:database;create=true

Это строка, зависящая от версии БД, которая определяет тип базы данных, путь системного файла (хранящегося локально или в сети) к базе данных, содержащей таблицы данных SberMobile Server и любые дополнительные настройки. Чтобы определить правильное значение для выбранного JDBC-драйвера базы данных, пожалуйста, обратитесь к его документации. Значение по умолчанию для этой опции заставляет SberMobile Server использовать встроенную базу данных Apache Derby для сохранения данных в обычных текстовых файлах в папке database/ установочной директории SberMobile Server'а.

Имя переменной в конфигурационном файле: N/A (отсутствует), значение хранится в Конфигурационном файле кластера БД

Тип значения: Data Table

Возможные значения: N/A

Значение по умолчанию: N/A

Таблица баз данных кластера позволяет просматривать статус и настраивать все базы данных в отказоустойчивом кластере БД, используемом SberMobile Server. Каждая база данных в кластере конфигурируется согласно следующим настройкам:

• ID базы данных. Уникальный определенный пользователем строковый идентификатор базы данных в кластере.

• URL базы данных. Адрес базы данных. Дополнительную информацию можно найти в разделах URL базы данных (настройки для некластеризованной БД) и заметки об особенностях БД.

• Вес. Чем больше вес у базы данных в кластере, тем больше запросов на чтение она получит.

• Локальный. Этот флаг следует установить, если база данных располагается на одном и том же сервере, что и экземпляр SberMobile Server.

Сохранение баз данных кластера. При сохранении таблицы баз данных кластера сервер выполняет несколько процедур для новых и измененных записей БД:

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

• Тестируется соединение с каждой базой данных

• Инициируется синхронизация данных между новой/изменённой базой данных и другими базами данных в кластере

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

Имя переменной в конфигурационном файле: databaseUsername

Тип значения: String

Возможные значения: любое имя пользователя, подходящее для сервера БД

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

Эта опция определяет, какое имя пользователя использовать для регистрации на сервере базы данных. Значение по умолчанию позволяет соединиться со встроенным в SberMobile Server сервером БД.

Имя ключа в файле конфигурации: databasePassword

Тип значения: String

Возможные значения: любой пароль, подходящий для сервера базы данных

Значение по умолчанию: "" (пустое значение)

Эта опция определяет, какой пароль используется при регистрации на сервере базы данных. Значение по умолчанию позволяет подключаться к встроенному в SberMobile Server серверу БД.

Имя переменной в конфигурационном файле: databaseSqlDialect

Тип значения: String

Возможные значения:

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

Эта опция определяет имя Java-класса для диалекта SQL базы данных. Например, следует использовать MySQLDialect, если Вы используете для хранения базу данных MySQL. Если Ваш сервер базы данных не указан в приведенной выше таблице, пожалуйста, обратитесь в службу технической поддержки.

Имя переменной в конфигурационном файле: databaseMinimumPoolSize

Тип значения: Integer

Возможные значения: 1 или более

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

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

Имя переменной в конфигурационном файле: databaseMaximumPoolSize

Тип значения: Integer

Возможные значения: 1 или более

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

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

Максимальное число соединений в пуле должно быть меньше максимально позволенного числа соединений в настройках базы данных. В противном случае возможно снижение скорости работы или возникновение неожиданных ошибок БД.

Имя переменной в конфигурационном файле: databaseCheckoutTimeout

Тип значения: Long

Возможные значения: 0 или более

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

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

Имя переменной в конфигурационном файле: databaseUnreturnedConnectionTimeout

Тип значения: Long

Возможные значения: 0 или более

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

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

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

Имя переменной в конфигурационном файле: databaseBatchSize

Тип значения: Integer

Возможные значения: 0 или более

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

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

Имя переменной в конфигурационном файле: databaseDisablePooling

Тип значения: Boolean

Возможные значения: true или false

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

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

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

Тип значения: Reference

Возможные значения: N/A

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

Эта опция недоступна в свойстве Конфигуратор Сервера.

Имя переменной в конфигурационном файле: databaseKvClusterRole

Тип значения: Integer

Возможные значения: 0 для None, 1 для Master и 2 для Failover

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

Определяет роль узла ключ-значение в отказоустойчивом кластере БД.

Эта настройка может повлиять на работу SberMobile Server. Роль кластера БД ключ-значение должна быть идентична роли кластера SberMobile Server, за исключением конфигурации кластера модели Active / Active. Также, переключение БД в режим кластера включает в себя переключение в режим транзакций, который влияет на производительность. Обратное переключение не возвращает БД в нетранзакционный режим. IP адрес БД берется из параметра IP адрес сервера.

Для сброса группы репликации до единственного участника при открытой реплицированной среде,  установите Роль в кластере на None.

Имя переменной в конфигурационном файле: databaseKvClusterPrimaryDbPort

Тип значения: Integer

Возможные значения: Порт должен быть вне диапазона "Хорошо известные порты" (от нуля до 1023).

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

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

Имя переменной в конфигурационном файле: databaseKvClusterHelperUrl

Тип значения: String

Возможные значения:  hostname[:port][,hostname[:port]]*

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

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

Внимание! Если есть несколько знаков сети на других узлах, убедитесь, что показанные IP-адреса те же самые, что и выбранные другими узлами базы данных.

Имя переменной в конфигурационном файле: databaseKvClusterPriority

Тип значения: Integer

Возможные значения: 0 и больше

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

Приоритет текущего узла отказоустойчивого кластера. Узел с более высоким приоритетом будет избран мастером кластера. Нулевой приоритет означает, что узел никогда не станет мастером кластера.

Имя переменной в конфигурационном файле: databaseKvCacheSize

Тип значения: Integer

Возможные значения: 0 и больше

Значение по умолчанию: 100 Mб

Настраивает объем доступной для хранилища памяти в байтах.

Имя переменной в конфигурационном файле: confDatabaseKvMinUtilization

Тип значения: Integer

Возможные значения: от 0 до 50

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

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

Имя переменной в конфигурационном файле: databaseKvCleanerThreads

Тип значения: Integer

Возможные значения: от 1 до Integer.MAX_VALUE

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

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

Имя переменной в конфигурационном файле: databaseKvCleanerActivator

Тип значения: String

Возможные значения: databaseKvCleanerByteThreshold или databaseKvCleanerWakeupInterval

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

Определяет, когда запускается очистка - при превышении порогового значения использования диска, либо периодически.

Имя переменной в конфигурационном файле: databaseKvCleanerByteThreshold

Тип значения: Integer

Возможные значения: от 1 до Integer.MAX_VALUE

Значение по умолчанию: 40 Mб

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

Имя переменной в конфигурационном файле: databaseKvCleanerWakeupInterval

Тип значения: Long

Возможные значения: от 0 до Long.MAX_VALUE

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

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

Имя переменной в конфигурационном файле: databaseKvTransactionsCommitInterval

Тип значения: Integer

Возможные значения: от 0 до Integer.MAX_VALUE

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

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

Имя переменной в конфигурационном файле: databaseKvTransactionsCommitThreshold

Тип значения: Integer

Возможные значения: от 0 до Integer.MAX_VALUE

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

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

Имя переменной в конфигурационном файле: confDatabaseKvMaxReplicationMessageSize

Тип значения: Long

Возможные значения: от 262144 до Long.MAX_VALUE

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

Максимальный размер сообщения (в байтах), который будет принят этим узлом. Используется для предотвращения DOS атак.

Имя ключа в файле конфигурации: databaseKvCheckpointerActivator

Тип значения: String

Возможные значения: databaseKvCheckpointerWakeupInterval или databaseKvCheckpointerWriteInterval

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

Режим активации контрольных точек.

Имя ключа в файле конфигурации: databaseKvCheckpointerWakeupInterval

Тип значения: Long

Возможные значения: от 0 до Long.MAX_VALUE

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

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

Имя переменной в конфигурационном файле: databaseKvCheckpointerWriteInterval

Тип значения: Long

Возможные значения: от 1 до Integer.MAX_VALUE

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

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

Имя переменной в конфигурационном файле: databaseKvMaxDisk

Тип значения: Long

Возможные значения: от 0 до Long.MAX_VALUE

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

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

Имя переменной в конфигурационном файле: databaseKvFreeDisk

Тип значения: Long

Возможные значения: от 0 до Long.MAX_VALUE

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

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