Ir para conteúdo principal Pular para conteúdo complementar

Configurando as ferramentas de migração do Qlik Cloud

As ferramentas de migração do Qlik Cloud ajudam você a planejar e realizar sua migração para o Qlik Cloud.

Baixe e instale as ferramentas de migração do Qlik Cloud.

O conjunto de ferramentas inclui:

  • Aplicativo de migração do Qlik Cloud: aplicativo Qlik Sense usado para gerenciar o sequenciamento e o monitoramento da sua migração.

  • Planilha de migração: essa planilha do Microsoft Excel é usada para reunir listas de usuários, funções, regras de segurança, licenças, espaços e muito mais.

  • Scripts de migração: usados no processo de migração para o Qlik Cloud.

Histórico de revisões

A tabela a seguir resume as alterações nas ferramentas de migração do Qlik Cloud.

Date Notas
10 de maio de 2022

Lançamento inicial

12 de julho de 2022

Aplicativo de migração atualizado

Novos scripts de migração

20 de outubro de 2022 Correções de bugs

A imagem a seguir mostra como a migração é realizada e como as ferramentas de migração ajudam você a mover usuários e ativos para a nuvem. Os dados do Qlik Sense Client-Managed e os metadados do Qlik Cloud são extraídos para o aplicativo de migração. As tabelas de dados de migração são salvas em um arquivo CSV e importadas para o Qlik Cloud usando os scripts qlik-cli. Em seguida, o aplicativo de migração é recarregado para refletir o status da migração. Esse processo é essencialmente o mesmo para todos os itens que serão migrados.

Procedimento para migrar dados do Qlik Sense Client-Managed para o Qlik Cloud
O aplicativo de migração se conecta à implementação gerenciada pelo cliente e à implementação na nuvem.

Scripts de migração

Faça o download dos arquivos de metadados .csv usando o Aplicativo de migração. Os scripts são usados para importar ativos gerenciados pelo cliente para a nuvem.

Nota informativaPara poder executar esses scripts, você deve navegar até a pasta onde eles estão. É necessário executá-los em sequência, pois há dependências entre eles.

Preparação para a migração

Os itens a seguir facilitarão sua migração e fornecerão um procedimento de trabalho recomendado.

  • Tópico: Planejando sua migração para o Qlik Cloud. A avaliação e a preparação são essenciais para uma migração de sucesso.

  • Ferramentas de migração do Qlik Cloud: arquivo zip que contém:

    • Aplicativo de migração do Qlik Cloud, usado para gerenciar o sequenciamento e o monitoramento da sua migração.
    • Planilha de migração: Arquivo do Excel. Use essa planilha para reunir listas de usuários, funções, regras de segurança, licenças, espaços e muitos outros tipos de conteúdo.
    • Scripts de migração para migrar itens do Qlik Sense Client-Managed para o Qlik Cloud.
  • qlik-cli: Interface de linha de comando (CLI), disponível no Qlik Cloud Developer

Após a avaliação e o planejamento, faça o seguinte:

  1. Configure o aplicativo de migração: Importe o aplicativo SaaS Migration 1.x.qvf para o Qlik Management Console (QMC), configure Conector REST do, modifique o script de carregamento e recarregue o aplicativo.

  2. Procure seu ID de locatário. Você o encontrará no Qlik Cloud, em Seu perfil de usuário > Sobre.

  3. Configure os scripts de migração.

  4. Crie e aplique tags em aplicativos e conexões de dados.

Configurando o Aplicativo de migração

Importando o Aplicativo de migração

Faça o seguinte:

  1. No QMC, abra Aplicativos.

  2. Clique em Importar.

  3. Navegue até o aplicativo Migration 1.x.qvf que você baixou.

  4. Clique em Importar.

O aplicativo agora está disponível no hub.

Configurando a conexão REST

Comece criando uma chave de API no seu locatário de nuvem.

Faça o seguinte:

  1. No Management Console do seu locatário de nuvem, abra Chaves de API.

  2. Clique em Gerar nova.

  3. Clique em Gerar nova chave.

  4. Insira uma descrição da chave e defina a expiração da chave.

  5. Clique em Gerar.

  6. Copie a chave da API e armazene-a com segurança.

O próximo passo é configurar o Conector REST do no Qlik Sense Enterprise on Windows.

Faça o seguinte:

  1. No Qlik Sense Enterprise on Windows, crie uma nova conexão de dados e selecione REST como a fonte de dados.

    Nota informativaSe nada mais for declarado, mantenha os valores padrão.
  2. Insira o URL no seguinte formato: https://<locatário>.<região>.qlikcloud.com/api/v1/items.

  3. Na seção Parâmetros adicionais de solicitação > Cabeçalhos de consulta, insira Authorization no campo Name e, no campo Value, insira "Bearer" seguido pela chave de API que você gerou anteriormente. Observe o espaço entre "Bearer" e sua chave de API.

  4. Na seção Paginação > Tipo de paginação, selecione Próximo URL e, para o caminho de "Próximo URL", insira root/links/next/href.

  5. Insira um nome de conexão, por exemplo, REST para Qlik Cloud.

  6. Clique em Criar.

