Armazenamentos de dados no Make
Os armazenamentos de dados permitem manter informações entre execuções de um cenário ou transferir um estado simples entre cenários. Eles funcionam como uma pequena base de registros dentro do Make e são úteis para deduplicação, correlação de IDs e acompanhamento do que já foi processado.
Um armazenamento de dados não deve ser tratado como substituto automático para um banco de dados de negócio. Antes de guardar informações pessoais ou confidenciais, verifique as regras de acesso, retenção e proteção aplicáveis ao seu processo.
Planejar a chave e a estrutura
Cada registro pode ter uma chave única. Escolha uma chave estável e previsível, como o ID fornecido pelo sistema de origem ou uma combinação que represente de forma inequívoca o evento processado.
Evite usar um valor que possa mudar, como nome ou endereço de e-mail, quando o sistema já oferece um ID próprio. Uma chave bem definida permite consultar, atualizar e repetir uma operação sem criar cópias do mesmo registro.
A estrutura de dados descreve os campos e os tipos aceitos. Antes de criá-la, registre:
Identificadores longos, números de telefone, códigos postais e valores com zeros à esquerda normalmente devem ser armazenados como texto, pois não são usados para cálculos.
Criar um armazenamento de dados
Se você criar uma estrutura, adicione os campos manualmente ou gere uma proposta a partir de uma amostra representativa. Revise sempre a estrutura gerada: uma única amostra pode não conter campos opcionais ou pode levar a um tipo inadequado.
A opção de estrutura estrita pode rejeitar dados que contenham campos não declarados. Use-a quando o contrato dos registros for estável e quando a falha por campo extra for preferível a aceitar dados inesperados.
Módulos principais
Os nomes exibidos na interface podem variar com a versão do aplicativo, mas as operações centrais são:
Antes de ativar a substituição automática, confirme se o módulo recebe a chave correta. Uma chave vazia ou calculada de forma inconsistente pode impedir a atualização esperada ou criar registros que não serão encontrados depois.
Padrão de deduplicação
Um cenário que recebe o mesmo evento mais de uma vez pode usar este fluxo:
Para ações que podem terminar no sistema externo e falhar antes do registro local, consulte primeiro o destino antes de tentar novamente. Isso evita duplicidades quando o resultado da execução anterior é incerto.
Pesquisar e atualizar registros
Ao usar Search Records, defina filtros específicos e trate o caso sem resultado. Um módulo de pesquisa pode interromper uma rota quando não encontra registros, dependendo da configuração.
Para datas, converta a entrada para o formato esperado antes de filtrar. Para texto, confirme diferenças de maiúsculas, espaços e normalização. Quando a consulta puder retornar várias linhas, defina o critério de ordenação e não presuma que o primeiro registro é o correto.
Ao atualizar, mapeie apenas os campos que realmente devem mudar. Teste como o módulo trata valores vazios para não apagar informações válidas.
Alterar a estrutura com segurança
Mudanças de estrutura podem afetar dados antigos. Antes de renomear campos, trocar tipos ou fazer uma migração em massa:
O nome interno de um campo atua como identificador. Trocar apenas o rótulo visual é diferente de trocar esse nome. Uma alteração de tipo também não garante que os registros antigos sejam convertidos automaticamente.
Cópia de segurança e exclusão
Antes de excluir muitos registros ou alterar a estrutura, faça uma cópia para outro armazenamento de dados ou use um processo de exportação autorizado. Um cenário de backup pode pesquisar registros no armazenamento original e adicioná-los a uma estrutura de cópia.
Revise a quantidade de resultados e a paginação para não produzir uma cópia parcial. Guarde também a data, a origem e a finalidade do backup.
Exclusões podem não ter reversão automática. Restrinja os módulos de exclusão com filtros, conexões e permissões adequadas, e teste primeiro em dados descartáveis.
Diagnóstico
Se um cenário não encontrar dados após uma alteração, verifique se o nome interno do campo mudou. Se os tipos antigos e novos estiverem misturados, migre os registros explicitamente para o formato desejado.
Quando a conta indicar falta de espaço, revise a alocação e os registros armazenados antes de remover dados. Capacidades, disponibilidade e regras de plano podem mudar; consulte a fonte oficial em vez de assumir um valor fixo.
Para confirmar a interface, os módulos e as regras atuais, consulte a documentação oficial sobre armazenamentos de dados no Make.