Monitorar o status e a disponibilidade de entidades

12 minutos

Uma entidade de dados é uma combinação de uma ou várias tabelas relacionadas entre si e facilita a abstração de uma comunicação interna entre essas tabelas. As entidades de dados desempenham um papel importante no processo de integração. Você pode executar uma integração síncrona por meio de pontos de extremidade OData usando uma entidade de dados.

A Estrutura de gerenciamento de dados pode executar a transferência de dados assíncrona usando uma entidade de dados. Monitore o status de execução, disponibilidade e desempenho de uma entidade de dados enquanto uma grande quantidade de dados está sendo transmitida no processo de integração.

Chave de configuração

A disponibilidade de uma entidade de dados depende da chave de configuração atribuída aos seguintes artefatos:

Entidade de dados
Tabela usada na entidade de dados
Campos de tabela
Campos de entidade de dados

Os seguintes cenários ilustram o status da disponibilidade baseada na configuração da entidade de dados:

Se o status da chave de configuração estiver desabilitado na entidade de dados, a entidade de dados não estará disponível para nenhuma finalidade. O valor da chave de configuração em outros artefatos não importa.
Se a chave de configuração da entidade de dados estiver habilitada e a chave de configuração da tabela primária da entidade de dados estiver desabilitada, a entidade de dados não estará disponível para nenhuma finalidade.
Se a chave de configuração da entidade de dados estiver habilitada e a chave de configuração de qualquer tabela secundária da entidade de dados estiver desabilitada, essa tabela e todas as suas tabelas secundárias não estarão disponíveis na entidade de dados. No entanto, a entidade de dados geral estará disponível para uso.
Se a chave de configuração da entidade de dados e a tabela estiverem habilitadas, mas alguns campos da entidade de dados ou da tabela estiverem desabilitados, esses campos não estarão disponíveis na entidade de dados. No entanto, a entidade de dados geral estará disponível para uso.

Atualização da lista de entidades

Você pode exibir a lista de entidades no bloco Entidade de dados do espaço de trabalho Gerenciamento de dados. Quando você atualiza a lista de entidades de dados, o sistema recria os metadados da chave de configuração para que fiquem atualizados. Recomendamos que você aguarde a conclusão da atualização da lista de entidades antes de usar trabalhos e entidades na estrutura de gerenciamento de dados. Caso contrário, os metadados da chave de configuração poderão não estar atualizados e poderão resultar em resultados inesperados.

Ao alterar a chave de configuração, você deve atualizar a lista de entidades. Até que a lista de entidades seja atualizada, será exibida uma mensagem de aviso informando que A lista de entidades deve ser atualizada por meio do formulário de parâmetros da estrutura para buscar informações de chave de configuração para as entidades de dados. Valide os projetos e trabalhos de dados existentes para garantir que funcionem conforme o esperado depois que as alterações da chave de configuração estiverem em vigor.

Processamento paralelo

Você pode acelerar a importação de dados que usam entidades de dados habilitando o processamento paralelo de importação de um arquivo, se a entidade der suporte a importações paralelas. Nos Parâmetros da estrutura do espaço de trabalho Gerenciamento de dados, abra Configurar parâmetros de execução da entidade na guia Configurações da entidade. Selecione a entidade que requer processamento paralelo para melhor desempenho. No campo Contagem de registros de limite de importação, insira a contagem de registros de limite para importação que determinará a contagem de registros a ser processada por um thread. No campo Contagem de tarefas de importação, insira a contagem de tarefas de importação, que não pode exceder o número máximo de threads de lote alocados para processamento em lote na configuração do servidor do módulo Administração do sistema.

Limpeza do histórico de trabalho

Use a funcionalidade de limpeza do histórico de trabalho no Gerenciamento de dados para agendar uma limpeza periódica do histórico de execução. Essa funcionalidade substitui a funcionalidade anterior de limpeza da tabela de preparo, que foi preterida.

Você pode usar os trabalhos em lotes do sistema para limpar o histórico. O uso de trabalhos em lote do sistema permite que os aplicativos de finanças e operações tenham o trabalho em lote de limpeza agendado e executado automaticamente quando o sistema estiver pronto. O agendamento manual do trabalho em lotes não é necessário.

O trabalho de limpeza arquivará os registros excluídos no armazenamento de blobs que a estrutura de gerenciamento de dados usa para integrações regulares. O arquivo morto estará no formato de pacote da Estrutura de gerenciamento de dados e ficará disponível por sete dias no blob, período durante o qual você poderá baixá-lo.

Monitorar o status de execução

A execução de um trabalho de importação ou exportação de dados normalmente inclui um status de execução para o trabalho. Um trabalho de importação/exportação de dados pode ter o status a seguir no campo Status de execução.

Não executado: o valor inicial quando o trabalho de dados é criado.
Em execução: o status quando o trabalho está em execução.
Bem-sucedido: indicação de que o trabalho foi executado com êxito.
Falha: indicação de que ocorreu um erro. Se você receber esse status, examine Exibir log de execução para determinar por que a tarefa apresenta um erro. Você também pode abrir o Infolog para obter mais informações e examinar Exibir dados de preparo, que fornece uma lista completa de problemas.