Instalando o Qlik DataTransfer

O Qlik DataTransfer é um aplicativo leve do Windows que permite carregar dados de fontes de dados locais para um Qlik Cloud do Qlik Cloud sem tunelamento de firewall. O proprietário da conta de serviço (SAO) ou administrador de locatários gera uma chave de API a partir do locatário, que é então usada para autenticar o Qlik DataTransfer. Após a autenticação, é possível programar carregamentos automáticos de dados ou fazer o upload dos dados manualmente.

O Qlik DataTransfer funciona com os seguintes tipos de fontes de dados:

• Dados de aplicativos
• Dados de conexão
• Pastas

Para obter informações sobre os tipos de dados disponíveis com o Qlik DataTransfer, consulte Fazendo upload de dados locais com o Qlik DataTransfer.

Uma instalação do Qlik DataTransfer só pode ser associada a um único locatário do Qlik Cloud.

Requisitos do sistema do Qlik DataTransfer

Antes de começar

Antes de baixar e executar o instalador do Qlik DataTransfer, certifique-se de atender aos seguintes requisitos:

• Você tem acesso a um locatário do Qlik Cloud.
• Você é um usuário com Direito de usuário Professional ou Full User nesse locatário.
• Você recebe a função de Desenvolvedor nesse locatário.
• Você tem acesso a todos os espaços dos quais faz o upload de dados do Qlik DataTransfer. Para obter mais informações, consulte Gerenciando espaços.
• Você tem permissão de administrador em uma máquina Windows que tem acesso a fontes de dados locais.
• Sua máquina Windows atende aos seguintes requisitos de sistema: Requisitos de sistema do Qlik DataTransfer (somente em inglês).
• As chaves de API são habilitadas no centro de atividades de Administração. Para obter informações sobre como habilitar chaves de API, consulte Gerenciando chaves de API.

• A política Definições de configurações SSL deve ser definida para oferecer suporte apenas a cifras no formato IANA na máquina em que você está instalando o Qlik DataTransfer.

  Se você estiver instalando ou atualizando para o Qlik DataTransfer May 2021 ou posterior no Windows Server 2012 R2, deverá atualizar o TLS Cipher Suite. As cifras padrão incluídas na política de segurança padrão do Windows Server 2012 R2 não têm suporte pelo Qlik DataTransfer May 2021 ou versão posterior. Os seguintes conjuntos de cifras devem estar presentes:

  • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

  • TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256

  • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

  • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384

  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

  Para obter instruções sobre como atualizar o TLS Cipher Suite em seu sistema ou desabilitar cifras fracas no ambiente do Qlik DataTransfer, consulte o seguinte artigo da comunidade: https://community.qlik.com/t5/Knowledge/Adding-Cipher-Suite-for-Qlik-Data-Transfer-on-Windows-2012-R2/ta-p/1819406.

• O Qlik DataTransfer requer uma conta de usuário do Windows. É recomendado que você use uma conta de usuário dedicada com privilégios de administrador para executar o serviço Qlik DataTransfer. Para a instalação, se o usuário dedicado for um administrador, você poderá fazer login como esse usuário para instalar o Qlik DataTransfer. Se o usuário dedicado não for um administrador local, você deverá usar uma conta de administrador para instalar o Qlik DataTransfer.

  Se estiver instalando ou atualizando o Qlik DataTransfer em um servidor Windows com o Qlik Sense Enterprise on Windows instalado, o Qlik DataTransfer deverá ser instalado com o usuário de serviços do Qlik Sense usado na instalação do Qlik Sense.

• A conta do usuário que instalar o Qlik DataTransfer deve ter permissão para executar scripts do PowerShell com a política de execução RemoteSigned

• Se você alterar a conta de logon do serviço depois de configurar o Qlik DataTransfer com seu locatário, deverá reconfigurar o locatário e as conexões. Em seguida, em %ProgramData%/Qlik/DataTransfer/DataUpload/storage, exclua token.json. Reinicie o serviço do Qlik DataTransfer.

