Modificando ou gerando uma ID de correspondência para um fluxo de trabalho de correspondência baseado em regras - AWS Entity Resolution

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Modificando ou gerando uma ID de correspondência para um fluxo de trabalho de correspondência baseado em regras

Uma ID de correspondência é o identificador gerado AWS Entity Resolution e aplicado a cada conjunto de registros correspondente após a execução de um fluxo de trabalho correspondente. Isso faz parte dos metadados de fluxo de trabalho correspondentes incluídos na saída.

Quando precisar atualizar os registros de um cliente existente ou adicionar um novo cliente ao seu conjunto de dados, você pode usar o AWS Entity Resolution console ou a GenerateMatchID API. A modificação de uma ID de correspondência existente ajuda a manter a consistência ao atualizar as informações do cliente, enquanto a geração de uma nova ID de correspondência é necessária ao adicionar clientes não identificados anteriormente ao seu sistema.

nota

Cobranças adicionais se aplicam, independentemente de você usar o console ou a API. O tipo de processamento escolhido afeta a precisão e o tempo de resposta da operação.

Importante

Se você revogar AWS Entity Resolution as permissões do seu bucket do S3 enquanto um trabalho estiver em andamento, ainda AWS Entity Resolution processará e cobrará pela saída dos resultados para o S3, mas não poderá entregá-los ao seu bucket. Para evitar esse problema, verifique se ele AWS Entity Resolution tem as permissões corretas para gravar em seu bucket do S3 antes de iniciar um trabalho. Se as permissões forem revogadas durante o processamento, AWS Entity Resolution tentará reenviar os resultados por até 30 dias após a conclusão do trabalho depois de restaurar as permissões corretas do bucket.

O procedimento a seguir orienta você no processo de pesquisar ou gerar um ID de correspondência, selecionar um tipo de processamento e visualizar os resultados.

Console
Para modificar ou gerar um Match ID usando o console

  1. Faça login no AWS Management Console e abra o AWS Entity Resolution console em https://console.aws.amazon.com/entityresolution/.

  2. No painel de navegação esquerdo, em Fluxos de trabalho, escolha Correspondência.

  3. Escolha o fluxo de trabalho de correspondência baseado em regras que foi processado (o status do trabalho é Concluído).

  4. Na página de detalhes do fluxo de trabalho correspondente, escolha a IDs guia Corresponder.

  5. Escolha Modificar ou gerar ID de correspondência.

    nota

    A opção Modificar ou gerar ID de correspondência só está disponível para fluxos de trabalho correspondentes que usam a cadência de processamento automático. Se você tiver selecionado a cadência de processamento manual, essa opção aparecerá inativa. Para usar essa opção, edite seu fluxo de trabalho para usar a cadência de processamento automático. Para obter mais informações sobre a edição de fluxos de trabalho, consulteEditando um fluxo de trabalho correspondente.

  6. Selecione a AWS Glue tabela na lista suspensa.

    Se houver somente uma AWS Glue tabela no fluxo de trabalho, ela será selecionada por padrão.

  7. Escolha o tipo de processamento.

    • Consistente — Você pode pesquisar um ID de correspondência existente ou gerar e salvar um novo ID de correspondência imediatamente. Essa opção tem a maior precisão e o tempo de resposta mais lento.

    • Plano de fundo (mostrado EVENTUAL na API) — Você pode pesquisar um ID de correspondência existente ou gerar um novo ID de correspondência imediatamente. O registro atualizado é salvo em segundo plano. Essa opção tem uma resposta inicial rápida, com resultados completos disponíveis posteriormente no S3.

    • Geração rápida de ID (mostrada EVENTUAL_NO_LOOKUP na API) — Você pode criar uma nova ID de correspondência sem procurar uma existente. O registro atualizado é salvo em segundo plano. Essa opção tem a resposta mais rápida. É recomendado somente para registros exclusivos.

  8. Para atributos de registro,

    1. Insira o valor da ID exclusiva.

    2. Insira um valor para cada chave de correspondência que corresponderá aos registros existentes com base nas regras configuradas em seu fluxo de trabalho.

  9. Escolha Encontrar ID de correspondência e salve o registro.

    Uma mensagem de sucesso é exibida, informando que a ID de correspondência foi encontrada ou uma nova ID de correspondência foi gerada e o registro foi salvo.

  10. Veja a ID de correspondência correspondente e a regra associada que foi salva no fluxo de trabalho correspondente na mensagem de sucesso.

  11. (Opcional) Para copiar a ID de correspondência, escolha Copiar.

API
Para modificar ou gerar um Match ID usando a API
nota

Para chamar essa API com sucesso, você deve primeiro executar com êxito um fluxo de trabalho de correspondência baseado em regras usando a StartMatchingJob API.

Para obter uma lista completa das linguagens de programação suportadas, consulte a seção Consulte também do GenerateMatchID.

  1. Abra um terminal ou prompt de comando para fazer a solicitação da API.

  2. Crie uma solicitação POST para o seguinte endpoint: 

    /matchingworkflows/workflowName/generateMatches

  3. No cabeçalho da solicitação, defina o tipo de conteúdo como application/json.

  4. No URI da solicitação, especifique seuworkflowName.

    O workflowName imperativo:

    • Ter entre 1 e 255 caracteres

    • Combine o padrão [A-zA-z_0-9-] *

  5. Para o corpo da solicitação, forneça o seguinte JSON: 

    {
   "processingType": "string",
   "records": [ 
      { 
         "inputSourceARN": "string",
         "recordAttributeMap": { 
            "string" : "string" 
         },
         "uniqueId": "string"
      }
   ]
}

    Em que:

    • processingType(opcional) - O padrão é. CONSISTENT Escolha um desses valores:

      • CONSISTENT- Para maior precisão com tempo de resposta mais lento

      • EVENTUAL- Para uma resposta inicial mais rápida com processamento em segundo plano

      • EVENTUAL_NO_LOOKUP- Para uma resposta mais rápida quando se sabe que os registros são exclusivos

    • records(obrigatório) - Matriz contendo exatamente um objeto de registro

  6. Envie a solicitação .

    Se for bem-sucedido, você receberá uma resposta com o código de status 200 e um corpo JSON contendo:

    {
   "failedRecords": [ 
      { 
         "errorMessage": "string",
         "inputSourceARN": "string",
         "uniqueId": "string"
      }
   ],
   "matchGroups": [ 
      { 
         "matchId": "string",
         "matchRule": "string",
         "records": [ 
            { 
               "inputSourceARN": "string",
               "recordId": "string"
            }
         ]
      }
   ]
}

    Se a chamada não for bem-sucedida, você poderá receber um dos seguintes erros:

    • 403 - AccessDeniedException se você não tiver acesso suficiente

    • 404 - ResourceNotFoundException se o recurso não puder ser encontrado

    • 429 - ThrottlingException se a solicitação foi limitada

    • 400 - ValidationException se a entrada falhar na validação

    • 500 - InternalServerException se houver uma falha de serviço interno