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á.
# Combinar dados de entrada usando um fluxo de trabalho de correspondência
Um *fluxo de trabalho de correspondência* é um trabalho de processamento de dados que combina e compara dados de diferentes fontes de entrada e determina quais registros correspondem com base em diferentes técnicas de correspondência. AWS Entity Resolution lê seus dados dos locais especificados, encontra correspondências entre registros e atribui uma [ID de correspondência](glossary.md#match-id-defin) a cada conjunto de dados correspondente.
O diagrama a seguir resume como criar um fluxo de trabalho correspondente.
![\[A summary of the four steps to create a matching workflow in AWS Entity Resolution\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/HIW-Matching-Workflow.png)
**Topics**
+ [Tipos de fluxo de trabalho correspondentes](#matching-workflow-types)
+ [Opções de saída de dados](#data-output-options)
+ [Resultados de fluxo de trabalho correspondentes](#matching-workflow-results)
+ [Criação de um fluxo de trabalho de correspondência baseado em regras](creating-matching-workflow-rule-based.md)
+ [Criação de um fluxo de trabalho de correspondência baseado em aprendizado de máquina](create-matching-workflow-ml.md)
+ [Criação de um fluxo de trabalho de correspondência baseado em serviços do provedor](create-matching-workflow-provider.md)
+ [Editando um fluxo de trabalho correspondente](edit-matching-workflow.md)
+ [Excluindo um fluxo de trabalho correspondente](delete-matching-workflow.md)
+ [Modificar ou gerar uma ID de correspondência para um fluxo de trabalho de correspondência baseado em regras](generate-match-id.md)
+ [Procurando um ID de correspondência para um fluxo de trabalho de correspondência baseado em regras](find-match-id.md)
+ [Excluindo registros de um fluxo de trabalho de correspondência baseado em regras ou em ML](delete-records.md)
+ [Solução de problemas de fluxos de trabalho correspondentes](troubleshooting.md)
## Tipos de fluxo de trabalho correspondentes
AWS Entity Resolution oferece suporte a três tipos de fluxos de trabalho correspondentes:
Correspondência baseada em regras
Usa regras configuráveis para identificar registros correspondentes com base na correspondência exata ou difusa dos campos especificados. Você define os critérios de correspondência, como nomes correspondentes com grafia semelhante ou endereços com formatação diferente.
Correspondência baseada em machine learning
Usa modelos de aprendizado de máquina para identificar registros semelhantes, mesmo quando os dados têm variações, erros ou campos ausentes. Essa abordagem pode detectar correspondências mais complexas do que a correspondência baseada em regras.
Correspondência baseada em serviços de provedores
Usa provedores de dados terceirizados para enriquecer e validar seus dados antes da correspondência. Esse tipo de correspondência não é compatível com a saída do Amazon Connect Customer Profiles.
## Opções de saída de dados
AWS Entity Resolution pode gravar arquivos de saída de dados em:
+ Um local do Amazon S3 que você especifica
+ Perfis de clientes do Amazon Connect (para desduplicação de dados de clientes)
**Importante**
A exportação para perfis de clientes do Amazon Connect não é compatível com a correspondência baseada no provedor. Para exportar para os perfis de clientes do Amazon Connect, você deve usar a correspondência baseada em regras ou a correspondência baseada em aprendizado de máquina.
Você pode usar AWS Entity Resolution para fazer o hash dos dados de saída, se desejar, ajudando você a manter o controle sobre seus dados.
A tabela a seguir mostra os três tipos de fluxos de trabalho correspondentes e seus destinos de saída compatíveis.
| Tipo de correspondência | saída do S3 | Saída de perfis de clientes |
| --- | --- | --- |
| [baseado em regras](creating-matching-workflow-rule-based.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/success_icon.svg) Yes (Sim) |
| [baseado em aprendizado de máquina](create-matching-workflow-ml.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/success_icon.svg) Yes (Sim) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/success_icon.svg) Yes (Sim) |
| [baseado em serviços de provedores](create-matching-workflow-provider.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/success_icon.svg) Sim | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/negative_icon.svg)Não |
## Resultados de fluxo de trabalho correspondentes
Depois de criar e executar um fluxo de trabalho correspondente, você pode visualizar os resultados na sua localização específica do S3 ou nos perfis de clientes do Amazon Connect. Os fluxos de trabalho correspondentes são gerados IDs após a indexação dos dados.
Um fluxo de trabalho correspondente pode ter várias execuções e os resultados (acertos ou erros) são gravados em uma pasta com o `jobId` como nome.
Para cada execução para destinos de saída do S3:
+ A saída de dados contém um arquivo para correspondências bem-sucedidas e um arquivo para erros.
+ Os resultados bem-sucedidos são gravados em uma `success` pasta contendo vários arquivos
+ Os erros são gravados em uma `error` pasta com vários campos
Para cada execução do Amazon Connect Customer Profiles, destinos de saída:
+ Os registros de clientes desduplicados são enviados diretamente para sua instância do Amazon Connect
+ Você pode ver seu histórico de trabalho recente no AWS Entity Resolution console
+ Os perfis existentes no Amazon Connect não estão incluídos no processo de desduplicação
Depois de criar e executar um fluxo de trabalho correspondente, você pode usar a saída da [correspondência baseada em regras ou da correspondência](creating-matching-workflow-rule-based.md) de [aprendizado de máquina (ML) como uma entrada para a correspondência](create-matching-workflow-ml.md) [baseada em serviços do provedor](create-matching-workflow-provider.md) ou vice-versa para atender às suas necessidades comerciais.
Por exemplo, para economizar nos custos de assinatura do provedor, você pode primeiro executar a [correspondência baseada em regras](creating-matching-workflow-rule-based.md) para encontrar correspondências em seus dados. Em seguida, você pode enviar um subconjunto de registros incomparáveis para a correspondência baseada em serviços do [provedor](create-matching-workflow-provider.md). Observe que, se você planeja exportar para perfis de clientes, deve usar somente a correspondência baseada em regras ou em aprendizado de máquina.
Para obter mais informações sobre a solução de problemas de erros, consulte[Solução de problemas de fluxos de trabalho correspondentes](troubleshooting.md).
# Criação de um fluxo de trabalho de correspondência baseado em regras
A *[correspondência baseada em regras](glossary.md#rule-based-matching-defn)* é um conjunto hierárquico de regras de correspondência em cascata, sugerido por AWS Entity Resolution, com base nos dados que você insere e é totalmente configurável por você. O fluxo de trabalho de correspondência baseado em regras permite comparar texto não criptografado ou dados com hash para encontrar correspondências exatas com base nos critérios que você personaliza.
Quando AWS Entity Resolution encontra uma correspondência entre dois ou mais registros em seus dados, ele atribui:
+ Um [ID de correspondência](glossary.md#match-id-defin) para os registros no conjunto de dados correspondente
+ A [regra de correspondência](glossary.md#match-rule-defn) que gerou a partida.
Ao criar um fluxo de trabalho de correspondência baseado em regras no AWS Entity Resolution, você deve escolher um tipo de regra **simples** ou **avançado**. O tipo de regra determina a complexidade das condições de regra que você pode criar. Você não pode alterar o tipo de regra depois de criar o fluxo de trabalho.
Você pode usar a tabela a seguir para comparar os dois **tipos de regras** e determinar qual delas se adequa ao seu caso de uso.
**Gráfico de comparação de tipos de regras**
| Caso de uso | Tipo de regra avançada | Tipo de regra simples |
| --- |--- |--- |
| Mapeamentos de esquema mapeados com tipos de entrada one-to-one | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/success_icon.svg) Sim | Não |
| --- |--- |--- |
| Mapeamento de esquema com várias colunas de dados mapeadas para os mesmos tipos de entrada | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/negative_icon.svg) Não | Sim |
| --- |--- |--- |
| Suporta correspondência exata e difusa | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/success_icon.svg) Sim | Não (somente correspondência exata) |
| --- |--- |--- |
| Suporta operadores AND, OR e parênteses | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/success_icon.svg) Sim | Não (somente operador AND) |
| --- |--- |--- |
| Suporta fluxos de trabalho em lote | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/success_icon.svg) Sim | Sim |
| --- |--- |--- |
| Oferece suporte a fluxos de trabalho incrementais | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/success_icon.svg) Sim | Sim |
| --- |--- |--- |
| Suporta fluxos de trabalho em tempo real | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/negative_icon.svg)Não | Sim |
| --- |--- |--- |
| Suporta fluxos de trabalho de mapeamento de ID | ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/negative_icon.svg) Não | Sim |
| --- |--- |--- |
Depois de determinar qual tipo de regra você deseja usar, use os tópicos a seguir para criar um fluxo de trabalho de correspondência baseado em regras com o tipo de regra **Avançado** ou **Simples**.
**Topics**
+ [Criação de um fluxo de trabalho de correspondência baseado em regras com o tipo de regra Avançado](rule-based-mw-advanced.md)
+ [Criação de um fluxo de trabalho de correspondência baseado em regras com o tipo de regra simples](rule-based-mw-simple.md)
# Criação de um fluxo de trabalho de correspondência baseado em regras com o tipo de regra Avançado
**Pré-requisitos**
Antes de criar um fluxo de trabalho de correspondência baseado em regras, você deve:
1. Crie um mapeamento de esquema. Para obter mais informações, consulte [Criação de um mapeamento de esquema](create-schema-mapping.md).
1. Se estiver usando o Amazon Connect Customer Profiles como seu destino de saída, certifique-se de ter as permissões apropriadas configuradas.
O procedimento a seguir demonstra como criar um fluxo de trabalho de correspondência baseado em regras com o tipo de regra **Avançado** usando o AWS Entity Resolution console ou a API. `CreateMatchingWorkflow`
------
#### [ Console ]
**Para criar um fluxo de trabalho de correspondência baseado em regras com o tipo de regra **Avançado** 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. Na página **Fluxos de trabalho correspondentes**, no canto superior direito, escolha **Criar fluxo de trabalho correspondente**.
1. Para a **Etapa 1: Especificar os detalhes correspondentes do fluxo** de trabalho, faça o seguinte:
1. Insira um **nome de fluxo de trabalho correspondente** e uma **Descrição** opcional.
1. Em **Entrada de dados**, escolha um **AWS Glue banco de dados **Região da AWS****, a **AWS Glue tabela** e, em seguida, o **mapeamento do esquema** correspondente.
Você pode adicionar até 19 entradas de dados.
**nota**
Para usar regras **avançadas**, seus mapeamentos de esquema devem atender aos seguintes requisitos:
Cada campo de entrada deve ser mapeado para uma chave de correspondência exclusiva, a menos que os campos estejam agrupados.
Se os campos de entrada estiverem agrupados, eles poderão compartilhar a mesma chave de correspondência.
Por exemplo, o mapeamento de esquema a seguir seria válido para regras **avançadas**:
`firstName: { matchKey: 'name', groupName: 'name' }`
`lastName: { matchKey: 'name', groupName: 'name' }`
Nesse caso, os `lastName` campos `firstName` e são agrupados e compartilham a mesma chave de correspondência de nome, o que é permitido.
**Revise seus mapeamentos de esquema e atualize-os para seguir essa regra de one-to-one correspondência, a menos que os campos estejam agrupados corretamente, para usar as regras avançadas.**
Se sua tabela de dados tiver uma coluna DELETE, o tipo do mapeamento do esquema deve ser `String` e você não pode ter um `matchKey` e. `groupName`
1. A opção **Normalizar dados** é selecionada por padrão, para que as entradas de dados sejam normalizadas antes da correspondência. Se você não quiser normalizar os dados, desmarque a opção **Normalizar** dados.
**nota**
A normalização só é suportada nos seguintes cenários em **Criar mapeamento de esquema**:
Se os seguintes subtipos de **nome** estiverem agrupados: **Nome**, **segundo nome**, **sobrenome**.
Se os seguintes subtipos de **endereço** estiverem agrupados: **Endereço 1**, **Endereço 2**, **Endereço 3**, **Cidade**, **Estado**, **País**, **Código postal**.
Se os seguintes subtipos de **telefone** estiverem agrupados: **Número de telefone**, Código do **país do telefone**.
1. Para especificar as permissões **de acesso ao serviço**, escolha uma opção e execute a ação recomendada.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/rule-based-mw-advanced.html)
1. (Opcional) Para ativar **tags** para o recurso, escolha **Adicionar nova tag** e insira o par de **chave** e **valor**.
1. Escolha **Próximo**.
1. Para a **Etapa 2: Escolha a técnica de correspondência**:
1. Em **Método de correspondência**, escolha **Correspondência baseada em regras**.
1. **Em Tipo de regra**, escolha **Avançado**.
![\[Escolha a tela de técnica de correspondência com a opção de correspondência avançada baseada em regras selecionada.\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/choose-matching-method-rule-based-advanced.PNG)
1. Em **Cadência de processamento**, selecione uma das opções a seguir.
+ Escolha **Manual** para executar um fluxo de trabalho sob demanda para uma atualização em massa
+ Escolha **Automático** para executar um fluxo de trabalho assim que novos dados estiverem em seu bucket do S3
**nota**
Se você escolher **Automático**, certifique-se de ter EventBridge as notificações da Amazon ativadas para seu bucket do S3. Para obter instruções sobre como habilitar a Amazon EventBridge usando o console do S3, consulte [Habilitando a Amazon EventBridge](https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-event-notifications-eventbridge.html) no Guia do *usuário do Amazon S3*.
1. Em **Regras de correspondência**, insira um **nome de regra** e, em seguida, crie a **condição da regra** escolhendo as funções e operadores de correspondência apropriados na lista suspensa com base em sua meta.
Você pode criar até 25 regras.
****Você deve combinar uma função de correspondência difusa (**Cosine**, **Levenshtein** ou **Soundex**) com uma função de correspondência exata (Exact,) usando o operador AND. **ExactManyToMany******
Você pode usar a tabela a seguir para ajudar a decidir que tipo de função ou operador deseja usar, dependendo da sua meta.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/rule-based-mw-advanced.html)
**Example Condição de regra que corresponde aos números de telefone e e-mail**
Veja a seguir um exemplo de uma condição de regra que corresponde a registros em números de telefone (chave de correspondência de **telefone**) e endereços de **e-mail (chave de correspondência de endereço** de e-mail):
`Exact(Phone,EmptyValues=Process) AND Levenshtein("Email address",2)`
![\[Exemplo de uma condição de regra que corresponde a registros em números de telefone e endereços de e-mail.\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/matching-rule-condition-example.png)
A tecla **Phone** match usa a função de correspondência **exata** para combinar sequências idênticas. A tecla **Phone** match processa valores vazios na correspondência usando o modificador **EmptyValues=Process**.
A chave de correspondência de **endereço de e-mail** usa a função de correspondência **Levenshtein** para combinar dados com erros ortográficos usando o limite padrão do algoritmo de distância Levenshtein de 2. A tecla de correspondência de **e-mail** não usa nenhum modificador opcional.
O operador **AND** combina a função de correspondência **exata** e a função de correspondência **Levenshtein**.
**Example Condição de regra usada ExactManyToMany para realizar a correspondência de teclas de correspondência**
Veja a seguir um exemplo de uma condição de regra que combina registros em três campos de endereço (**HomeAddress**chave de **BillingAddress**correspondência, chave de **ShippingAddress**correspondência e chave de correspondência) para encontrar possíveis correspondências verificando se alguma delas tem valores idênticos.
O `ExactManyToMany` operador avalia todas as combinações possíveis dos campos de endereço especificados para identificar correspondências exatas entre dois ou mais endereços. Por exemplo, ele detectaria se os endereços `HomeAddress` correspondem a `BillingAddress` ou `ShippingAddress` ou se todos os três endereços correspondem exatamente.
```
ExactManyToMany(HomeAddress, BillingAddress, ShippingAddress)
```
**Example Condição de regra que usa agrupamento**
Na correspondência avançada baseada em regras com condições difusas, o sistema primeiro agrupa os registros em clusters com base nas correspondências exatas. Depois que esses clusters iniciais são formados, o sistema aplica filtros de correspondência difusa para identificar correspondências adicionais em cada cluster. Para um desempenho ideal, você deve selecionar condições de correspondência exatas com base em seus padrões de dados para criar clusters iniciais bem definidos.
Veja a seguir um exemplo de uma condição de regra que combina várias correspondências exatas com um requisito de correspondência difusa. Ele usa `AND` operadores para verificar se três campos —`FullName`, Data de nascimento (`DOB`) e `Address` — coincidem exatamente entre os registros. Também permite pequenas variações no `InternalID` campo usando uma distância de Levenshtein de. `1` A distância de Levenshtein mede o número mínimo de edições de um único caractere necessárias para transformar uma string em outra. Uma distância de 1 significa `InternalIDs` que ela corresponderá à diferença em apenas um caractere (como um único erro de digitação, exclusão ou inserção). Essa combinação de condições ajuda a identificar registros que provavelmente representarão a mesma entidade, mesmo que haja pequenas discrepâncias no identificador.
```
Exact(FullName) AND Exact(DOB) AND Exact(Address) and Levenshtein(InternalID, 1)
```
1. Escolha **Próximo**.
1. Para a **Etapa 3: Especifique a saída e o formato dos dados**:
1. **Em **Destino e formato de saída de dados**, escolha a **localização do Amazon S3** para a saída de dados e se o **formato dos dados** será dados **normalizados ou dados originais**.**
1. Em **Criptografia**, se você optar por **Personalizar as configurações de criptografia**, insira o ARN da **AWS KMS chave**.
1. Visualize a **saída gerada pelo sistema**.
1. Para **Saída de dados**, decida quais campos você deseja incluir, ocultar ou mascarar e, em seguida, execute as ações recomendadas com base em suas metas.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/rule-based-mw-advanced.html)
1. Escolha **Próximo**.
1. Para a **Etapa 4: Revise e crie**:
1. Revise as seleções feitas nas etapas anteriores e edite, se necessário.
1. Escolha **Criar e executar**.
Uma mensagem aparece indicando que o fluxo de trabalho correspondente foi criado e que o trabalho foi iniciado.
1. Na página de detalhes do fluxo de trabalho correspondente, na guia **Métricas**, veja o seguinte em **Métricas do último trabalho**:
+ O **Job ID**.
+ **O **status** da tarefa de fluxo de trabalho correspondente: Em **fila**, **em andamento**, **concluída**, com falha**
+ O **tempo concluído** para o trabalho do fluxo de trabalho.
+ O número de **registros processados**.
+ O número de **registros não processados**.
+ A **partida única IDs gerada**.
+ O número de **registros de entrada**.
Você também pode visualizar as métricas de trabalho para trabalhos de fluxo de trabalho correspondentes que foram executados anteriormente no **Histórico de trabalhos**.
1. Após a conclusão do trabalho de fluxo de trabalho correspondente (o **status** é **concluído**), você pode acessar a guia **Saída de dados** e selecionar sua localização no **Amazon S3** para visualizar os resultados.
1. (Somente tipo de processamento **manual**) Se você criou um fluxo de trabalho **correspondente baseado em regras** com o tipo de processamento **Manual**, você pode executar o fluxo de trabalho correspondente a qualquer momento escolhendo **Executar fluxo de trabalho na página de detalhes do fluxo de trabalho** correspondente.
1. (Somente tipo de processamento **automático**) Se sua tabela de dados tiver uma coluna DELETE, então:
+ Os registros definidos *true* na coluna DELETE são excluídos.
+ Os registros definidos *false* na coluna DELETE são ingeridos no S3.
Para obter mais informações, consulte [Etapa 1: Preparar tabelas de dados primárias](prepare-input-data.md#prepare-first-party-tables).
------
#### [ API ]
**Para criar um fluxo de trabalho de correspondência baseado em regras com o tipo de regra **Avançado** usando a API**
**nota**
Por padrão, o fluxo de trabalho usa processamento padrão (em lote). Para usar o processamento incremental (automático), você deve configurá-lo explicitamente.
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
```
1. No cabeçalho da solicitação, defina o tipo de conteúdo como application/json.
**nota**
Para obter uma lista completa das linguagens de programação compatíveis, consulte a *[Referência AWS Entity Resolution da API](https://docs.aws.amazon.com/entityresolution/latest/apireference/Welcome.html)*.
1. Para o corpo da solicitação, forneça os seguintes parâmetros JSON necessários:
```
{
"description": "string",
"incrementalRunConfig": {
"incrementalRunType": "string"
},
"inputSourceConfig": [
{
"applyNormalization": boolean,
"inputSourceARN": "string",
"schemaName": "string"
}
],
"outputSourceConfig": [
{
"applyNormalization": boolean,
"KMSArn": "string",
"output": [
{
"hashed": boolean,
"name": "string"
}
],
"outputS3Path": "string"
}
],
"resolutionTechniques": {
"providerProperties": {
"intermediateSourceConfiguration": {
"intermediateS3Path": "string"
},
"providerConfiguration": JSON value,
"providerServiceArn": "string"
},
"resolutionType": "RULE_MATCHING",
"ruleBasedProperties": {
"attributeMatchingModel": "string",
"matchPurpose": "string",
"rules": [
{
"matchingKeys": [ "string" ],
"ruleName": "string"
}
]
},
"ruleConditionProperties": {
"rules": [
{
"condition": "string",
"ruleName": "string"
}
]
}
},
"roleArn": "string",
"tags": {
"string" : "string"
},
"workflowName": "string"
}
```
Em que:
+ `workflowName`(obrigatório) — Deve ser exclusivo e ter entre 1—255 caracteres que correspondam ao padrão [a-zA-z\$10-9-] \$1
+ `inputSourceConfig`(obrigatório) — Lista de 1—20 configurações de fonte de entrada
+ `outputSourceConfig`(obrigatório) — Exatamente uma configuração de fonte de saída
+ `resolutionTechniques`(obrigatório) — Defina como “RULE\$1MATCHING” como o tipo de resolução para correspondência baseada em regras
+ `roleArn`(obrigatório) — ARN da função do IAM para execução do fluxo de trabalho
+ `ruleConditionProperties`(obrigatório) — Lista de condições da regra e o nome da regra correspondente.
Os parâmetros opcionais incluem:
+ `description`— Até 255 caracteres
+ `incrementalRunConfig`— Configuração incremental do tipo de execução
+ `tags`— Até 200 pares de valores-chave
1. (Opcional) Para usar o processamento incremental em vez do processamento padrão (em lote), adicione o seguinte parâmetro ao corpo da solicitação:
```
"incrementalRunConfig": {
"incrementalRunType": "AUTOMATIC"
}
```
1. Envie a solicitação .
1. Se for bem-sucedido, você receberá uma resposta com o código de status 200 e um corpo JSON contendo:
```
{
"workflowArn": "string",
"workflowName": "string",
// Plus all configured workflow details
}
```
1. Se a chamada não for bem-sucedida, você poderá receber um destes erros:
+ 400 — ConflictException se o nome do fluxo de trabalho já existir
+ 400 — ValidationException se a entrada falhar na validação
+ 402 — ExceedsLimitException se os limites da conta forem excedidos
+ 403 — AccessDeniedException se você não tiver acesso suficiente
+ 429 — ThrottlingException se a solicitação foi limitada
+ 500 — InternalServerException se houver uma falha de serviço interno
------
# Criação de um fluxo de trabalho de correspondência baseado em regras com o tipo de regra simples
**Pré-requisitos**
Antes de criar um fluxo de trabalho de correspondência baseado em regras, você deve:
1. Crie um mapeamento de esquema. Para obter mais informações, consulte [Criação de um mapeamento de esquema](create-schema-mapping.md).
1. Se estiver usando o Amazon Connect Customer Profiles como seu destino de saída, certifique-se de ter as permissões apropriadas configuradas.
O procedimento a seguir demonstra como criar um fluxo de trabalho de correspondência baseado em regras com o tipo de regra **simples** usando o AWS Entity Resolution console ou a API. `CreateMatchingWorkflow`
------
#### [ Console ]
**Para criar um fluxo de trabalho de correspondência baseado em regras com o tipo de regra **simples** 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. Na página **Fluxos de trabalho correspondentes**, no canto superior direito, escolha **Criar fluxo de trabalho correspondente**.
1. Para a **Etapa 1: Especificar os detalhes correspondentes do fluxo** de trabalho, faça o seguinte:
1. Insira um **nome de fluxo de trabalho correspondente** e uma **Descrição** opcional.
1. Em **Entrada de dados**, escolha um **AWS Glue banco de dados **Região da AWS****, a **AWS Glue tabela** e, em seguida, o **mapeamento do esquema** correspondente.
Você pode adicionar até 19 entradas de dados.
1. A opção **Normalizar dados** é selecionada por padrão, para que as entradas de dados sejam normalizadas antes da correspondência. Se você não quiser normalizar os dados, desmarque a opção **Normalizar** dados.
**nota**
A normalização só é suportada nos seguintes cenários em **Criar mapeamento de esquema**:
Se os seguintes subtipos de **nome** estiverem agrupados: **Nome**, **segundo nome**, **sobrenome**.
Se os seguintes subtipos de **endereço** estiverem agrupados: **Endereço 1**, **Endereço 2**, **Endereço 3**, **Cidade**, **Estado**, **País**, **Código postal**.
Se os seguintes subtipos de **telefone** estiverem agrupados: **Número de telefone**, Código do **país do telefone**.
1. Para especificar as permissões **de acesso ao serviço**, escolha uma opção e execute a ação recomendada.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/rule-based-mw-simple.html)
1. (Opcional) Para ativar **tags** para o recurso, escolha **Adicionar nova tag** e insira o par de **chave** e **valor**.
1. Escolha **Próximo**.
1. Para a **Etapa 2: Escolha a técnica de correspondência**:
1. Em **Método de correspondência**, escolha **Correspondência baseada em regras**.
1. **Em Tipo de regra**, escolha **Simples**.
![\[Escolha a tela de técnica de correspondência com a opção de correspondência simples baseada em regras selecionada.\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/choose-matching-method-rule-based-simple.PNG)
1. Em **Cadência de processamento**, selecione uma das opções a seguir.
+ Escolha **Manual** para executar um fluxo de trabalho sob demanda para uma atualização em massa
+ Escolha **Automático** para executar um fluxo de trabalho assim que novos dados estiverem em seu bucket do S3
**nota**
Se você escolher **Automático**, certifique-se de ter EventBridge as notificações da Amazon ativadas para seu bucket do S3. Para obter instruções sobre como habilitar a Amazon EventBridge usando o console do S3, consulte [Habilitando a Amazon EventBridge](https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-event-notifications-eventbridge.html) no Guia do *usuário do Amazon S3*.
1. (Opcional) Para **indexar somente para mapeamento de ID**, você pode optar **por ativar** a capacidade de indexar somente os dados e não gerar IDs.
Por padrão, o fluxo de trabalho correspondente é gerado IDs após a indexação dos dados.
1. Em **Regras de correspondência**, insira um **nome de regra** e escolha as **chaves de correspondência** para essa regra.
Você pode criar até 15 regras e aplicar até 15 chaves de correspondência diferentes em suas regras para definir critérios de correspondência.
![\[Interface de regras de correspondência com campos para inserir o nome da regra e selecionar as chaves de correspondência.\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/matching-rules.PNG)
1. **Em Tipo de comparação**, escolha uma das opções a seguir com base em sua meta.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/rule-based-mw-simple.html)
![\[Opções de tipo de comparação: vários campos de entrada para encontrar correspondências entre dados armazenados em vários campos ou campo de entrada único para limitar a comparação em um campo.\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/comparison-type.PNG)
1. Escolha **Próximo**.
1. Para a **Etapa 3: Especifique a saída e o formato dos dados**:
1. **Em **Destino e formato de saída de dados**, escolha a **localização do Amazon S3** para a saída de dados e se o **formato dos dados** será dados **normalizados ou dados originais**.**
1. Em **Criptografia**, se você optar por **Personalizar as configurações de criptografia**, insira o ARN da **AWS KMS chave**.
1. Visualize a **saída gerada pelo sistema**.
1. Para **Saída de dados**, decida quais campos você deseja incluir, ocultar ou mascarar e, em seguida, execute as ações recomendadas com base em suas metas.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/rule-based-mw-simple.html)
1. Escolha **Próximo**.
1. Para a **Etapa 4: Revise e crie**:
1. Revise as seleções feitas nas etapas anteriores e edite, se necessário.
1. Escolha **Criar e executar**.
Uma mensagem aparece indicando que o fluxo de trabalho correspondente foi criado e que o trabalho foi iniciado.
1. Na página de detalhes do fluxo de trabalho correspondente, na guia **Métricas**, veja o seguinte em **Métricas do último trabalho**:
+ O **Job ID**.
+ **O **status** da tarefa de fluxo de trabalho correspondente: Em **fila**, **em andamento**, **concluída**, com falha**
+ O **tempo concluído** para o trabalho do fluxo de trabalho.
+ O número de **registros processados**.
+ O número de **registros não processados**.
+ A **partida única IDs gerada**.
+ O número de **registros de entrada**.
Você também pode visualizar as métricas de trabalho para trabalhos de fluxo de trabalho correspondentes que foram executados anteriormente no **Histórico de trabalhos**.
1. Após a conclusão do trabalho de fluxo de trabalho correspondente (o **status** é **concluído**), você pode acessar a guia **Saída de dados** e selecionar sua localização no **Amazon S3** para visualizar os resultados.
1. (Somente tipo de processamento **manual**) Se você criou um fluxo de trabalho de **correspondência baseado em regras** com o tipo de processamento **Manual**, você pode executar o fluxo de trabalho correspondente a qualquer momento escolhendo **Executar fluxo de trabalho na página de detalhes do fluxo** de trabalho correspondente.
------
#### [ API ]
**Para criar um fluxo de trabalho de correspondência baseado em regras com o tipo de regra **simples** usando a API**
**nota**
Por padrão, o fluxo de trabalho usa processamento padrão (em lote). Para usar o processamento incremental (automático), você deve configurá-lo explicitamente.
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
```
1. No cabeçalho da solicitação, defina o tipo de conteúdo como application/json.
**nota**
Para obter uma lista completa das linguagens de programação compatíveis, consulte a *[Referência AWS Entity Resolution da API](https://docs.aws.amazon.com/entityresolution/latest/apireference/Welcome.html)*.
1. Para o corpo da solicitação, forneça os seguintes parâmetros JSON necessários:
```
{
"description": "string",
"incrementalRunConfig": {
"incrementalRunType": "string"
},
"inputSourceConfig": [
{
"applyNormalization": boolean,
"inputSourceARN": "string",
"schemaName": "string"
}
],
"outputSourceConfig": [
{
"applyNormalization": boolean,
"KMSArn": "string",
"output": [
{
"hashed": boolean,
"name": "string"
}
],
"outputS3Path": "string"
}
],
"resolutionTechniques": {
"providerProperties": {
"intermediateSourceConfiguration": {
"intermediateS3Path": "string"
},
"providerConfiguration": JSON value,
"providerServiceArn": "string"
},
"resolutionType": "RULE_MATCHING",
"ruleBasedProperties": {
"attributeMatchingModel": "string",
"matchPurpose": "string",
"rules": [
{
"matchingKeys": [ "string" ],
"ruleName": "string"
}
]
},
"ruleConditionProperties": {
"rules": [
{
"condition": "string",
"ruleName": "string"
}
]
}
},
"roleArn": "string",
"tags": {
"string" : "string"
},
"workflowName": "string"
}
```
Em que:
+ `workflowName`(obrigatório) — Deve ser exclusivo e ter entre 1—255 caracteres que correspondam ao padrão [a-zA-z\$10-9-] \$1
+ `inputSourceConfig`(obrigatório) — Lista de 1—20 configurações de fonte de entrada
+ `outputSourceConfig`(obrigatório) — Exatamente uma configuração de fonte de saída
+ `resolutionTechniques`(obrigatório) — Defina como “RULE\$1MATCHING” para correspondência baseada em regras
+ `roleArn`(obrigatório) — ARN da função do IAM para execução do fluxo de trabalho
+ `ruleConditionProperties`(obrigatório) — Lista de condições da regra e o nome da regra correspondente.
Os parâmetros opcionais incluem:
+ `description`— Até 255 caracteres
+ `incrementalRunConfig`— Configuração incremental do tipo de execução
+ `tags`— Até 200 pares de valores-chave
1. (Opcional) Para usar o processamento incremental em vez do processamento padrão (em lote), adicione o seguinte parâmetro ao corpo da solicitação:
```
"incrementalRunConfig": {
"incrementalRunType": "AUTOMATIC"
}
```
1. Envie a solicitação .
1. Se for bem-sucedido, você receberá uma resposta com o código de status 200 e um corpo JSON contendo:
```
{
"workflowArn": "string",
"workflowName": "string",
// Plus all configured workflow details
}
```
1. Se a chamada não for bem-sucedida, você poderá receber um destes erros:
+ 400 — ConflictException se o nome do fluxo de trabalho já existir
+ 400 — ValidationException se a entrada falhar na validação
+ 402 — ExceedsLimitException se os limites da conta forem excedidos
+ 403 — AccessDeniedException se você não tiver acesso suficiente
+ 429 — ThrottlingException se a solicitação foi limitada
+ 500 — InternalServerException se houver uma falha de serviço interno
------
# Criação de um fluxo de trabalho de correspondência baseado em aprendizado de máquina
A *[correspondência baseada em aprendizado de máquina](glossary.md#ml-matching-defn)* é um processo predefinido que tenta combinar registros em todos os dados que você insere. O fluxo de trabalho de correspondência baseado em aprendizado de máquina permite comparar dados de texto não criptografado para encontrar uma ampla variedade de correspondências usando um modelo de aprendizado de máquina.
**nota**
O modelo de aprendizado de máquina não suporta a comparação de dados com hash.
Quando AWS Entity Resolution encontra uma correspondência entre dois ou mais registros em seus dados, ele atribui:
+ Um [ID de correspondência](glossary.md#match-id-defin) para os registros no conjunto de dados correspondente
+ A porcentagem do [nível de confiança](glossary.md#confidence-level-defn) da partida.
Você pode usar a saída de um fluxo de trabalho de correspondência baseado em ML como entrada para a correspondência de provedores de serviços de dados ou vice-versa para atingir suas metas específicas. Por exemplo, você pode executar uma correspondência baseada em ML para encontrar correspondências em suas fontes de dados em seus próprios registros primeiro. Se um subconjunto não corresponder, você poderá executar a [correspondência baseada no serviço do provedor para encontrar correspondências](create-matching-workflow-provider.md) adicionais.
**Pré-requisitos**
Antes de criar um fluxo de trabalho de correspondência baseado em ML, você deve:
1. Crie um mapeamento de esquema. Para obter mais informações, consulte [Criação de um mapeamento de esquema](create-schema-mapping.md).
1. Se estiver usando o Amazon Connect Customer Profiles como seu destino de saída, certifique-se de ter as permissões apropriadas configuradas.
**Para criar um fluxo de trabalho de correspondência baseado em ML:**
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. Na página **Fluxos de trabalho correspondentes**, no canto superior direito, escolha **Criar fluxo de trabalho correspondente**.
1. Para a **Etapa 1: Especificar os detalhes correspondentes do fluxo** de trabalho, faça o seguinte:
1. Insira um **nome de fluxo de trabalho correspondente** e uma **Descrição** opcional.
1. Em **Entrada de dados**, escolha um **AWS Glue banco de dados **Região da AWS****, a **AWS Glue tabela** e, em seguida, o **mapeamento do esquema** correspondente.
Você pode adicionar até 20 entradas de dados.
1. A opção **Normalizar dados** é selecionada por padrão, para que as entradas de dados sejam normalizadas antes da correspondência. Se você não quiser normalizar os dados, desmarque a opção **Normalizar** dados.
A correspondência baseada em aprendizado de máquina apenas normaliza[Nome](glossary.md#normalization-ML-defn-name), e. [Telefone](glossary.md#normalization-ML-defn-phone) [E-mail](glossary.md#normalization-ML-defn-email)
1. Para especificar as permissões **de acesso ao serviço**, escolha uma opção e execute a ação recomendada.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/create-matching-workflow-ml.html)
1. (Opcional) Para ativar **tags** para o recurso, escolha **Adicionar nova tag** e insira o par de **chave** e **valor**.
1. Escolha **Próximo**.
1. Para a **Etapa 2: Escolha a técnica de correspondência**:
1. Em **Método de correspondência**, escolha **Correspondência baseada em aprendizado de máquina**.
![\[AWS Entity Resolution interface de criação de fluxo de trabalho correspondente com opções para correspondência baseada em regras ou de aprendizado de máquina.\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/choose-matching-method-machine-learning.PNG)
1. Em **Cadência de processamento**, a opção **Manual** é selecionada.
Essa opção permite que você execute um fluxo de trabalho sob demanda para uma atualização em massa.
**nota**
O processamento automático (incremental) não é suportado para fluxos de trabalho de correspondência baseados em aprendizado de máquina.
1. Escolha **Próximo**.
1. Para a **Etapa 3: Especifique a saída e o formato dos dados**:
1. **Em **Destino e formato de saída de dados**, escolha a **localização do Amazon S3** para a saída de dados e se o **formato dos dados** será dados **normalizados ou dados originais**.**
1. Em **Criptografia**, se você optar por **Personalizar as configurações de criptografia**, insira o ARN da **AWS KMS chave**.
1. Visualize a **saída gerada pelo sistema**.
1. Para **Saída de dados**, decida quais campos você deseja incluir, ocultar ou mascarar e, em seguida, execute as ações recomendadas com base em suas metas.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/create-matching-workflow-ml.html)
1. Escolha **Próximo**.
1. Para a **Etapa 4: Revise e crie**:
1. Revise as seleções feitas nas etapas anteriores e edite, se necessário.
1. Escolha **Criar e executar**.
Uma mensagem aparece indicando que o fluxo de trabalho correspondente foi criado e que o trabalho foi iniciado.
1. Na página de detalhes do fluxo de trabalho correspondente, na guia **Métricas**, veja o seguinte em **Métricas do último trabalho**:
+ O **Job ID**.
+ **O **status** da tarefa de fluxo de trabalho correspondente: Em **fila**, **em andamento**, **concluída**, com falha**
+ O **tempo concluído** para o trabalho do fluxo de trabalho.
+ O número de **registros processados**.
+ O número de **registros não processados**.
+ A **partida única IDs gerada**.
+ O número de **registros de entrada**.
Você também pode visualizar as métricas de trabalho para trabalhos de fluxo de trabalho correspondentes que foram executados anteriormente no **Histórico de trabalhos**.
1. Após a conclusão do trabalho de fluxo de trabalho correspondente (o **status** é **concluído**), você pode acessar a guia **Saída de dados** e selecionar sua localização no **Amazon S3** para visualizar os resultados.
1. (Somente tipo de processamento **manual**) Se você criou um fluxo de trabalho de **correspondência baseado em aprendizado de máquina** com o tipo de processamento **Manual**, você pode executar o fluxo de trabalho correspondente a qualquer momento escolhendo **Executar fluxo de trabalho na página de detalhes do fluxo** de trabalho correspondente.
# Criação de um fluxo de trabalho de correspondência baseado em serviços do provedor
A *[correspondência baseada no serviço do provedor](glossary.md#provider-service-matching)* permite que você combine seus identificadores conhecidos com o provedor de serviços de dados de sua preferência.
AWS Entity Resolution atualmente oferece suporte aos seguintes serviços de provedor de dados:
+ LiveRamp
+ TransUnion
+ ID unificada 2.0
Para obter mais informações sobre os serviços de provedor suportados, consulte[Preparando dados de entrada de terceiros](prepare-third-party-input-data.md).
Você pode usar uma assinatura pública para esses provedores AWS Data Exchange ou negociar uma oferta privada diretamente com o provedor de dados. Para obter mais informações sobre como criar uma nova assinatura ou reutilizar uma assinatura existente de um serviço de provedor, consulte[Etapa 1: Assine um serviço de provedor em AWS Data Exchange](prepare-third-party-input-data.md#subscribe-provider-service).
As seções a seguir descrevem como criar um fluxo de trabalho de correspondência baseado no provedor.
**Topics**
+ [Criando um fluxo de trabalho correspondente com LiveRamp](#create-mw-liveramp)
+ [Criando um fluxo de trabalho correspondente com TransUnion](#create-mw-transunion)
+ [Criando um fluxo de trabalho correspondente com o UID 2.0](#create-mw-uid)
## Criando um fluxo de trabalho correspondente com LiveRamp
O LiveRamp serviço fornece um identificador chamado RampID. O RampID é um dos mais usados IDs em plataformas de demanda para criar um público para uma campanha publicitária. Usando um fluxo de trabalho correspondente com LiveRamp, você pode resolver endereços de e-mail com hash para RAMPIDs.
**nota**
AWS Entity Resolution suporta atribuição de RampID baseada em PII.
**Pré-requisitos**
Antes de criar um fluxo de trabalho correspondente com LiveRamp, você deve:
1. Crie um mapeamento de esquema. Para obter mais informações, consulte [Criação de um mapeamento de esquema](create-schema-mapping.md).
1. Tenha uma assinatura do LiveRamp serviço
1. Tenha as permissões apropriadas configuradas para o bucket de armazenamento de dados do Amazon S3 em que você deseja que a saída do fluxo de trabalho correspondente seja gravada temporariamente.
Antes de criar um fluxo de trabalho de mapeamento de ID com LiveRamp, adicione as seguintes permissões ao bucket de preparação de dados do S3.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::715724997226:root"
},
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:GetObjectVersion",
"s3:DeleteObject"
],
"Resource": [
"arn:aws:s3:::",
"arn:aws:s3:::/*"
]
},
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::715724997226:root"
},
"Action": [
"s3:ListBucket",
"s3:GetBucketLocation",
"s3:GetBucketPolicy",
"s3:ListBucketVersions",
"s3:GetBucketAcl"
],
"Resource": [
"arn:aws:s3:::",
"arn:aws:s3:::/*"
]
}
]
}
```
------
Substitua cada ** por suas próprias informações.
| | |
| --- |--- |
| staging-bucket | Bucket Amazon S3 que armazena temporariamente seus dados enquanto executa um fluxo de trabalho baseado em serviços do provedor. |
**Para criar um fluxo de trabalho correspondente com LiveRamp:**
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. Na página **Fluxos de trabalho correspondentes**, no canto superior direito, escolha **Criar fluxo de trabalho correspondente**.
1. Para a **Etapa 1: Especificar os detalhes correspondentes do fluxo** de trabalho, faça o seguinte:
1. Insira um **nome de fluxo de trabalho correspondente** e uma **Descrição** opcional.
1. Em **Entrada de dados**, escolha um **AWS Glue banco de dados **Região da AWS****, a **AWS Glue tabela** e, em seguida, o **mapeamento do esquema** correspondente.
Você pode adicionar até 20 entradas de dados.
1. A opção **Normalizar dados** é selecionada por padrão, para que as entradas de dados sejam normalizadas antes da correspondência.
**nota**
A normalização só é suportada nos seguintes cenários em **Criar mapeamento de esquema**:
Se os seguintes subtipos de **nome** estiverem agrupados: **Nome**, **segundo nome**, **sobrenome**.
Se os seguintes subtipos de **endereço** estiverem agrupados: **Endereço 1**, **Endereço 2**: nome do **endereço 3, nome** **da cidade**, **estado**, **país**, código **postal**.
Se os seguintes subtipos de **telefone** estiverem agrupados: **Número de telefone**, Código do **país do telefone**.
Se você estiver usando o processo de resolução somente por e-mail, desmarque a opção **Normalizar dados**, pois somente e-mails com hash são usados para dados de entrada.
1. Para especificar as permissões **de acesso ao serviço**, escolha uma opção e execute a ação recomendada.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/create-matching-workflow-provider.html)
1. (Opcional) Para ativar **tags** para o recurso, escolha **Adicionar nova tag** e insira o par de **chave** e **valor**.
1. Escolha **Próximo**.
1. Para a **Etapa 2: Escolha a técnica de correspondência**:
1. Em **Método de correspondência**, escolha **Serviços do provedor**.
1. Para **serviços do provedor**, escolha **LiveRamp**.
**nota**
Certifique-se de que o formato e a normalização do arquivo de entrada de dados estejam alinhados com as diretrizes do serviço do provedor.
Para obter mais informações sobre as diretrizes de formatação do arquivo de entrada para o fluxo de trabalho correspondente, consulte [Executar resolução de identidade por meio do ADX](https://docs.liveramp.com/identity/en/perform-identity-resolution-through-adx.html) na LiveRamp documentação.
1. Para **LiveRamp produtos**, escolha um produto na lista suspensa.
![\[Opções de serviços do provedor com o serviço do LiveRamp provedor selecionado.\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/choose-matching-method-liveramp.png)
**nota**
Se você escolher **Atribuição PII,** deverá fornecer pelo menos uma coluna sem identificador ao realizar a resolução da entidade. Por exemplo, GÊNERO.
1. Para **LiveRamp configuração**, insira um ARN do **gerenciador de ID do cliente e um ARN** do gerenciador **secreto do cliente**.
![\[LiveRamp formulário de configuração com campos para ARN do gerenciador de ID do cliente e ARN do gerenciador secreto do cliente.\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/choose-matching-method-liveramp-config.png)
1. Para **preparação de dados**, escolha o local do **Amazon S3** para o armazenamento temporário de seus dados enquanto eles são processados.
Você deve ter permissão para a localização do **Amazon S3 de armazenamento** de dados. Para obter mais informações, consulte [Criação de uma função de trabalho de fluxo de trabalho para AWS Entity Resolution](create-workflow-job-role.md).
1. Escolha **Próximo**.
1. Para a **Etapa 3: Especifique a saída de dados**:
1. **Em **Destino e formato de saída de dados**, escolha a **localização do Amazon S3** para a saída de dados e se o **formato dos dados** será dados **normalizados ou dados originais**.**
1. Em **Criptografia**, se você optar por **Personalizar as configurações de criptografia**, insira o ARN da **AWS KMS chave**.
1. Visualize a **saída LiveRamp gerada**.
Essas são as informações adicionais geradas pelo LiveRamp.
1. Para **Saída de dados**, decida quais campos você deseja incluir, ocultar ou mascarar e, em seguida, execute as ações recomendadas com base em suas metas.
**nota**
**Se você tiver escolhido **LiveRamp**, devido aos filtros LiveRamp de privacidade que removem informações de identificação pessoal (PII), alguns campos exibirão um estado de **saída** indisponível.**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/create-matching-workflow-provider.html)
![\[AWS Entity Resolution Interface de criação de fluxo de trabalho de mapeamento de ID com opções para especificar o local de saída de dados.\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/specify-data-output.PNG)
1. Escolha **Próximo**.
1. Para a **Etapa 4: Revise e crie**:
1. Revise as seleções feitas nas etapas anteriores e edite, se necessário.
1. Escolha **Criar e executar**.
Uma mensagem aparece indicando que o fluxo de trabalho correspondente foi criado e que o trabalho foi iniciado.
1. Na página de detalhes do fluxo de trabalho correspondente, na guia **Métricas**, veja o seguinte em **Métricas do último trabalho**:
+ O **Job ID**.
+ **O **status** da tarefa de fluxo de trabalho correspondente: Em **fila**, **em andamento**, **concluída**, com falha**
+ O **tempo concluído** para o trabalho do fluxo de trabalho.
+ O número de **registros processados**.
+ O número de **registros não processados**.
+ A **partida única IDs gerada**.
+ O número de **registros de entrada**.
Você também pode visualizar as métricas de trabalho para trabalhos de fluxo de trabalho correspondentes que foram executados anteriormente no **Histórico de trabalhos**.
1. Após a conclusão do trabalho de fluxo de trabalho correspondente (o **status** é **concluído**), você pode acessar a guia **Saída de dados** e selecionar sua localização no **Amazon S3** para visualizar os resultados.
## Criando um fluxo de trabalho correspondente com TransUnion
Se você tiver uma assinatura do TransUnion serviço, poderá melhorar a compreensão do cliente vinculando, combinando e aprimorando os registros relacionados ao cliente armazenados em canais diferentes com chaves eletrônicas TransUnion pessoais e domésticas e mais de 200 atributos de dados.
O TransUnion serviço fornece identificadores conhecidos como TransUnion Indivíduo e Domicílio IDs. TransUnion fornece atribuição de ID (também conhecida como codificação) de identificadores conhecidos, como nome, endereço, número de telefone e endereço de e-mail.
**Pré-requisitos**
Antes de criar um fluxo de trabalho correspondente com LiveRamp, você deve:
1. Crie um mapeamento de esquema. Para obter mais informações, consulte [Criação de um mapeamento de esquema](create-schema-mapping.md).
1. Tenha uma assinatura do TransUnion serviço
1. Tenha as permissões apropriadas configuradas para o bucket de armazenamento de dados do Amazon S3 em que você deseja que a saída do fluxo de trabalho correspondente seja gravada temporariamente.
Antes de criar um fluxo de trabalho correspondente com TransUnion, adicione as seguintes permissões ao bucket de preparação de dados do S3.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::381491956555:root"
},
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:GetObjectVersion",
"s3:DeleteObject"
],
"Resource": [
"arn:aws:s3:::",
"arn:aws:s3:::/*"
]
},
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::381491956555:root"
},
"Action": [
"s3:ListBucket",
"s3:GetBucketLocation",
"s3:GetBucketPolicy",
"s3:ListBucketVersions",
"s3:GetBucketAcl"
],
"Resource": [
"arn:aws:s3:::",
"arn:aws:s3:::/*"
]
}
]
}
```
------
Substitua cada ** por suas próprias informações.
| | |
| --- |--- |
| staging-bucket | Bucket Amazon S3 que armazena temporariamente seus dados enquanto executa um fluxo de trabalho baseado em serviços do provedor. |
**Para criar um fluxo de trabalho correspondente com TransUnion:**
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. Na página **Fluxos de trabalho correspondentes**, no canto superior direito, escolha **Criar fluxo de trabalho correspondente**.
1. Para a **Etapa 1: Especificar os detalhes correspondentes do fluxo** de trabalho, faça o seguinte:
1. Insira um **nome de fluxo de trabalho correspondente** e uma **Descrição** opcional.
1. Em **Entrada de dados**, escolha um **AWS Glue banco de dados **Região da AWS****, a **AWS Glue tabela** e, em seguida, o **mapeamento do esquema** correspondente.
Você pode adicionar até 20 entradas de dados.
1. A opção **Normalizar dados** é selecionada por padrão, para que as entradas de dados sejam normalizadas antes da correspondência. Se você não quiser normalizar os dados, desmarque a opção **Normalizar** dados.
**nota**
A normalização só é suportada nos seguintes cenários em **Criar mapeamento de esquema**:
Se os seguintes subtipos de **nome** estiverem agrupados: **Nome**, **segundo nome**, **sobrenome**.
Se os seguintes subtipos de **endereço** estiverem agrupados: **Endereço 1**, **Endereço 2**: nome do **endereço 3, nome** **da cidade**, **estado**, **país**, código **postal**.
Se os seguintes subtipos de **telefone** estiverem agrupados: **Número de telefone**, Código do **país do telefone**.
1. Para especificar as permissões **de acesso ao serviço**, escolha uma opção e execute a ação recomendada.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/create-matching-workflow-provider.html)
1. (Opcional) Para ativar **tags** para o recurso, escolha **Adicionar nova tag** e insira o par de **chave** e **valor**.
1. Escolha **Próximo**.
1. Para a **Etapa 2: Escolha a técnica de correspondência**:
1. Em **Método de correspondência**, escolha **Serviços do provedor**.
1. Para **serviços do provedor**, escolha **TransUnion**.
**nota**
Certifique-se de que o formato e a normalização do arquivo de entrada de dados estejam alinhados com as diretrizes do serviço do provedor.
![\[Opções de serviços do provedor com o serviço do TransUnion provedor selecionado.\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/choose-matching-method-transunion.PNG)
1. Para **preparação de dados**, escolha o local do **Amazon S3** para o armazenamento temporário de seus dados enquanto eles são processados.
Você deve ter permissão para a localização do **Amazon S3 de armazenamento** de dados. Para obter mais informações, consulte [Criação de uma função de trabalho de fluxo de trabalho para AWS Entity Resolution](create-workflow-job-role.md).
1. Escolha **Próximo**.
1. Para a **Etapa 3: Especifique a saída de dados**:
1. **Em **Destino e formato de saída de dados**, escolha a **localização do Amazon S3** para a saída de dados e se o **formato dos dados** será dados **normalizados ou dados originais**.**
1. Em **Criptografia**, se você optar por **Personalizar as configurações de criptografia**, insira o ARN da **AWS KMS chave**.
1. Visualize a **saída TransUnion gerada**.
Essas são as informações adicionais geradas pelo TransUnion.
1. Para **Saída de dados**, decida quais campos você deseja incluir, ocultar ou mascarar e, em seguida, execute as ações recomendadas com base em suas metas.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/create-matching-workflow-provider.html)
1. Para a **saída gerada pelo sistema**, visualize todos os campos incluídos.
1. Escolha **Próximo**.
1. Para a **Etapa 4: Revise e crie**:
1. Revise as seleções feitas nas etapas anteriores e edite, se necessário.
1. Escolha **Criar e executar**.
Uma mensagem aparece indicando que o fluxo de trabalho correspondente foi criado e que o trabalho foi iniciado.
1. Na página de detalhes do fluxo de trabalho correspondente, na guia **Métricas**, veja o seguinte em **Métricas do último trabalho**:
+ O **Job ID**.
+ **O **status** da tarefa de fluxo de trabalho correspondente: Em **fila**, **em andamento**, **concluída**, com falha**
+ O **tempo concluído** para o trabalho do fluxo de trabalho.
+ O número de **registros processados**.
+ O número de **registros não processados**.
+ A **partida única IDs gerada**.
+ O número de **registros de entrada**.
Você também pode visualizar as métricas de trabalho para trabalhos de fluxo de trabalho correspondentes que foram executados anteriormente no **Histórico de trabalhos**.
1. Após a conclusão do trabalho de fluxo de trabalho correspondente (o **status** é **concluído**), você pode acessar a guia **Saída de dados** e selecionar sua localização no **Amazon S3** para visualizar os resultados.
## Criando um fluxo de trabalho correspondente com o UID 2.0
Se você tiver uma assinatura do serviço Unified ID 2.0, poderá ativar campanhas publicitárias com identidade determinística e confiar na interoperabilidade com muitos participantes UID2 habilitados em todo o ecossistema de publicidade. Para obter mais informações, consulte [Visão geral do Unified ID 2.0]( https://unifiedid.com/docs/intro).
O serviço Unified ID 2.0 fornece UID 2 bruto, que é usado para criar campanhas publicitárias na plataforma The Trade Desk. O UID 2.0 é gerado usando uma estrutura de código aberto.
Em um fluxo de trabalho, você pode usar um **Email Address** ou **Phone number** para UID2 geração bruta, mas não ambos. Se ambos estiverem presentes no mapeamento do esquema, o fluxo de trabalho escolherá o **Email Address** e o **Phone number** será um campo de passagem. Para oferecer suporte a ambos, crie um novo mapeamento de esquema onde **Phone number** está mapeado, mas **Email Address** não está mapeado. Em seguida, crie um segundo fluxo de trabalho usando esse novo mapeamento de esquema.
**nota**
UID2s Os crus são criados pela adição de sais de baldes de sal que são girados aproximadamente uma vez por ano, fazendo com que o cru também seja girado UID2 com ele. Portanto, é recomendável que você atualize o bruto UID2s diariamente. Para obter mais informações, consulte [https://unifiedid.com/docs/how-often-should-uidgetting-started/gs-faqs\$1](https://unifiedid.com/docs/getting-started/gs-faqs#how-often-should-uid2s-be-refreshed-for-incremental-updates) 2 -incremental-updates. s-be-refreshed-for
**Pré-requisitos**
Antes de criar um fluxo de trabalho correspondente com o UID 2.0, você deve:
1. Crie um mapeamento de esquema. Para obter mais informações, consulte [Criação de um mapeamento de esquema](create-schema-mapping.md).
1. Tenha uma assinatura do serviço UID 2.0
**Para criar um fluxo de trabalho correspondente com o UID 2.0:**
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. Na página **Fluxos de trabalho correspondentes**, no canto superior direito, escolha **Criar fluxo de trabalho correspondente**.
1. Para a **Etapa 1: Especificar os detalhes correspondentes do fluxo** de trabalho, faça o seguinte:
1. Insira um **nome de fluxo de trabalho correspondente** e uma **Descrição** opcional.
1. Em **Entrada de dados**, escolha um **AWS Glue banco de dados **Região da AWS****, a **AWS Glue tabela** e, em seguida, o **mapeamento do esquema** correspondente.
Você pode adicionar até 20 entradas de dados.
1. Deixe a opção **Normalizar dados** selecionada, para que as entradas de dados (**Email Address**ou**Phone number**) sejam normalizadas antes da correspondência.
Para obter mais informações sobre **Email Address** normalização, consulte [Normalização de endereço de e-mail na documentação](https://unifiedid.com/docs/getting-started/gs-normalization-encoding#email-address-normalization) do UID 2.0.
Para obter mais informações sobre **Phone number** normalização, consulte [Normalização do número de telefone na documentação](https://unifiedid.com/docs/getting-started/gs-normalization-encoding#phone-number-normalization) do UID 2.0.
1. Para especificar as permissões **de acesso ao serviço**, escolha uma opção e execute a ação recomendada.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/create-matching-workflow-provider.html)
1. (Opcional) Para ativar **tags** para o recurso, escolha **Adicionar nova tag** e insira o par de **chave** e **valor**.
1. Escolha **Próximo**.
1. Para a **Etapa 2: Escolha a técnica de correspondência**:
1. Em **Método de correspondência**, escolha **Serviços do provedor**.
1. Para **serviços de provedor**, escolha **Unified ID 2.0**.
![\[Opções de serviços de provedor com o serviço de provedor de ID unificado selecionado.\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/images/choose-matching-method-uid.PNG)
1. Escolha **Próximo**.
1. Para a **Etapa 3: Especifique a saída de dados**:
1. **Em **Destino e formato de saída de dados**, escolha a **localização do Amazon S3** para a saída de dados e se o **formato dos dados** será dados **normalizados ou dados originais**.**
1. Em **Criptografia**, se você optar por **Personalizar as configurações de criptografia**, insira o ARN da **AWS KMS chave**.
1. Veja a **saída gerada pelo Unified ID 2.0**.
Esta é uma lista de todas as informações adicionais geradas pelo UID 2.0
1. Para **Saída de dados**, decida quais campos você deseja incluir, ocultar ou mascarar e, em seguida, execute as ações recomendadas com base em suas metas.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/create-matching-workflow-provider.html)
1. Para a **saída gerada pelo sistema**, visualize todos os campos incluídos.
1. Escolha **Próximo**.
1. Para a **Etapa 4: Revise e crie**:
1. Revise as seleções feitas nas etapas anteriores e edite, se necessário.
1. Escolha **Criar e executar**.
Uma mensagem aparece indicando que o fluxo de trabalho correspondente foi criado e que o trabalho foi iniciado.
1. Na página de detalhes do fluxo de trabalho correspondente, na guia **Métricas**, veja o seguinte em **Métricas do último trabalho**:
+ O **Job ID**.
+ **O **status** da tarefa de fluxo de trabalho correspondente: Em **fila**, **em andamento**, **concluída**, com falha**
+ O **tempo concluído** para o trabalho do fluxo de trabalho.
+ O número de **registros processados**.
+ O número de **registros não processados**.
+ A **partida única IDs gerada**.
+ O número de **registros de entrada**.
Você também pode visualizar as métricas de trabalho para trabalhos de fluxo de trabalho correspondentes que foram executados anteriormente no **Histórico de trabalhos**.
1. Após a conclusão do trabalho de fluxo de trabalho correspondente (o **status** é **concluído**), você pode acessar a guia **Saída de dados** e selecionar sua localização no **Amazon S3** para visualizar os resultados.
# Editando um fluxo de trabalho correspondente
A edição do fluxo de trabalho correspondente permite que você mantenha seus processos de resolução de entidades up-to-date e responda às mudanças nos requisitos de sua organização ao longo do tempo. Talvez você queira ajustar os critérios, as técnicas ou as saídas de dados correspondentes para melhorar a precisão e a eficiência do processo de resolução da entidade. Se você identificar problemas ou erros nos resultados do fluxo de trabalho atual, editá-lo poderá ajudá-lo a diagnosticar e resolver esses problemas.
**Para editar um fluxo de trabalho correspondente:**
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 correspondente.
1. Na página de detalhes do fluxo de trabalho correspondente, no canto superior direito, escolha **Editar fluxo de trabalho**.
1. Na página **Especificar detalhes do fluxo de trabalho correspondente**, faça as alterações necessárias e escolha **Avançar**.
1. Na página **Escolher técnica de correspondência**, faça as alterações necessárias e escolha **Avançar**.
**Importante**
Você pode alterar a **cadência de processamento** de **Manual** para **Automática**, mas depois de alterá-la para **Automática**, não é possível alterá-la novamente para **Manual**.
Se a **cadência de processamento** já estiver definida como **Automática**, você não poderá alterá-la para **Manual**.
1. Na página **Especificar saída de dados**, faça as alterações necessárias e escolha **Avançar**.
1. Na página **Revisar e salvar**, faça as alterações necessárias e escolha **Salvar**.
# Excluindo um fluxo de trabalho correspondente
Se um fluxo de trabalho correspondente não estiver mais sendo usado ou se tornar obsoleto, excluí-lo pode ajudar a manter seu espaço de trabalho organizado e organizado. Se você desenvolveu um fluxo de trabalho novo e aprimorado que substitui um antigo, excluir o fluxo de trabalho antigo pode ajudar a garantir que você esteja usando apenas a maioria up-to-date dos processos.
**Para excluir um fluxo de trabalho correspondente:**
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 correspondente.
1. Na página de detalhes do fluxo de trabalho correspondente, no canto superior direito, escolha **Excluir**.
1. Confirme a exclusão e escolha **Excluir**.
# Modificar ou gerar 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 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 IDs guia **Corresponder**.
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 **Localizar 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. Visualize 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, defina o tipo de conteúdo como application/json.
1. No URI da solicitação, especifique seu`workflowName`.
O `workflowName` imperativo:
+ Ter entre 1 e 255 caracteres
+ Combine o padrão [A-zA-z\$10-9-] \$1
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
------
# Procurando um ID de correspondência para um fluxo de trabalho de correspondência baseado em regras
Depois de concluir um fluxo de trabalho de correspondência baseado em regras, você pode recuperar a ID de correspondência e a regra associada para cada registro processado. Essas informações ajudam você a entender como os registros foram combinados e quais regras foram aplicadas. O procedimento a seguir demonstra como acessar esses dados usando o AWS Entity Resolution console ou a `GetMatchID` API.
------
#### [ Console ]
**Para pesquisar 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 IDs guia **Corresponder**.
1. Escolha **Pesquisar ID de correspondência**.
**nota**
A **opção Pesquisar 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. Execute um destes procedimentos:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/find-match-id.html)
1. Em **Atributos de registro**, insira o **valor** de uma **chave de correspondência** existente para pesquisar cada registro existente.
**dica**
Insira o máximo de valores possível para ajudar a encontrar o Match ID.
1. A opção **Normalizar dados** é selecionada por padrão, para que as entradas de dados sejam normalizadas antes da correspondência. Se você não quiser normalizar os dados, desmarque a opção **Normalizar** dados.
1. Se você quiser ver as regras de correspondência, expanda a opção **Exibir regras de correspondência**.
1. Escolha **Look up**.
Uma mensagem de sucesso aparece informando que o Match ID foi encontrado.
1. Veja o ID de correspondência correspondente e a regra associada que foi encontrada.
------
#### [ API ]
**Para pesquisar 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 compatíveis, [consulte a seção Consulte também](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GetMatchId.html#API_GetMatchId_SeeAlso) da [API de GetMatch ID](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GetMatchId.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/matches
```
1. No cabeçalho da solicitação, defina o tipo de conteúdo como application/json.
1. No URI da solicitação, especifique seu`workflowName`.
O `workflowName` imperativo:
+ Ter entre 1 e 255 caracteres
+ Combine o padrão [A-zA-z\$10-9-] \$1
1. Para o corpo da solicitação, forneça o seguinte JSON:
```
{
"applyNormalization": boolean,
"record": {
"string" : "string"
}
}
```
Em que:
`applyNormalization`(opcional) - Defina como `true` para normalizar os atributos definidos no esquema
`record`(obrigatório) - O registro para o qual buscar o Match ID
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:
```
{
"matchId": "string",
"matchRule": "string"
}
```
O `matchId` é o identificador exclusivo desse grupo de registros correspondentes e `matchRule` indica em qual regra o registro correspondeu.
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
------
# Excluindo registros de um fluxo de trabalho de correspondência baseado em regras ou em ML
Se precisar estar em conformidade com os regulamentos de gerenciamento de dados, você pode excluir os registros de um fluxo de trabalho de correspondência baseado em regras ou baseado em ML.
**Para excluir registros de um fluxo de trabalho de correspondência baseado em regras ou em ML**
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 ou baseado em ML.
1. Na página de detalhes do fluxo de trabalho correspondente, escolha **Excluir exclusivo** na IDs lista suspensa **Ações**.
1. Insira o ID exclusivo que você deseja excluir na IDs seção **Exclusivo**.
Você pode inserir até 10 exclusivos IDs.
1. Especifique a **fonte de entrada** da qual excluir o exclusivo IDs.
Se houver somente uma **fonte de entrada** para o fluxo de trabalho, a **fonte de entrada** será listada por padrão.
Se você especificar apenas uma **fonte de entrada**, a exclusiva IDs em outras fontes de entrada não será afetada.
1. Escolha **Excluir exclusivo IDs**.
# Solução de problemas de fluxos de trabalho correspondentes
Use as informações a seguir para ajudá-lo a diagnosticar e corrigir problemas comuns que você pode encontrar ao executar fluxos de trabalho correspondentes.
## Recebi um arquivo de erro depois de executar um fluxo de trabalho correspondente
### Causa comum
Um fluxo de trabalho correspondente pode ter várias execuções e os resultados (acertos ou erros) são gravados em uma pasta com o `jobId` como nome.
Os resultados bem-sucedidos de um fluxo de trabalho correspondente são gravados em uma `success` pasta que contém vários arquivos, e cada arquivo contém um subconjunto dos registros bem-sucedidos.
Os erros de um fluxo de trabalho correspondente são gravados em uma `error` pasta com vários campos, cada um contendo um subconjunto dos registros de erro.
O arquivo de erro pode ser criado pelos seguintes motivos:
+ O [ID exclusivo](glossary.md#unique-id-defn) é:
+ nulo
+ ausente em uma linha de dados
+ ausente em um registro na tabela de dados
+ repetido em outra linha de dados na tabela de dados
+ não especificado
+ não é exclusivo na mesma fonte
+ não é exclusivo em várias fontes
+ sobrepõe-se a todas as fontes
+ excede 38 caracteres (somente fluxo de trabalho de correspondência baseado em regras)
+ Um dos campos no [mapeamento do esquema](glossary.md#schema-mapping-definition) inclui um nome reservado:
+ EmailAddress
+ InputSourceARN
+ MatchRule
+ ID da partida
+ HashingProtocol
+ ConfidenceLevel
+ Fonte
**nota**
Se o registro no arquivo de erro for criado devido aos motivos listados anteriormente, você será cobrado, pois isso incorrerá no custo de processamento do serviço. Se o registro no arquivo de erro for causado por um erro interno do servidor, você não será cobrado.
### Resolução
**Para resolver esse problema**
1. Verifique se a [ID exclusiva](glossary.md#unique-id-defn) é válida.
Se a [ID exclusiva](glossary.md#unique-id-defn) não for válida, atualize a ID exclusiva em sua tabela de dados, salve a nova tabela de dados, crie um novo mapeamento de esquema e execute o fluxo de trabalho correspondente novamente.
1. Verifique se um dos campos no [mapeamento do esquema](glossary.md#schema-mapping-definition) inclui um nome reservado.
Se um dos campos incluir um nome reservado, crie um novo mapeamento de esquema com um novo nome e execute o fluxo de trabalho correspondente novamente.