Exportando e importando pipelines de dados
Você pode exportar um projeto de pipeline de dados para um arquivo que contém tudo o que é necessário para reconstruir esse projeto. O arquivo de exportação pode ser importado para o mesmo locatário ou para outro locatário. Você pode usar isso, por exemplo, para mover projetos de dados de um locatário para outro ou para fazer cópias de backup de projetos de dados. Você também pode atualizar um projeto de dados de um arquivo de exportação.
O formato do arquivo exportado foi alterado de um único arquivo JSON para um arquivo ZIP contendo vários arquivos JSON. O formato JSON antigo terá suporte para importação até 30 de janeiro de 2026. Para converter seus arquivos JSON para o novo formato, você pode importá-los e, em seguida, exportá-los para o novo formato ZIP. Os projetos no antigo formato JSON não podem ser importados por meio da API.
Os usuários são aconselhados a exportar seus projetos existentes para aproveitar o novo formato até 30 de janeiro de 2026.
Exportando um projeto de dados
Para exportar um projeto, siga um destes procedimentos:
-
Em Integração de Dados > Projetos, clique em
no projeto a ser exportado e selecione Exportar.
-
Abra o projeto, clique em
no canto superior direito e selecione Exportar.
O projeto é exportado para um arquivo ZIP com um nome de arquivo que consiste no nome do projeto, na plataforma de dados e em um carimbo de data/hora.
Importando projetos
Esta seção aborda a importação de projetos. Você pode importar um projeto de armazém de dados na nuvem ou um projeto do Qlik Cloud (via Amazon S3).
Você pode alterar a plataforma de dados a ser usada com as seguintes limitações:
-
Não é possível alterar a plataforma de dados de um armázem de dados na nuvem para o Qlik Cloud, ou vice-versa.
-
Não é possível alterar um projeto do Snowflake usando o armazenamento de arquivos em nuvem para outra plataforma de dados, ou vice-versa.
Antes de importar um projeto
Antes de começar a importar um projeto, considere:
-
Criar todas as novas conexões de que você precisará se estiver importando para um novo locatário ou espaço.
-
Se o projeto usar conexões de aplicativo SaaS que ainda não existem, você deverá criar as conexões e gerar metadados antes de iniciar a importação.
-
Se estiver importando um pipeline entre projetos, você deverá importar os projetos upstream primeiro.
Importando um projeto de armazém de dados na nuvem
Você pode importar um projeto de armazém de dados na nuvem exportado para o mesmo locatário do qual foi exportado ou para outro locatário. Quando o projeto é importado para um locatário diferente do locatário do projeto de dados original, você precisa definir novas conexões para o projeto, a área de preparação e para todas as fontes de dados.
Se o projeto consumir tarefas de outros projetos, você deverá mapear projetos e tarefas, a menos que os nomes dos espaços e projetos sejam idênticos.
-
Em Integração de Dados > Projetos, clique em Criar novo e selecione Importar projeto.
-
Adicione o arquivo exportado. Você pode soltá-la no diálogo ou navegar para selecionar o arquivo.
Clique em Próximo.
-
Defina Propriedades do projeto para o novo projeto.
Você deve selecionar em qual espaço adicionar o projeto em Espaço.
Em Plataforma de dados, você pode alterar a plataforma de dados do projeto e a conexão com a plataforma de dados.
É necessário alterar Conexão se você tiver importado um projeto de outro locatário ou se tiver alterado a plataforma de dados na etapa anterior.
Você pode alterar a conexão com a área de preparação. Isso é necessário se você importou um projeto de outro locatário ou, em alguns casos, se você alterou a plataforma de dados na etapa anterior.
Clique em Próximo.
-
Defina Configurações padrão do projeto para o novo projeto.
Você pode adicionar um prefixo aos esquemas de dados criados no projeto em Prefixo para todos os esquemas. Isso é útil quando o projeto importado está no mesmo armazém de dados na nuvem do projeto exportado.
Você também pode definir um nome padrão em Nome do banco de dados. Para projetos do Snowflake, você pode definir um Nome de armazém de dados padrão e, para projetos do Databricks, você pode definir um Nome de catálogo padrão. Você pode usar o nome padrão do projeto para todos os tipos de tarefa ou definir o nome como padrão ou um nome personalizado para cada tipo de tarefa.
Clique em Próximo.
-
Defina Conexões e configurações de tarefas.
Você pode substituir as conexões de origem importadas ou as origens entre projetos. Isso é necessário se você importou um projeto de outro locatário.
Em Configurações de tarefas opcionais, você também pode alterar as configurações de tarefas que foram substituídas no projeto original.
-
Quando estiver pronto, clique em Importar.
O projeto é adicionado à página inicial do Integração de dados.
Importando um projeto com o Qlik Cloud como plataforma de dados
Você pode importar um projeto do Qlik Cloud exportado (via Amazon S3) para o mesmo locatário de onde foi exportado ou para outro locatário. Quando o projeto é importado para um locatário diferente do locatário do projeto de dados original, você precisa definir novas conexões para o projeto, a área de preparação e para todas as fontes de dados.
Não é possível mudar a plataforma de dados do Qlik Cloud para um data warehouse na nuvem, como o Snowflake.
-
Em Integração de Dados > Projetos, clique em Criar novo e selecione Importar projeto.
-
Adicione o arquivo exportado. Você pode soltá-la no diálogo ou navegar para selecionar o arquivo.
Clique em Próximo.
-
Nome
Altere o nome do projeto. O nome padrão é o nome original do projeto prefixado com Imported_.
-
Espaço
Selecione em qual espaço adicionar o projeto. -
Descrição
Adicione ou edite a descrição do projeto. -
Armarzenar arquivos QVD em:
Selecione onde gerar arquivos QVD.
-
Armazenamento gerenciado pelo Qlik
-
Armazenamento gerenciado pelo cliente
Armazenamento gerenciado pelo Amazon S3 ou armazenamento gerenciado por você.
-
-
Conexão de dados
Se você selecionou Armazenamento gerenciado pelo cliente, poderá alterar a conexão com a área de armazenamento Amazon S3.
Isso é necessário se você importou um projeto de outro locatário.
-
Conexão com a área de preparação
Você pode alterar a conexão com a área de preparação do Amazon S3.
Isso é necessário se você importou um projeto de outro locatário ou, em alguns casos, se você alterou a plataforma de dados na etapa anterior.
-
Clique em Próximo.
-
Defina conexões para as tarefas adicionadas na versão original
Você pode substituir as conexões de origem importadas.Isso é necessário se você importou um projeto de outro locatário.
-
Em Configurações de tarefa opcionais, você pode alterar as configurações de tarefa que foram substituídas no projeto original.
-
Quando estiver pronto, clique em Importar.
O projeto é adicionado à página inicial do Integração de dados.
Atualizando um projeto
Você pode atualizar um projeto de um arquivo de exportação. Isso substituirá todas as tarefas no pipeline de dados, mas as conexões e configurações não serão substituídas. As tarefas de dados que não estão incluídas no projeto importado serão removidas.
Por exemplo, você pode importar um projeto exportado do espaço de dados de desenvolvimento para um projeto no espaço de dados de produção para atualizar o projeto de produção.
Antes de começar a atualizar o projeto:
-
Se desejar um backup do projeto antes de atualizar, exporte-o clicando em
e, em seguida, em Exportar.
-
Você deve interromper todas as tarefas que serão removidas do pipeline de dados antes de atualizar o projeto.
-
Se o projeto usar conexões de aplicativo SaaS que ainda não existem, você deverá criar as conexões e gerar metadados antes de iniciar a importação.
-
Certifique-se de que o projeto importado use a mesma plataforma de dados em nuvem, por exemplo, Snowflake.
Para atualizar um projeto:
-
Abra o projeto que você deseja atualizar.
-
Clique em
e, em seguida, em Importar.
-
Selecione ou solte o arquivo que deseja importar.
-
Faça as alterações necessárias para mapear as conexões que são diferentes entre o projeto e o projeto importado.
Por exemplo, o projeto importado pode estar usando uma conexão de origem chamada SQL1, enquanto este projeto usa uma conexão semelhante chamada SQL2. Nesse caso, mapeie a conexão importada para SQL2 em Definir conexões para as tarefas adicionadas na versão original.
Nota informativaAo selecionar uma conexão para mapear, você pode criar uma nova conexão de banco de dados, mas não uma conexão de aplicativo SaaS.Clique em Importar quando estiver pronto.
O projeto agora está atualizado de acordo com o arquivo importado. Pode ser necessário validar e sincronizar tarefas de dados que foram atualizadas por meio da importação.
Limitações
-
Notificações não são incluídas quando você exporta um pipeline. Você precisa configurar novas notificações no pipeline importado.
-
Não crie pipelines que criem loops ou dependências mútuas entre projetos. Não há suporte para exportação e importação desses projetos.