Assimilação parcial de lote

A assimilação parcial de lotes é a capacidade de assimilar dados que contêm erros até um determinado limite. Com esse recurso, os usuários podem assimilar todos os dados corretos na Adobe Experience Platform com sucesso, enquanto todos os dados incorretos são armazenados em lote separadamente, juntamente com detalhes sobre o motivo da invalidade.

Este documento fornece um tutorial para gerenciar a assimilação parcial de lotes.

Introdução

Este tutorial requer um conhecimento prático dos vários serviços da Adobe Experience Platform envolvidos com a assimilação parcial de lotes. Antes de iniciar este tutorial, revise a documentação dos seguintes serviços:

As seções a seguir fornecem informações adicionais que você precisará saber para fazer chamadas com êxito para o Platform APIs.

Leitura de chamadas de API de amostra

Este guia fornece exemplos de chamadas de API para demonstrar como formatar suas solicitações. Isso inclui caminhos, cabeçalhos necessários e cargas de solicitação formatadas corretamente. O exemplo de JSON retornado nas respostas da API também é fornecido. Para obter informações sobre as convenções usadas na documentação para chamadas de API de exemplo, consulte a seção sobre como ler chamadas de API de exemplo no Experience Platform guia de solução de problemas.

Coletar valores para cabeçalhos obrigatórios

Para fazer chamadas para Platform APIs, primeiro conclua o tutorial de autenticação. Concluir o tutorial de autenticação fornece os valores para cada um dos cabeçalhos necessários em todos os Experience Platform Chamadas de API, conforme mostrado abaixo:

Todos os recursos em Experience Platform são isolados em sandboxes virtuais específicas. Todas as solicitações para Platform As APIs exigem um cabeçalho que especifique o nome da sandbox em que a operação ocorrerá:

Ativar um lote para assimilação parcial de lotes na API enable-api

Você pode criar um novo lote com a assimilação parcial ativada.

Para criar um novo lote, siga as etapas da seção guia do desenvolvedor de assimilação em lote. Depois de alcançar o Criar lote adicione o seguinte campo no corpo da solicitação:

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercent": 5
}

Ativar um lote para assimilação parcial de lotes na interface do usuário enable-ui

Para ativar um lote para assimilação parcial por meio da Platform Na interface do usuário, você pode criar um novo lote por meio de conexões de origem, criar um novo lote em um conjunto de dados existente ou criar um novo lote por meio da "Mapear CSV para fluxo XDM".

Criar uma nova conexão de origem new-source

Para criar uma nova conexão de origem, siga as etapas listadas no Visão geral das fontes. Depois de alcançar o Detalhes do fluxo de dados etapa, tome nota da Assimilação parcial e Diagnóstico de erro campos.

A variável Assimilação parcial ativar/desativar permite ativar ou desativar o uso de assimilação parcial de lotes.

A variável Diagnóstico de erro alternar só aparece quando a variável Assimilação parcial está desativado. Esse recurso permite Platform para gerar mensagens de erro detalhadas sobre os lotes assimilados. Se a variável Assimilação parcial for ativada, os diagnósticos de erro aprimorados serão aplicados automaticamente.

A variável Limite de erro permite que você defina a porcentagem de erros aceitáveis antes que todo o lote falhe. Por padrão, esse valor é definido como 5%.

Usar um conjunto de dados existente existing-dataset

Para usar um conjunto de dados existente, comece selecionando um conjunto de dados. A barra lateral à direita é preenchida com informações sobre o conjunto de dados.

A variável Assimilação parcial ativar/desativar permite ativar ou desativar o uso de assimilação parcial de lotes.

A variável Diagnóstico de erro alternar só aparece quando a variável Assimilação parcial está desativado. Esse recurso permite Platform para gerar mensagens de erro detalhadas sobre os lotes assimilados. Se a variável Assimilação parcial for ativada, os diagnósticos de erro aprimorados serão aplicados automaticamente.

A variável Limite de erro permite que você defina a porcentagem de erros aceitáveis antes que todo o lote falhe. Por padrão, esse valor é definido como 5%.

Agora, é possível fazer upload de dados usando o Adicionar dados e será assimilado usando a assimilação parcial.

Use o "Mapear CSV para esquema XDMFluxo " map-flow

Para usar o "Mapear CSV para esquema XDM", siga as etapas listadas no Mapear um tutorial de arquivo CSV. Depois de alcançar o Adicionar dados etapa, tome nota da Assimilação parcial e Diagnóstico de erro campos.

A variável Assimilação parcial ativar/desativar permite ativar ou desativar o uso de assimilação parcial de lotes.

A variável Diagnóstico de erro alternar só aparece quando a variável Assimilação parcial está desativado. Esse recurso permite Platform para gerar mensagens de erro detalhadas sobre os lotes assimilados. Se a variável Assimilação parcial for ativada, os diagnósticos de erro aprimorados serão aplicados automaticamente.

Limite de erro permite que você defina a porcentagem de erros aceitáveis antes que todo o lote falhe. Por padrão, esse valor é definido como 5%.

Próximas etapas next-steps

Este tutorial abordou como criar ou modificar um conjunto de dados para permitir a assimilação parcial de lotes. Para obter mais informações sobre assimilação em lote, leia a guia do desenvolvedor de assimilação em lote.

Para obter informações sobre o monitoramento de erros de assimilação parcial, leia o guia de diagnóstico de erro de assimilação em lote.