Partilhar via

Exclua trabalhos concluídos do sistema e log de processos para estar em conformidade com a política de retenção

O gerenciamento de trabalhos concluídos do sistema e do log de processos é crucial para manter a conformidade com a privacidade de dados e garantir o desempenho ideal do sistema no Dataverse.

A tabela System Job AsyncOperation armazena trabalhos do sistema. O nome real da tabela do banco de dados é AsyncOperationBase. Os trabalhos do sistema representam operações assíncronas, incluindo fluxos de trabalho registrados, plug-ins e operações em segundo plano, como exclusão em massa, importação em massa e operações de roll-up.

Quando um fluxo de trabalho assíncrono é iniciado em sua organização do Dataverse, um registro é criado na tabela AsyncOperation para acompanhar seu progresso. Mais registros são criados na tabela Process Log (WorkflowLog) para manter logs da execução do fluxo de trabalho. O nome da tabela de banco de dados real para esses logs é WorkflowLogBase. Os fluxos do processo de negócios também armazenam logs para transições de estágio e ações na tabela WorkflowLog.

Sempre que um trabalho do sistema é concluído, seu resultado é registrado como um trabalho do sistema em um registro AsyncOperation. Os trabalhos concluídos do sistema são registros que capturam os resultados dessas várias operações automatizadas no Dataverse. Com o tempo, esses registros se acumulam e, se não forem gerenciados, podem afetar o armazenamento e o desempenho do sistema.

Se a sua organização depende muito de fluxos de trabalho ou fluxos de processos de negócios, as tabelas associadas podem crescer significativamente ao longo do tempo, potencialmente levando à degradação do desempenho e ao consumo excessivo de armazenamento de base de dados.

Tipos de trabalhos concluídos do sistema e seus status

Trabalhos do sistema

  • Eliminar registos de rastreio de plug-in
  • Excluir trabalhos concluídos do sistema
  • Excluir sessões de processo concluídas para fluxos de trabalho de sincronização

Os trabalhos concluídos do sistema são categorizados em três tipos principais com base em seu status de conclusão:

  • Êxito: trabalhos que foram concluídos com êxito sem erros.
  • Falha: trabalhos que encontraram erros e não foram concluídos conforme o esperado.
  • Cancelado: trabalhos que foram interrompidos antes da conclusão, seja por intervenção do usuário ou por restrições do sistema.

Serviço de exclusão para excluir automaticamente os trabalhos concluídos do sistema

Por padrão, o sistema fornece um serviço de exclusão para excluir automaticamente os trabalhos do sistema que foram concluídos com êxito, falharam ou foram cancelados. O padrão é definido na ferramenta OrganizationSettingsEditor e pode ser alterado usando a ferramenta ou na página Configurações do Ambiente .

Atualizar a política de retenção usando OrganizationSettingsEditor

Para verificar essa configuração:

  1. Instale a ferramenta OrganizationSettingsEditor.
  2. Adicione e edite o EnableSystemJobCleanup.
  3. Defina o EnableSystemJobCleanup como 'true' (se ainda não estiver definido como true).

Definir política de retenção

Existem três parâmetros que permitem definir diferentes períodos de retenção.

  • SucceededSystemJobPersistenceInDays para trabalhos que foram bem-sucedidos.

  • FailedSystemJobPersistenceInDays para trabalhos com falha.

  • CancelledSystemJobPersistenceInDays para trabalhos cancelados.

Atualizar a política de retenção usando a página Configurações do Ambiente (Pré-visualização)

[Esta seção é documentação de pré-lançamento e está sujeita a alterações.]

