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
<a name="generate-match-id"></a>

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 Console de gerenciamento da AWS e abra o AWS Entity Resolution console em [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/).

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

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

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

1. 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, consulte[Editando um fluxo de trabalho correspondente](edit-matching-workflow.md).

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

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

1. Para **atributos de registro**, 

   1. Insira o **valor** da **ID exclusiva**.

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

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

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

1. (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.](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_StartMatchingJob.html)   
Para obter uma lista completa das linguagens de programação suportadas, [consulte a seção Consulte também](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GenerateMatchId.html#API_GenerateMatchId_SeeAlso) do [GenerateMatchID](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GenerateMatchId.html).

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

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

   ```
   /matchingworkflows/workflowName/generateMatches
   ```

1. No cabeçalho da solicitação, Content-type defina application/json o. 

1. No URI da solicitação, especifique seu`workflowName`. 

   O `workflowName` imperativo: 
   + Ter entre 1 e 255 caracteres 
   + Combine o padrão [a-z A-Z \_0-9-] \*

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

1. 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 de serviço interno

------