Trabalhando com armazenamentos de mudança
Repositórios de alterações contêm as alterações do usuário em colunas editáveis em tabelas de gravação.
O que é um repositório de alterações?
Um repositório de alterações é uma localização de armazenamento gerenciada pelo Qlik que contém as alterações adicionadas pelo usuário de colunas editáveis em uma tabela de gravação. O repositório de alterações é um local de armazenamento temporário; as alterações são armazenadas por um máximo de 90 dias, após os quais são excluídas.
Você pode manter o repositório de alterações atribuído automaticamente ou selecionar um repositório de alterações existente do espaço atual. Ao selecionar um repositório de alterações existente, certifique-se de que as chaves primárias na tabela de gravação correspondam às chaves primárias definidas nesse repositório de alterações.
O conteúdo do repositório de alterações é acessado via o change-stores API. Com seu ID do repositório de alterações, você pode formular solicitações de API e automações que extraem as alterações do usuário para uma localização permanente, como uma pasta ou um banco de dados. Para obter mais informações, consulte Extraindo alterações de tabelas de gravação.
Gerenciando repositórios de alterações
Por padrão, um novo repositório de alterações é criado para tabelas de gravação recém-criadas. Com relação aos armazenamentos de alterações, você pode personalizar o seguinte:
-
Selecione um repositório de alterações existente para conectar à sua tabela de gravação.
Selecionando um repositório de alterações diferente para uma tabela de gravação
-
Atribua nomes exclusivos aos repositórios de alterações.
Selecionando um repositório de alterações diferente para uma tabela de gravação
Opcionalmente, em Repositório de alterações no painel de propriedades, selecione um repositório de alterações existente do espaço atual.
Eis os requisitos e o comportamento:
-
As chaves primárias precisam corresponder entre a tabela de gravação atual e o repositório de alterações selecionado.
-
Um único repositório de alterações não pode ser conectado a múltiplas tabelas de gravação.
Faça o seguinte:
-
No painel de propriedades, expanda Repositório de alterações.
-
Ao lado de ID do repositório de alterações, clique em Selecionar.
Renomeando repositórios de alterações
Lojas de alteração têm nomes personalizáveis. Você pode renomear cada repositório de alterações para torná-los únicos e reconhecíveis.
Faça o seguinte:
-
No painel de propriedades, expanda Repositório de alterações.
-
Clique em
. -
Digite o nome do repositório de alterações e clique para confirmar.
Copiando o ID do repositório de alterações
Você pode copiar o ID do repositório de alterações de duas maneiras:
-
No modo de edição da pasta depois de criar a tabela de gravação. No painel de propriedades, em Repositório de alterações > ID do repositório de alterações, clique em
Copiar ID.Copie o ID do repositório de alterações do painel de propriedades.
-
No modo de análise ao visualizar a tabela de gravação. Clique no ícone
no canto inferior direito. Clique em para copiar o ID do repositório de alterações.Copiando o ID do repositório de alterações ao visualizar uma tabela de gravação.
Extraindo alterações de um repositório de alterações
Desenvolvedores de aplicativos e integradores de sistema podem extrair dados de repositório de alterações de tabelas de gravação, usando-os para implementar automações em tempo real e outros fluxos de trabalho. Consulte Extraindo alterações de tabelas de gravação.
Alterar ciclo de vida da loja
Esta seção descreve o comportamento esperado para armazenamentos de alterações quando o conteúdo é movido, publicado e excluído.
Publicando
É esperado um comportamento diferente entre o momento em que o aplicativo é publicado pela primeira vez em um espaço gerenciado e cada vez que o aplicativo é republicado posteriormente.
Primeira publicação
Quando um aplicativo com uma tabela de gravação é publicado pela primeira vez em um espaço gerenciado:
-
Novos repositórios de alterações são criados no espaço de destino
-
O aplicativo publicado usará esses novos repositórios de alterações
Republicando sem alterações na configuração de gravação
Nesse cenário, nada muda. O aplicativo publicado continua usando os repositórios de alterações no espaço gerenciado.
Republicando após a adição de novas colunas editáveis no aplicativo de origem
Nesse cenário, os repositórios de alterações de destino são atualizados para oferecer suporte a essas novas colunas.
Republicando após remover colunas editáveis no aplicativo de origem
Neste cenário:
-
A tabela de gravação no aplicativo publicado não mostrará mais as colunas editáveis excluídas.
-
Os repositórios de alterações de destino retêm essas colunas excluídas.
Exclusão
A exclusão envolve a exclusão de gráficos, pastas, aplicativos e espaços.
Excluir gráfico, pasta ou aplicativo
Depois que um gráfico, pasta ou aplicativo contendo uma tabela de gravação é excluído, o repositório de alterações ainda existe no espaço. Você ainda pode:
-
Acesse o repositório de alterações através da change-stores API.
-
Conecte uma tabela de gravação diferente ao repositório de alterações, se as chaves primárias corresponderem. Consulte Selecionando um repositório de alterações diferente para uma tabela de gravação.
Excluir espaço
Quando um espaço contendo tabelas de gravação é excluído, todos os repositórios de alterações que estavam no espaço são perdidos e não são recuperáveis.
Movendo
A movimentação ocorre quando um aplicativo com uma tabela de gravação é movido para um espaço diferente. Com a movimentação, ocorre o seguinte:
-
Um repositório de alterações vazio será criado no espaço de destino.
-
A tabela de gravação no aplicativo não estará mais vinculada ao repositório de alterações no espaço original.
Após a movimentação, você pode reconfigurar a tabela de gravação para selecionar um repositório de alterações existente no espaço de destino.
Limitações
Para limitações do repositório de alterações, consulte Repositório de alterações e retenção de dados.