Importante

  • Este é um recurso de visualização.
  • As funcionalidades de pré-visualização não se destinam a utilização em produção e podem ter funcionalidades restritas. Esses recursos estão sujeitos a termos de uso suplementares e estão disponíveis antes de um lançamento oficial para que os clientes possam obter acesso antecipado e fornecer feedback.
  1. Inicie sessão no Centro de administração do Power Platform.
  2. Selecione Gerir no painel de navegação.
  3. No painel Gerir, selecione Ambientes. Em seguida, selecione um ambiente.
  4. Selecione Configurações.
  5. Selecione Auditoria e logs>Definir política de retenção para exclusões de tarefas do sistema (Visualização).
  6. Marque a caixa de seleção Permitir que o serviço de exclusão exclua trabalhos do sistema.
  7. Selecione ou insira um período em dias para cada tipo de trabalho do sistema, incluindo trabalhos bem-sucedidos, trabalhos com falha e trabalhos cancelados.
  8. Selecione Guardar.

Nota

Este serviço de exclusão exclui os trabalhos do sistema. Os trabalhos excluídos do sistema não aparecem mais nas listas Todos os trabalhos do sistema ou Todos os trabalhos do sistema de exclusão em massa . Há um trabalho recorrente chamado Eliminar trabalhos de sistema concluídos. Este trabalho é suspenso quando o serviço de exclusão está ativado.

Tarefas de eliminação em massa

Importante

Este trabalho está em um estado suspenso quando o serviço de exclusão é usado.

Todos os ambientes estão configurados com uma tarefa de eliminação em massa de origem para eliminar tarefas de sistema de fluxo de trabalho concluídas com êxito com mais de 30 dias. Os clientes podem configurar outras tarefas de eliminação em massa para eliminar registos AsyncOperation. Recomendamos que configure uma tarefa para eliminar tarefas de sistema concluídas, independentemente do tipo ou resultado, com mais de 30 dias. Esta tarefa ajuda a evitar que a tabela AsyncOperation acumule registos em excesso.

Todos os ambientes incluem uma tarefa de eliminação em massa incorporada que remove trabalhos do sistema de fluxo de trabalho concluídos com êxito com mais de 30 dias. Os clientes podem criar mais tarefas de eliminação em massa para eliminar registos AsyncOperation. Recomendamos configurar uma tarefa que elimine qualquer tarefa de sistema concluída, independentemente do tipo ou resultado, com mais de 30 dias para evitar acúmulo desnecessário na tabela AsyncOperation.

Você pode usar os trabalhos do sistema de exclusão em massa para excluir registros desnecessários das tabelas AsyncOperation e WorkflowLog.

Ver as tarefas de sistema de eliminação em massa

Os trabalhos de exclusão de registro em massa mostram o histórico de trabalhos do sistema que foram executados e os resultados.

Nota

Este serviço de exclusão exclui os trabalhos do sistema e os trabalhos excluídos do sistema de exclusão em massa não aparecem mais nas listas Todos os trabalhos do sistema ou Todos os trabalhos do sistema de exclusão em massa .

  1. Inicie sessão no Centro de administração do Power Platform.
  2. No painel de navegação, selecione Gerenciar.
  3. No painel Gerir, selecione Ambientes.
  4. Na página Ambientes , selecione um ambiente.
  5. Na barra de comando, selecione Definições.
  6. Expanda Gestão de dados e selecione Eliminação em massa.

Na grelha Eliminação em Massa, pode utilizar o seletor de vistas para mostrar as tarefas de sistema de eliminação em massa concluídas, em curso, pendentes e recorrentes.

A vista Tarefas de Sistema de Eliminação em Massa Recorrentes mostra as definições das tarefas de origem para as tarefas de sistema de eliminação em massa recorrentes.

Quando abre um destes registos de tarefa de sistema, pode ver a consulta que a tarefa utiliza para identificar que registos eliminar e a agenda em que a tarefa é executada. Para estas tarefas de sistema de origem, não pode modificar a consulta utilizada pela tarefa de sistema, mas pode modificar a agenda em que a tarefa é executada.

Se mudar a vista para apresentar tarefas agendadas, em curso ou concluídas, pode cancelar, retomar ou adiar a tarefa usando as opções disponíveis no menu Ações quando vir o registo.

