Банк данных

Сервис используется для хранения пользовательских данных в Платформе с использованием СУБД MSSQL или PostgreSQL.

Важно

Ознакомьтесь с требованиями к версиям используемых СУДБ в разделе Ограничения и рекомендации.

Чтобы создать сервис Банк данных:

  1. В ЦН перейдите в раздел Сервисы.

  2. Нажмите на кнопку + над таблицей сервисов. В рабочей области страницы отобразится интерфейс создания / редактирования сервиса, содержащий две вкладки: Основные и Параметры сервиса.

  3. На вкладке Основные заполните следующие поля:

  • Название: произвольное название сервиса, необязательно для заполнения.

  • Имя: уникальное имя сервиса, обязательно для заполнения.

  • Комментарий: описание сервиса, необязательно для заполнения.

  1. Для активации сервиса установите флажок Включен.

  1. Для создания сервиса выберите вариант Банк данных в разделе Настройка сервисов:

    ../../_images/image14.png

  2. На вкладке Параметры сервиса произведите следующие действия:

    • Выберите используемую СУБД:

      • MSSQL

        Примечание

        Если параметр FILESTREAM для оптимизированных запросов не включен на стороне сервера СУБД MSSQL, при включенном параметре «useMemoryOptimizedTable»: true в журнале будет зарегистрировано предупреждение, не блокирующее работу сервиса.

      • PostgreSQL

        Примечание

        Для работы сервиса с CУБД PostgreSQL пользователь должен обладать правами Вход разрешен (Can login) и Создание баз (Create databases).

    • Установите флажок Регистрация действий, если действия в банке данных должны журналироваться в таблицу masterjournal базы данных (по умолчанию флажок не установлен). После установки флажка появляется возможность выбрать период хранения журнала действий; значение по умолчанию: 0 (Не ограничено).

    • Заполните следующие поля:

      • Сервер

      • Экземпляр

      • Порт

      • Имя базы данных

        Примечание

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

        Имя СУБД PostgreSQL не должно содержать буквы в верхнем регистре, в противном случае подключение Платформы к СУБД будет невозможно. Начиная с версии 3.1.0 для корректного подключения необходимо переименовать СУБД и указать новое имя базы данных в настройках сервиса до применения конфигурации

    • Настройте параметры аутентификации:

      • Установите флажок Вход по имени пользователя и паролю

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

      • Если данные пользователя хранятся в сервисе Управление пользователями, установите флажок Получать пароль из модуля Credential. В результате поле Пароль отображаться не будет.

      ../../_images/authorization.png

  3. Нажмите на кнопку перехода в режим редактора конфигурации:

    ../../_images/image803.png

  4. Установите параметры сервиса: databaseType, serverAddress, serverPort, serverInstance, database, account, name, description.

  5. После внесения данных нажмите на кнопку Сохранить.

  6. Нажмите на кнопку Применить конфигурацию:

    ../../_images/config_apply3.png

  7. Убедитесь, что в диспетчере задач появился процесс банка - DatareonPlatformDataBank.

Пример конфигурации сервиса банка данных:

{
        "$type": "DT.ClusterConfiguration.NodeModule, DT_Core",
        "config": {
                "$type": "DT.ConfigurationRepository.Configuration.ModuleConfiguration.StorageConfig,
        DT_ConfigurationRepository",
                "changeLog": false,
                "storeDay": 0,
                "databaseConfiguration": {
                "$type": "DT.ClusterConfiguration.DBConnectionConfig, DT_Core",
                "databaseType": "MsSql",
                "useConnectionString": false,
                "useUsernameAndPassword": true,
                "serverAddress": "DTplatform31",
                "serverPort": 1433,
                "serverInstance": "sqlexpress",
                "database": "MyDB",
                "account": {
                        "$type": "DT.ClusterConfiguration.Account, DT_Core",
                        "userName": "Testing",
                        "passwordNew": "Datare0n!",
                        "useCredential": false
                },
                "integratedSecurity": false,
                "pooling": true,
                "minimumPoolSize": -1,
                "maximumPoolSize": -1,
                "connectionLifetime": -1,
                "properties": []
                },
                "sendingStrategy": ""
        },
        "isActive": true,
        "folderId": null,
        "entityId": "e24de33c-a25f-494c-a97c-042b8775c21c",
        "clusterId": "140e7996-8609-4ebd-a783-ca63855dbb9a",
        "name": "Банк_данных",
        "description": "Банк данных",
        "version": 1,
        "tagsCollection": [],
        "className": "DataBank",
        "classNameStr": "Банк данных",
        "comment": ""
}

Примечание

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

Мониторинг

Сообщения из логгера ConveyorDataWatchService для банка данных отображаются в разделе ЦМ DebugCoveyor.

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