Создание/изменение коллекции устройств

Для создания коллекции устройств:

  1. На боковой панели главной страницы выберите Коллекции устройств.

  2. Нажмите на кнопку Создать:

    col cr

  3. В открывшейся форме заполните поля:

    image2023 8 28 15 28 46

    • Название — название коллекции (должно быть уникальным);

    • Описание — краткое описание коллекции;

    • Обновление коллекции:

      • Не обновлять — обновление коллекции возможно только в ручном режиме (статическая коллекция);

      • Обновлять по расписанию (время сервера) — обновление коллекции происходит по заданному расписанию (динамическая коллекция);

    • SQL-запрос — SQL-запрос для формирования списка устройств в составе коллекции.

      При использовании некорректного запроса коллекция не будет создана и сохранена. Правила составления SQL-запроса см. в разделе «Требования к SQL-запросу».

  4. Нажмите на кнопку Выполнить запрос.

    Происходит валидация SQL-запроса.

    Если SQL-запрос выполнился с ошибкой, то выводится предупреждение:

    image2023 8 28 16 15 40

    Если SQL-запрос выполнился без ошибки, то выводится список устройств, добавленных в коллекцию, и сообщение об успешной валидации запроса:

    image2023 8 28 16 16 21

  5. Нажмите на кнопку Создать.

    Кнопка Создать активна только в случае выполнения SQL-запроса без ошибок.

Для изменения коллекции устройств:

  1. На боковой панели главной страницы выберите Коллекции устройств.

  2. Выберите коллекцию устройств.

  3. В окне быстрого просмотра нажмите на Изменить.

  4. Внесите изменения в коллекцию.

  5. Нажмите на кнопку Сохранить.

    col edit

Требования к SQL-запросу

Коллекции устройств могут быть статическими и динамическими.

Статические коллекции

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

SQL-запрос должен иметь тип select и в списке извлекаемых колонок содержать столбец minion_id.

При создании SQL-запроса нельзя использовать следующие операторы:

  • drop;

  • alter;

  • create;

  • update;

  • delete;

  • insert;

  • truncate.

Шаблоны SQL-запросов

  1. Запрос с использованием базовой информации по пользователям и устройствам:

    select m.minion_id
from users u
join user_machine_mappings umm on umm.user_fdn = u.full_domain_name
join machines m on m.fqdn = umm.machine_fqdn
where <...>

  2. Запрос с использованием подробной информации по устройствам:

    select m.minion_id
from machines m
left join machine_disks md on md.minion_id = m.minion_id
left join machine_networks mn on mn.minion_id = m.minion_id
where <...>

  3. Запрос с использованием информации, доступной в модуле «Инвентаризация»:

    select m.minion_id
from users u
join user_machine_mappings umm on umm.user_fdn = u.full_domain_name
join machines m on m.fqdn = umm.machine_fqdn
left join machine_disks md on md.minion_id = m.minion_id
left join machine_networks mn on mn.minion_id = m.minion_id
where <...>

Динамические коллекции

Список устройств в динамических коллекциях обновляется по заданному расписанию, а также при создании и редактировании. Расписание обновления представляет собой выражение cron-like для фреймворка Quartz.