Criar as suas próprias tarefas de eliminação em massa

Se o serviço de Exclusão ou os trabalhos de exclusão em massa do sistema prontos para uso não atenderem às necessidades da sua organização, você poderá criar seu próprio trabalho de exclusão em massa.

Primeiro, desative o Serviço de Eliminação concluindo os passos a seguir.

  1. Adicione e edite o EnableSystemJobCleanup.
  2. Defina o EnableSystemJobCleanup como 'false'.

Na grelha Eliminação em massa, selecione Novo na barra de comandos para definir uma consulta para os registos que pretende eliminar. Utilize a funcionalidade de pré-visualização para rever os registos devolvidos pela consulta e verificar se captura o conjunto de dados pretendido.

Para limpar registos de fluxo de trabalho da tabela AsyncOperation, no menu pendente Procurar, selecione a tabela Tarefas do Sistema; no menu pendente Utilizar vista guardada, selecione [novo] para criar a sua própria consulta. Só pode eliminar fluxos de trabalho concluídos. Os fluxos de trabalho que estão a ser executados ou estão atualmente em curso não podem (e não devem ser) eliminados pela tarefa de sistema.

Adicione as seguintes condições à sua consulta:

  • Tipo de trabalho do sistema Igual a Fluxo de Trabalho (Opcional) - registros de fluxo de trabalho de destino.
  • Estado Igual a Concluído - apenas os fluxos de trabalho concluídos são válidos para conclusão.
  • [Opcional] Filtre na Razão do Estado É Igual a Com êxito/falhado/cancelado - válido para o estado concluído.
  • [Opcional] Filtre no campo Concluído Em para eliminar apenas fluxos de trabalho mais antigos.
  • [Opcional] Quaisquer outros filtros que pretenda aplicar.

Em seguida, define a frequência da tarefa de eliminação em massa para ser executado. Pode criar uma tarefa de eliminação em massa única ou definir uma agenda para permitir que a tarefa seja executado em intervalos definidos.

Tarefas de eliminação em massa baseadas em prioridades para operação assíncrona

Para desbloquear clientes com tamanho de operação assíncrono significativo, introduzimos uma funcionalidade de eliminação em massa baseada em prioridades para limpeza de operação assíncrona. Esta funcionalidade está disponível por predefinição para todas as organizações. Eis alguns pontos-chave ter em conta:

  • A prioridade de eliminação em massa aplica-se apenas a tarefas de eliminação em massa não recorrentes recém-criadas para a entidade AsyncOperation.
  • Para maximizar a eficácia desse recurso e otimizar o desempenho da tarefa, crie tarefas com condições de filtro variáveis, como diferentes intervalos de datas, tipos de tarefa do sistema, códigos de estado ou outros critérios.
  • As organizações podem definir até cinco tarefas prioritárias. Mais tarefas são criadas com prioridade predefinida.
  • Independentemente do número de tarefas para outras entidades na fila, uma tarefa AsyncOperation pode ser sempre criada com prioridade.
  • Não há nenhuma mudança em relação aos passos de criação para tarefas de eliminação em massa.

Registos de rastreio de plug-in

O plug-in pode ser usado para operações assíncronas. Um exemplo é criar uma tarefa após a criação da conta. Ao testar o plug-in, pode-se definir PluginTraceLogSetting como tudo ou exceções. Pode ver os registos de rastreio do plug-in na aplicação Power Platform Environment Settings.

Para automatizar a limpeza de registos de rastreio de plug-in, o Dataverse fornece uma tarefa recorrente que elimina registos com mais de um dia.

  • Este trabalho é executado todos os dias, garantindo que o sistema não mantenha registos de rastreamento de plug-in desnecessários indefinidamente.
  • O processo de exclusão ajuda a liberar espaço de armazenamento e mantém o sistema funcionando de forma eficiente.