• Para a versão February 2021 SR1, é recomendado instalar o Qlik DataTransfer em um servidor Qlik Sense Enterprise on Windows ou QlikView Server separado. Se o Qlik DataTransfer estiver instalado no servidor Qlik Sense Enterprise on Windows ou QlikView Server, o Qlik DataTransfer será executado usando a conta de usuário do Sistema Local. Se você alterar a conta de usuário do serviço, ela irá parar o Qlik DataTransfer ou o Qlik Sense Service Dispatcher.

Confirmando a política de execução de contas do usuário da instalação

A conta do usuário que instalar o Qlik DataTransfer deve ter permissão para executar scripts do PowerShell com a RemoteSigned política de execução Se você não tiver permissão para atribuir permissões de conta de usuário, entre em contato com o administrador para conceder essas permissões à conta de usuário da instalação.

Faça o seguinte:

1. Abra o PowerShell no modo de administrador.

2. Execute Get-ExecutionPolicy. Deve ser RemoteSigned. Se estiver Restricted ou Disabled, continue para a próxima etapa.

3. Execute Set-ExecutionPolicy RemoteSigned.

4. Selecione Y.

Fazer o download do instalador e executá-lo

Faça o seguinte:

1. Faça download do arquivo Qlik DataTransfer.exe de um dos seguintes locais:

   • Downloads de produtos
     Para obter mais informações, consulte Fazendo download de arquivos de instalação.

   • Qlik Cloud
     Clique no ícone do seu perfil no canto superior direito e clique em Configurações do perfil. Em Outros, clique em Ferramentas.

     Nota governamental do Qlik CloudEssa opção não está disponível no Qlik Cloud Government.

2. Execute o instalador e aceite o Contrato de licença do usuário da Qlik. O caminho de instalação padrão é %Program Files%\Qlik\DataTransfer. Ao inserir as credenciais de serviço, o nome de usuário deve estar no formulário domínio\ username.

   Nota informativa

   Se você inserir um nome de usuário com mais de 20 caracteres, ele deverá estar no formato UPN (Nome da entidade de segurança do usuário) e deverá incluir o nome de domínio completo. Por exemplo, longusername@full.domain.name.

   Nota informativa

   Se você tiver um Qlik Sense Desktop ou outra plataforma Qlik instalada no mesmo servidor, deverá encerrá-los e interromper os serviços Qlik antes de instalar o Qlik DataTransfer.

   

   Concluída a instalação, reinicie os serviços Qlik na seguinte ordem:

   1. Qlik Sense Service Dispatcher

   2. Qlik Logging Service

   3. Qlik Sense Repository Service

   4. Qlik Sense Proxy Service

   5. Qlik Sense Engine Service

   6. Qlik Sense Scheduler Service

   7. Qlik Sense Printing Service

3. Na janela Credenciais de Serviço, insira o nome de usuário e a senha da conta que você deseja usar para executar os serviços Qlik DataTransfer.

4. Consulte Configurando o Qlik DataTransfer para personalizar configurações adicionais no arquivo services.config.

O instalador cria um atalho na área de trabalho para iniciar o aplicativo Qlik DataTransfer.

Gerar uma chave de API

As chaves de API expiram. Os tempos de expiração padrão podem não ser apropriados para suas necessidades comerciais. Antes de gerar uma chave de API, considere alterar a expiração máxima do token nas configurações do centro de atividades de Administração. Para obter informações, consulte Habilitando chaves de API no locatário.

Faça o seguinte:

1. Faça login no seu locatário do Qlik Cloud.
2. No seu centro de atividades, clique no ícone do seu perfil no canto superior direito e clique em Configurações do perfil.
3. Selecione Chaves de API.

4. Selecione Gerar nova chave.

   
5. Insira um nome para a chave de API e selecione o Expira em tempo.

6. Clique em Gerar.

   

