View a markdown version of this page

Modificar ou gerar um 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á.

Modificar ou gerar um ID de correspondência para um fluxo de trabalho de correspondência baseado em regras

Um 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 do fluxo de trabalho correspondente 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. Modificar um ID de correspondência existente ajuda a manter a consistência ao atualizar as informações do cliente. É necessário gerar um novo ID de correspondência quando você adiciona clientes anteriormente não identificados ao seu sistema.

nota

Taxas 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.

Real-time requisitos correspondentes

Para chamar a GenerateMatchId API em um fluxo de trabalho de correspondência baseado em regras avançadas, enableRealTimeMatching defina como. true Para fluxos de trabalho de correspondência simples, a correspondência em tempo real está sempre disponível e você não precisa definir esse sinalizador.

Você não pode ativar a correspondência em tempo real em fluxos de trabalho que usam qualquer um dos seguintes:

  • Atributos difusos:Cosine,, ou Soundex Levenshtein

  • EmptyValues=Ignore

Se enableRealTimeMatching estiver definido comotrue, o fluxo de trabalho não poderá ser usado com a StartMatchingJob API para executar trabalhos de fluxo de trabalho.

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á entregar os resultados 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 Match ID, 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 Console de gerenciamento da AWS 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 guia Match IDs.

  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ê selecionou 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 edição de fluxos de trabalho, consulteEditando um fluxo de trabalho correspondente.

  6. Selecione a AWS Glue tabela na lista suspensa.

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

  7. Escolha o tipo de processamento.

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

    • Plano de fundo (mostrado como 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 Localizar ID de correspondência e salvar registro.

    Uma mensagem de sucesso aparece, informando que o Match ID foi encontrado ou um novo Match ID foi gerado e o registro foi salvo.

  10. Visualize o 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 o ID da partida, escolha Copiar.

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

Para chamar essa API com sucesso, primeiro você deve 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, Content-type defina como application/json.

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

    O workflowName imperativo:

    • Tenha entre 1 e 255 caracteres

    • Combine o padrão [a-z A-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 destes 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 interna no serviço