Embora você possa excluir logs de rastreamento de plug-in diariamente, é recomendável não permitir essa opção em seu ambiente de produção, pois isso pode afetar o desempenho e o armazenamento do sistema. Em vez disso, certifique-se de que o PluginTraceLogSetting está definido como desativado para o ambiente de produção. Essa prática recomendada garante que a tabela de log de rastreamento de plug-in não cresça incontrolavelmente e faça com que o banco de dados atinja seu limite de capacidade.

Sessões de processamento para fluxos de trabalho de sincronização

A sessão de processo (sessão de diálogo) é criada quando um usuário executa ou executa um processo de diálogo. Ele contém os logs sobre a execução, como o usuário que a executou, a hora em que o processo foi iniciado e as ações executadas.

Para automatizar a limpeza de sessões de processo, o Dataverse fornece um trabalho recorrente que exclui registros com mais de um dia.

  • Esse trabalho é executado todos os dias, garantindo que o sistema não retenha sessões de processo desnecessárias indefinidamente.
  • O processo de exclusão ajuda a liberar espaço de armazenamento e mantém o sistema funcionando de forma eficiente.

Melhores práticas para conceber fluxos de trabalho

Depois de remover registos desnecessários das tabelas de fluxo de trabalho, considere refinar o design do fluxo de trabalho para ajudar a retardar o crescimento futuro da tabela

Para fluxos de trabalho assíncronos, recomendamos que ative Eliminar automaticamente as tarefas de fluxo de trabalho concluídas (para poupar espaço em disco) no editor do fluxo de trabalho. Esta definição permite que o sistema elimine automaticamente os registos de tarefas concluídas com êxito, economizando espaço de armazenamento. Os registos de execuções de fluxos de trabalho com falhas são sempre mantidos para efeitos de resolução de problemas.

Definir Retenção de Tarefas de Fluxo de Trabalho para eliminar automaticamente tarefas de fluxo de trabalho concluídas.

Para fluxos de trabalho síncronos, recomendamos que ative Manter registos para tarefas de fluxo de trabalho com erros no editor do fluxo de trabalho. Esta definição garante que os registos de execuções com falhas sejam mantidos para resolução de problemas, enquanto os registos de execuções bem-sucedidas são automaticamente eliminados para economizar espaço.

Definir Retenção de Registos de Fluxos de Trabalho para manter registos para tarefas de fluxo de trabalho com erros.

Utilização de capacidade do ficheiro AsyncOperation

Historicamente, todo o contexto de operação assíncrona era serializado diretamente na Propriedade de dados da tabela AsyncOperation, o que levava a um crescimento muito rápido em tamanho se houvesse registos de plug-in assíncronos em registos grandes (como anexos). Desde o início de 2021, a porção de dados de operações assíncronas foi movida para o armazenamento de ficheiros. Como resultado, o tamanho dos dados da operação assíncrona é parcialmente contabilizado em capacidade da base de dados e parcialmente em capacidade do ficheiro. Esta mudança ajuda a reduzir os custos - uma vez que a capacidade do ficheiro é cobrada a uma taxa inferior à da capacidade da base de dados - e melhora o desempenho geral, permitindo consultas mais eficientes à tabela AsyncOperation.

Nota

Os ficheiros relacionados com os registos AsyncOperation não podem ser eliminados diretamente. Para recuperar a capacidade do ficheiro, reveja as políticas de retenção e limpeza para registos AsyncOperation descritos neste artigo. Quando os registos AsyncOperation são eliminados, os seus ficheiros correspondentes também são eliminados.

Para mais informações sobre o modelo de armazenamento e relatórios do Dataverse, veja Nova capacidade de armazenamento do Microsoft Dataverse.

Conteúdo relacionado

Reduzir o armazenamento de bases de dados
Remover uma grande quantidade de dados específicos com a eliminação em massa
Microsoft Dataverse fluxos de trabalho em tempo real
Fluxos de trabalho em segundo plano do Dataverse clássico
Eliminar automaticamente as tarefas de fluxo de trabalho de fundo concluídas
Serviço assíncrono

  • Last updated on