Задача: Сбор данных из SQL БД

Задача Сбор данных из SQL БД позволяет настроить импорт данных из вашей СУБД в систему ИТМен с помощью SQL запросов. Например, вы можете написать запрос на выборку данных из таблицы и вставку этих данных в таблицу в системе.

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

Для выполнения SQL запросов вам понадобятся учетные данные пользователя вашей СУБД, через которого будет работать агент для выполнения задачи. 

Учетная запись должна обладать правами администратора. 

После того, как вы настроите учетную запись в СУБД, добавьте ее данные в справочник Сбор данных / Учетные данные.

В задачах используются учетные данные, у которых Платформа = Sql.

Для обеспечения работы сканирования задач SQL Server необходимо установить драйвер ODBC для SQL Server версии 17.x.x

• Для Windows:
  • Скачайте драйвер нужной разрядности с сайта Microsoft: ODBC Driver for SQL Server | Microsoft Learn.
  • Установите его.
• Для Linux:
  • Найдите пакеты для вашего дистрибутива, либо ориентируйиест на пакетный менеджер (deb, rpm и т.п.).
  • Установите драйвер согласно инструкции Microsoft ODBC Driver for SQL Server (Linux) | Microsoft Learn.
  • Выполните команду:

    cp /etc/odbcinst.ini /usr/local/etc/

    Пример конфигурации:

    [ODBC Driver 17 for SQL Server]
    Description=Microsoft ODBC Driver 17 for SQL Server
    Driver=/opt/microsoft/msodbcsql17/lib64/libmsodbcsql-17.10.so.6.1
    UsageCount=1

    При необходимости можно добавить блок для дебага:

    [ODBC]
    Trace = Yes
    TraceFile = /tmp/odbc.log

    Обратите внимание, для версий RedOS, использующих пакетный менеджер dnf, следует заменить все yum команды.

SQL запросы для получения данных из вашей СУБД задаются отдельно от создания задачи с помощью сенсоров.

Вы можете это сделать в разделе Сбор данных / Сенсоры. 

Далее, при создании задачи вы сможете выбрать сенсоры с соответствующими SQL запросами на шаге Нормализация.

Для создания задачи

• Наведите курсор на раздел Сбор данных в верхнем меню.
• Выберите пункт Задачи инвентаризации в открывшемся подменю.
• Нажмите кнопку Создать задачу в правом верхнем углу открывшейся страницы.

После нажатия на кнопку Создать задачу откроется пошаговый мастер. На первом шаге:

• Нажмите кнопку Сбор данных из SQL БД.

После выбора вы перейдете на шаг настроек задачи.

Заполните базовые свойства задачи:

• Наименование задачи – укажите любое удобное вам значение.
• Теги (опционально) – ключевые слова, которые потом можно использовать для поиска и фильтрации списка задач.
• Приоритет выполнения (опционально) – число, которое определяет порядок отправки задач на сервер в случае их накопления в очереди. Актуально для задач, которые могут выполняться продолжительное время (например, объемные задачи).

Заполните поля данными, необходимыми для подключения к вашей СУБД:

• Тип базы данных - MS SQL или PostgreSQL.
• SQL сервер - IP адрес или доменное имя сервера, на котором размещена СУБД.
• База данных - наименование базы данных.
• Учетные записи - выберите учетную запись (записи), от лица которой будут выполняться запросы к СУБД для выполнения задачи.
  Для выбора учетной записи:
  • Нажмите на поле Учетные записи.
  • Откроется список учетных записей, добавленных в систему.
    Управление списком осуществляется в разделе Сбор данных /Учетные записи.
    В списке отображаются только учетные учетную запись, у которых указан тип "Sql"
  • Выберите учетную запись или нажмите кнопку Добавить, если нужной нет в списке.
• Параметры
  • Аутентификация Windows - можно включить только если выбрана MS SQL.
  • Принудительное шифрование соединения

Добавьте объекты инвентаризации - это определит данные, которые будут получены из вашей СУБД.

Для этого:

• В блоке Объекты инвентаризации нажмите кнопку Добавить объекты.
• Отобразится форма для выбора объектов инвентаризации.
  • На форме по умолчанию уже выбрано в качестве объекта инвентаризации "Устройства". Вы не можете отменить выбор данного объекта, так как не предусматривается возможность сбора и хранения данных без привязки к устройству.
• Выберите необходимый объект (объекты) из списка.
  Обратите внимание, SQL запросы для получения данных из вашей СУБД задаются с помощью сенсоров. Выбрать, какие сенсоры использовать для каждого объекта инвентаризации вы сможете далее на шаге Нормализация. 
• Нажмите кнопку Применить после того, как выбрали нужные объекты инвентаризации, или кнопку Отменить, чтобы отменить изменение списка объектов инвентаризации.

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

После того, как все цели добавлены, заполните расписание запуска задачи:

В случае, если расписание не заполнено, то дата старта заполнится автоматически текущей датой и выполнение задачи запустится сразу после ее создания.
Для настройки расписания заполните поля:

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

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

Заполнение дальнейших шагов аналогично задаче сбора данных для инвентаризации:

• Настройка агентов
• Нормализация
  Важно! на этом шаге выберите SQL-сенсоры для каждого объекта. Скрипт сенсора содержит SQL запрос для получения соответствующих данных из вашей СУБД.
• Идентификация
• Обогащение

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

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

Для этого: 

• Перейдите в раздел Сбор данных / Задачи инвентаризации с помощью верхнего меню.
• Найдите задачу в списке.
• Нажмите на название задачи, чтобы открыть ее на редактирование.
• Перейдите в раздел История с помощью меню слева.

Узнайте подробнее о возможностях просмотра истории »

Результат выполнения задачи доступен в раздел Сбор данных / Все устройства.