Настройка инструментов миграции Qlik Cloud
Инструменты миграции Qlik Cloud помогают планировать и выполнять миграцию на Qlik Cloud.
Загрузите и установите инструменты миграции Qlik Cloud.
Набор инструментов включает:
-
Qlik Sense to SaaS Migration App — это приложение Qlik Sense, предназначенное для управления порядком и мониторингом миграции.
-
QlikView to SaaS Migration App — это приложение QlikView, предназначенное для управления порядком и мониторингом миграции. Использование Информационная панель QlikView.
-
Электронная таблица миграции — используйте эту электронную таблицу Microsoft Excel, чтобы собрать списки пользователей, ролей, правил пользователей, лицензий, пространств и другие сведения.
-
Скрипты миграции — используются в процессе миграции на Qlik Cloud.
Эти инструменты содержат общие рекомендации по выполнению миграции организации в Qlik Sense Enterprise SaaS. Информация, предоставляемая в инструментах, содержит лишь общие инструкции, поэтому для любой оценки путей миграции в Qlik Sense Enterprise SaaS с учетом потребностей конкретной организации, потребуется дополнительный детальный анализ.
Рекомендации предлагаются в инструментах миграции только в информационных целях, компания Qlik не дает гарантий и заверений относительно фактического развертывания Qlik Sense Enterprise SaaS, которое может наилучшим образом соответствовать бизнес-требованиям и предпочтениям организации. Рекомендации основаны на информации, предоставленной заказчиком. Любые неточности или изменения такой информации могут привести к существенным различиям оценок и результатов. В случае возникновения противоречий между результатами применения инструментов ESR Tools и стандартной документацией Qlik, первостепенное значение имеет стандартная документация Qlik.
История версий
В следующей таблице сведены изменения, внесенные в инструменты миграции Qlik Cloud.
Дата | Примечания |
---|---|
10 мая 2022 г. |
Первоначальный выпуск |
12 июля 2022 года |
Обновлено приложение «Миграция» Новые скрипты миграции |
20 октября 2022 г. | Исправлены ошибки |
7 марта 2023 г. | Рабочий лист миграции обновлен и теперь поддерживает изменения ролей пользователей |
29 июня 2023 г. |
Добавлены инструменты для миграции QlikView. Обновлено приложение «Миграция» Новые скрипты миграции |
31 октября 2023 г. |
Пересмотрен скрипт 7_migrateapps.ps1. Теперь скрипт может импортировать приложения с содержимым, которое относится к категориям «Общедоступное», «Сообщество», «Личное», для листов, закладок и историй, а также автоматически назначать их владельцам. Несколько незначительных изменений в скриптах с учетом новых команд qlik-cli. |
28 ноября 2023 года | Дополнительные листы для анализа модели объема. |
Следующая иллюстрация показывает процедуру миграции и использование инструментов миграции для переноса пользователей и ресурсов в облако. Данные из Qlik Sense под управлением клиента и метаданные из Qlik Cloud собираются в приложении «Миграция». Таблицы данных миграции сохраняются в файл CSV и импортируются в Qlik Cloud с помощью скриптов qlik-cli. Затем приложение «Миграция» перезагружается для обновления состояния миграции. Этот процесс практически не отличается для всех переносимых элементов.
Скрипты миграции
Загрузите файлы csv с метаданными с помощью приложения «Миграция». Скрипты используются для импорта управляемых клиентом ресурсов в облако. Для получения дополнительной информации см. раздел Использование скриптов миграции.
Подготовка миграции
Следующие элементы упрощают миграцию и обеспечивают рекомендованную рабочую процедуру.
-
Раздел: Планирование миграции в Qlik Cloud. Оценка и подготовка являются важными этапами успешной миграции.
-
Инструменты миграции Qlik Cloud — файл Zip, содержащий следующие объекты:
- Приложение «Миграция» Qlik Cloud, используемое для управления очередностью и мониторинга миграции.
- Рабочий лист миграции: файл Excel. Используйте эту электронную таблицу, чтобы собрать списки пользователей, ролей, правил пользователей, лицензий, пространств и другие сведения.
- Скрипты миграции для миграции элементов с Qlik Sense под управлением клиента на Qlik Cloud.
-
qlik-cli: интерфейс командной строки (CLI, Command line interface), доступный в Qlik Developer: qlik-cli
После оценки и планирования выполните следующие действия:
-
Настройка приложения «Миграция»: импортируйте приложение SaaS Migration 1.x.qvf в Консоль управления Qlik (QMC), настройте Коннектор REST, внесите изменения в скрипт загрузки и перезагрузите приложение.
-
Найдите идентификатор клиента. В Qlik Cloud он отображается в разделе О программе меню профиля пользователя.
-
Настройте скрипты миграции.
-
Создайте и примените теги к приложениям и подключениям к данным.
Настройка приложения «Миграция»
В этом разделе описывается, как импортировать приложение «Миграция», создать ключ API, настроить подключение REST, а также изменить скрипт загрузки в приложении. Для получения дополнительной информации см. раздел Настройка приложения «Миграция».
Импорт приложения «Миграция»
Выполните следующие действия.
-
В QMC откройте Приложения.
-
Щелкните Импорт.
-
Перейдите к загруженному приложению SaaSMigration 1.x.qvf.
-
Щелкните Импорт.
Теперь приложение доступно в хабе.
Настройка подключения REST
Прежде всего, создайте ключ API в облачном клиенте.
Выполните следующие действия.
-
В Консоль управления облачного клиента откройте Ключи API.
-
Щелкните Создать новый.
-
Щелкните Создать новый ключ.
-
Введите описание ключа и задайте для него срок действия.
-
Щелкните Создать.
-
Скопируйте ключ API и сохраните в безопасном месте.
Следующий шаг — настройка Коннектор REST в Qlik Sense Enterprise on Windows.
Выполните следующие действия.
-
В Qlik Sense Enterprise on Windows создайте новое подключение к данным и выберите в качестве источника данных REST.
Примечание к информацииЕсли не указано иное, оставьте значения по умолчанию. -
Введите URL в следующем формате: https://<tenant>.<region>.qlikcloud.com/api/v1/items.
-
В разделе Дополнительные параметры запроса > Заголовки запросов введите Авторизация в поле Имя, а в поле Значение введите слово «Bearer» (носитель), за которым следует ключ API, созданный ранее. Обратите внимание на пробел между словом «Bearer» и ключом API.
-
В разделе Разбивка на страницы > Тип разбивки на страницы выберите Следующий URL и в поле «Следующий URL» введите root/links/next/href.
-
Введите имя подключения, например REST для Qlik Cloud.
-
Нажмите кнопку «Создать».
Изменение скрипта загрузки
Выполните следующие действия.
-
В хабе Qlik Sense откройте приложение SaaSMigration 1.x.qvf.
Откроется обзор приложения.
-
Откройте Редактор загрузки данных.
-
Откройте раздел ** конфигурация **.
-
В строке Set vu_tenant_fqdn введите полностью квалифицированное имя домена.
Пример: Set vu_tenant_fqdn = 'my_tenant.eu.qlikcloud.com';
-
В строке Set vu_rest_connection_SaaS введите имя подключения REST к клиенту Qlik Cloud.
Пример: Set vu_rest_connection_SaaS = 'MyRESTConnection for SaaS';
-
В строке SET vu_central_node_host_name введите имя хоста центрального узла или имя компьютера.
Пример 1. SET vu_central_node_host_name = 'sense-central-node'
Пример 2. SET vu_central_node_host_name = 'my-central-node.domain.com'
-
Если виртуальный прокси-сервер имеет префикс, его необходимо ввести в строку SET vu_virtual_proxy_prefix = '';
Пример: SET vu_virtual_proxy_prefix = 'my-virtual-proxy-prefix';
Настройка интерфейса командной строки qlik-cli и скриптов миграции
Выполните следующие действия.
-
Установите Qlik-CLI for Windows, это интерфейс командной строки для Qlik Sense SaaS. Он обеспечивает доступ ко всем общедоступным API через командную строку, что упрощает работу со скриптами и автоматизацию новых и старых рабочих процессов.
-
Убедитесь, что файл qlik.exe указан в пути к исполняемому файлу Windows. В зависимости от того, как установлен qlik-cli, qlik.exe может находится не в папке Windows по умолчанию.
-
Настройте подключение к Qlik Cloud. См. Приступая к работе.
-
Настройте подключение к Qlik Sense под управлением клиента, см. раздел Qlik Sense: настройка проверки подлинности JWT..
-
Внесите изменения в 0_globals.ps1 и задайте контекстные имена для:
-
$QlikSaaSContext
-
$tenantid
Чтобы найти идентификатор TenantId, выберите Профиль_пользователя > О программе.
-
$MIGRATIONFROM = “Qlik Sense”
-
Создание и применение тегов
Рекомендуется предоставить права администратора содержимого пользователям, которые могут оценивать и помечать тегами приложения и подключения к данным.
Выполните следующие действия.
-
Создайте следующие теги в QMC, в разделе Теги, для Qlik Sense под управлением клиента:
-
Состояние подключения — 05 Выбрано
-
Состояние подключения — 10 Настроено
-
Состояние подключения — 20 Проверено
-
Состояние подключения — 30 Выполнено
-
Состояние подключения — 99 Не требуется
-
Файлы данных по типу подключения
-
Шлюз данных по типу подключения — Доступ к данным
-
Встроенный коннектор по типу подключения
-
Приложение — 05 Перенесено через многооблачную инфрастуктуру
-
Приложение — 05 URL-ссылка на Qlik Sense Windows
-
Приложение — 10 Выбрано для обзора миграции
-
Приложение — 20 Требуется вмешательство в миграцию
-
Приложение — 30 Готово к миграции
-
Приложение — 40 Миграция завершена
-
Приложение — 99 Не будет перенесено
-
-
Оцените приложения и подключения к данным и примените соответствующие теги.
-
В разделе QMC Приложения выберите приложения, к которым будет применен одинаковый тег.
-
Щелкните Изменить и выберите соответствующий тег.
По очереди обрабатывайте небольшое количество разных типов приложений за один раз и проверяйте ход выполнения миграции на листе Состояние миграции SaaS приложений в приложении «Миграция» SaaS. См. Миграция приложений.