Modificando o script de carregamento

Faça o seguinte:

  1. No hub do Qlik Sense, abra o aplicativo Migration 1.x.qvf.

    A visão geral do aplicativo é exibida.

  2. Abra o Editor de carregamento de dados.

  3. Abra a seção ** configuration **.

  4. Na linha Set vu_tenant_fqdn, insira o nome de domínio totalmente qualificado do seu locatário.

    Exemplo: Set vu_tenant_fqdn = 'my_tenant.eu.qlikcloud.com';

  5. Na linha Set vu_rest_connection_SaaS, insira o nome da conexão REST com seu locatário do Qlik Cloud.

    Exemplo: Set vu_rest_connection_SaaS = 'MyRESTConnection for SaaS';

  6. Na linha SET vu_central_node_host_name, insira o nome do host do nó central ou o nome da máquina.

    Exemplo 1: SET vu_central_node_host_name = 'sense-central-node'

    Exemplo 2: SET vu_central_node_host_name = 'my-central-node.domain.com'

  7. Se o seu proxy virtual tiver um prefixo, você precisará inseri-lo na linha SET vu_virtual_proxy_prefix = '';
    Exemplo: SET vu_virtual_proxy_prefix = 'my-virtual-proxy-prefix';

Exemplo de modificação de script de carregamento

Configurando qlik-cli e definindo os scripts de migração

Faça o seguinte:

  1. Instale o Qlik-CLI for Windows, uma interface de linha de comando para o Qlik Sense SaaS. Ele fornece acesso a todas as APIs públicas por meio da linha de comando, facilitando a criação de scripts e a automatização de fluxos de trabalho novos e antigos.

  2. Certifique-se de que qlik.exe esteja no caminho de execução do Windows. Dependendo de como você instalou o qlik-cli, qlik.exe pode não estar no caminho do Windows por padrão.

  3. Configure uma conexão com o Qlik Cloud. Consulte Introdução.

  4. Configure uma conexão com o Qlik Sense Client-Managed. Consulte Qlik Sense: Como configurar a autenticação JWT.

  5. Edite 0_globals.ps1 e defina nomes de contexto para:

    • $QlikSaaSContext

    • $QlikWindowsContext

    • $tenantid

      Seu ID de locatário está localizado em Seu perfil de usuário > Sobre.

    Configuração do nome de contexto para 0_globals.ps1

Nota informativaExecute os scripts de 1 a 7 em sequência, pois há dependências entre eles. Por exemplo, o script 2_setspaces.ps1 pressupõe que os usuários já estejam no sistema como resultado da execução do script 1_setusers.ps1.

Criando e aplicando tags

É uma boa ideia fornecer direitos de administrador de conteúdo para pessoas que possam avaliar e marcar aplicativos e conexões de dados.

  1. Crie as seguintes tags no QMC, na seção Tags, para o Qlik Sense Client-Managed:

    • Con Status - 05 Selected

    • Con Status - 10 Configured

    • Con Status - 20 Tested

    • Con Status - 30 Completed

    • Con Status - 99 Not Required

    • Con Type Data Files

    • Con Type Data Gateway - Data Access

    • Con Type Native Connector

    • App - 05 Migrated via Multi-Cloud

    • App - 05 URL Link to Qlik Sense Windows

    • App - 10 Selected for Migration Review

    • App - 20 Migration Remediation Needed

    • App - 30 Ready to Migrate

    • App - 40 Migration Complete

    • App - 99 Will Not Migrate

  2. Avalie os aplicativos e as conexões de dados e aplique as tags adequadamente.

  3. Na seção Aplicativos do QMC, selecione os aplicativos que terão a mesma tag.

  4. Clique em Editar e selecione a tag apropriada.

Trabalhe de forma iterativa com alguns tipos de aplicativos diferentes ao mesmo tempo e analise o progresso da migração na planilha Status da migração do aplicativo SaaS, no Aplicativo de migração do SaaS, consulte Migrando aplicativos.

Painel de uso de extensões do Qlik Sense

O Painel de uso de extensões do Qlik Sense é um aplicativo Qlik que lista quantos dos seus aplicativos Qlik Sense usam objetos de extensão. Esse painel apenas é recomendado se você utiliza um grande número de extensões.

Baixe o SaaS Extension Usage Dashboard e instale em seu ambiente do Qlik Sense Enterprise Client-Managed.

Visit the discussion forum at community.qlik.com

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!