Ingestão parcial por lote

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

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

Introdução

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

  • Ingestão em lote: O método que Platform O assimila e armazena dados de arquivos de dados, como CSV e Parquet.
  • Experience Data Model (XDM): O quadro normalizado pelo qual Platform organiza os dados de experiência do cliente.

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

Lendo exemplos de chamadas de API

Este guia fornece exemplos de chamadas de API para demonstrar como formatar suas solicitações do . Isso inclui caminhos, cabeçalhos necessários e cargas de solicitação formatadas corretamente. O JSON de exemplo 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 exemplos de chamadas de API no Experience Platform guia de solução de problemas.

Coletar valores para cabeçalhos necessários

Para fazer chamadas para Platform As APIs devem ser concluídas primeiro tutorial de autenticação. A conclusão do tutorial de autenticação fornece os valores para cada um dos cabeçalhos necessários em todos Experience Platform Chamadas de API, conforme mostrado abaixo:

  • Autorização: Portador {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}

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

  • x-sandbox-name: {SANDBOX_NAME}
OBSERVAÇÃO

Para obter mais informações sobre sandboxes em Platform, consulte o documentação de visão geral da sandbox.

Habilitar um lote para assimilação parcial de lote na API

OBSERVAÇÃO

Esta seção descreve como habilitar um lote para assimilação parcial de lote usando a API. Para obter instruções sobre como usar a interface do usuário, leia o habilitar um lote para assimilação parcial de lote na interface do usuário etapa.

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

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

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercent": 5
}
Propriedade Descrição
enableErrorDiagnostics Um sinalizador que permite Platform para gerar mensagens de erro detalhadas sobre seu lote.
partialIngestionPercent A porcentagem de erros aceitáveis antes que todo o lote falhe. Portanto, neste exemplo, um máximo de 5% do lote pode ser de erros, antes que falhe.

Habilitar um lote para assimilação parcial de lote na interface do usuário

OBSERVAÇÃO

Esta seção descreve como habilitar um lote para a assimilação em lote parcial usando a interface do usuário do . Se você já tiver ativado um lote para assimilação parcial de lote usando a API, poderá pular para a próxima seção.

Para permitir que um lote seja assimilado parcialmente 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 do "Mapear o fluxo CSV para XDM".

Criar uma nova conexão de origem

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 , tome nota da Ingestão parcial e Diagnóstico de erros campos.

O Ingestão parcial alternar permite ativar ou desativar o uso de assimilação de lote parcial.

O Diagnóstico de erros alternar só aparece quando a variável Ingestão parcial está desligado. Este recurso permite Platform para gerar mensagens de erro detalhadas sobre seus lotes assimilados. Se a variável Ingestão parcial estiver ativada, os diagnósticos de erro aprimorados serão aplicados automaticamente.

O Limite de erros permite definir 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

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.

O Ingestão parcial alternar permite ativar ou desativar o uso de assimilação de lote parcial.

O Diagnóstico de erros alternar só aparece quando a variável Ingestão parcial está desligado. Este recurso permite Platform para gerar mensagens de erro detalhadas sobre seus lotes assimilados. Se a variável Ingestão parcial estiver ativada, os diagnósticos de erro aprimorados serão aplicados automaticamente.

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

Agora, você pode fazer upload de dados usando o Adicionar dados e será assimilado usando a ingestão parcial.

Use o "Mapear CSV para esquema XDM" fluxo

Para usar o "Mapear CSV para esquema XDM", siga as etapas listadas na Tutorial de mapeamento de um arquivo CSV. Depois de alcançar o Adicionar dados , tome nota da Ingestão parcial e Diagnóstico de erros campos.

O Ingestão parcial alternar permite ativar ou desativar o uso de assimilação de lote parcial.

O Diagnóstico de erros alternar só aparece quando a variável Ingestão parcial está desligado. Este recurso permite Platform para gerar mensagens de erro detalhadas sobre seus lotes assimilados. Se a variável Ingestão parcial estiver ativada, os diagnósticos de erro aprimorados serão aplicados automaticamente.

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

Próximas etapas

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

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

Nesta página