7. Clique em Copiar e fechar para copiar a API para sua área de transferência.

   Nota informativaCertifique-se de salvar a chave de API. Você precisa dessa chave para autenticar o Qlik DataTransfer.
   

   Agora que você tem uma chave de API, pode criar uma conexão segura entre o Qlik DataTransfer e seu locatário do Qlik Cloud. A chave de API é usada para autenticar o Qlik DataTransfer durante o upload de dados para o locatário. Como a API tem um tempo de expiração, você precisará criar uma nova chave de API e reautenticar o Qlik DataTransfer quando essa chave expirar. Não será necessário recriar as conexões de dados se a chave de API expirar.

Autenticar o Qlik DataTransfer

Faça o seguinte:

1. Abra o Qlik DataTransfer.

   Ao abrir o Qlik DataTransfer pela primeira vez, a tela de autenticação Configurar o Qlik DataTransfer é exibida.

   
2. Insira um nome para a conexão.
3. Insira a URL para o locatário do Qlik Cloud.

4. Cole a chave de API que você gerou do locatário.

5. Clique em Aplicar para validar o locatário.

6. Quando sua chave de API expirar ou para autenticar o Qlik DataTransfer em outro locatário, clique em para inserir uma nova chave de API e depois clique em Confirmar.

   

Após a autenticação do Qlik DataTransfer, você pode carregar seus dados locais para o locatário do Qlik Cloud. Para obter informações sobre como usar o Qlik DataTransfer, consulte Fazendo upload de dados locais com o Qlik DataTransfer.

Atualizar o Qlik DataTransfer

O Qlik DataTransfer exibe um banner de notificação quando novas versões estão disponíveis. O Qlik DataTransfer não atualiza automaticamente para versões mais recentes.

Faça o seguinte:

1. Faça download da nova versão do Qlik DataTransfer no banner no aplicativo ou no Downloads de produtos.
2. Feche sua versão atual do Qlik DataTransfer.

3. Execute o instalador do Qlik DataTransfer.

   Nota informativa

   Se você estiver atualizando o Qlik DataTransfer em um servidor Windows com o Qlik Sense Enterprise on Windows instalado, o Qlik DataTransfer deve ser atualizado com o usuário de serviços do Qlik Sense usado na instalação do Qlik Sense.

4. Clique em Upgrade.

   

Desinstalando o Qlik DataTransfer

Faça o seguinte:

1. Execute o instalador do Qlik DataTransfer.

   Nota informativa

   Se você tiver uma plataforma Qlik instalada no mesmo servidor, deverá interromper os outros serviços Qlik para poder desinstalar o Qlik DataTransfer.

2. Clique em Desinstalar.

3. Após a desinstalação, se aplicável, reinicie os serviços Qlik, na seguinte ordem:

   1. Qlik Sense Service Dispatcher

   2. Qlik Logging Service

   3. Qlik Sense Repository Service

   4. Qlik Sense Proxy Service

   5. Qlik Sense Engine Service

   6. Qlik Sense Scheduler Service

   7. Qlik Sense Printing Service

Limitações

O Qlik DataTransfer tem as seguintes limitações:

• Ao atualizar da versão October 2020 ou posterior, o local para armazenar arquivos de configuração e as portas usadas para executar o Qlik DataTransfer são alterados para o padrão no arquivo de configuração Service.conf. Se você não tiver usado o local padrão para armazenar arquivos de configuração ou as portas padrão para executar o Qlik DataTransfer, perderá essas configurações. Para manter suas configurações, faça backup de Service.conf antes da atualização e refaça as configurações em Service.conf a partir do arquivo copiado para backup após a conclusão da atualização.

• Se você não tiver usado o local padrão para armazenar arquivos de configuração em Service.conf, precisará excluir manualmente os arquivos na pasta selecionada.

• Se você usar proxies, deverá adicionar um bypass do Qlik DataTransfer aos seus firewalls usando a URL do locatário do Qlik Cloud. Sem um bypass, o Qlik DataTransfer não poderá se conectar ao Qlik Cloud.

• O Qlik DataTransfer deve ser instalado em um servidor Windows dedicado, conforme estipulado nos Requisitos do sistema do Qlik DataTransfer. Não o instale no servidor de fonte de dados real ou em um servidor que já tenha o Qlik Data Gateway - Direct Access instalado.