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

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

  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. Внесите изменения в коллекцию:

    col edit
    Если изменения затрагивают непосредственно SQL-запрос, то перед сохранением изменений необходимо провалидировать запрос, нажав на Выполнить запрос.

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

Требования к 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 <...>