MSSQL

MSSQL используется для выполнения запросов к СУБД MSSQL

Описание MSSQL

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

Массив значений

Коллектор MSSQL возвращает массив из строк таблицы SQL запроса. Каждый элемент массива - это объект, описывающий строку таблицы. Например, для таблицы

NumNameAge
1Alexander44
2Marina33
3Bullfinch1

Будет сформирован следующий массив:

[{
    Num: 1
    Name: "Alexander"
    Age: 44
}, {
    Num: 2
    Name: Marina
    Age: 33
}, {
    Num: 3
    Name: Bullfinch
    Age: 1
}]

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

При получении массива значений ALEPIZ выполняет следующие действия:

  • Весь полученный массив значений преобразуется в текст JSON и сохраняется в базу истории значений
  • Если у счетчика есть зависимые счетчики, то ALEPIZ будет вызывать их столько раз, сколько значений получено в массиве и каждый раз передавать в качестве переменной %:PARENT_VALUE:% новое значение из массива значений в формате JSON. Работать с полученным значением можно с помощью функции getValueFromJSONStr. Например первый раз для нашего примера функция getValueFromJSONStr( %:PARENT_VALUE:%, "Name" ) вернет "Alexander", второй раз - "Marina", третий раз - "Bullfinch"

Параметры

  • MSSQL driver (run ODBC Data Source (64-bit), tab "Drivers") - драйвер для доступа до MSSQL. Для того, чтобы посмотреть список установленных драйверов, необходимо запустить приложение "ODBC Data Source (64-bit)" (например через Ctrl+Q и набрать ODBC), перейти на вкладку Drivers и выбрать один из драйверов MSSQL, которые там представлены.
  • MSSQL server - Имя, IP адрес, имя экземпляра (myServerName\theInstanceName) или сетевой путь (.\SQLExpress) до сервера MSSQL. Подробнее можно прочитать в документации на используемый драйвер MSSQL
  • Port to connect - TCP port сервера MSSQL
  • Use Windows integrated (trusted) authentication - Включите этот параметр для подключения с использованием встроенной проверки подлинности Windows либо укажите пользователя и пароль для подключения с использованием проверки подлинности SQL Server.
  • User name (for SQL Server authentication) - имя пользователя для авторизации, если используется проверка подлинности SQL Server
  • Password (SQL Server authentication) - пароль для авторизации, если используется проверка подлинности SQL Server. Для обеспечения безопасности лучше использовать методы авторизации в которых не требуется указывать пароль
  • Database to connect - Имя базы данных, к которой будет выполнен запрос
  • MSSQL Query - SQL запрос. Если запрос отсутствует, проверяется возможность подключения к MSSQL серверу. В случае успешного подключения возвращается 1, в случае неуспешного - 0. Если SQL запрос указан, но подключиться к серверу не удалось, возвращается JSON в виде {"unableToConnect": "<error message>"}
  • Connection timeout (sec) - таймаут для подключения к MSSQL, если не установлено, то 2 сек
  • Query timeout (sec) - таймаут для выполнения SQL запроса, если не установлено, то 2 сек