

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Memodifikasi atau membuat ID Pencocokan untuk alur kerja pencocokan berbasis aturan
<a name="generate-match-id"></a>

*ID Pencocokan* adalah pengidentifikasi yang dihasilkan oleh Resolusi Entitas AWS dan diterapkan ke setiap set rekaman yang cocok setelah alur kerja yang cocok dijalankan. Ini adalah bagian dari metadata alur kerja yang cocok yang disertakan dalam output.

Saat Anda perlu memperbarui catatan untuk pelanggan yang sudah ada atau menambahkan pelanggan baru ke kumpulan data Anda, Anda dapat menggunakan Resolusi Entitas AWS konsol atau `GenerateMatchID` API. Memodifikasi ID kecocokan yang ada membantu menjaga konsistensi saat memperbarui informasi pelanggan, sementara membuat ID kecocokan baru diperlukan saat menambahkan pelanggan yang sebelumnya tidak dikenal ke sistem Anda.

**catatan**  
Biaya tambahan berlaku, apakah Anda menggunakan konsol atau API. Jenis pemrosesan yang Anda pilih memengaruhi akurasi dan waktu respons operasi.

**penting**  
Jika Anda mencabut Resolusi Entitas AWS izin ke bucket S3 saat pekerjaan sedang berlangsung, masih Resolusi Entitas AWS akan memproses dan mengenakan biaya untuk mengeluarkan hasil ke S3 tetapi tidak dapat memberikan hasilnya ke bucket Anda. Untuk menghindari masalah ini, pastikan bahwa Resolusi Entitas AWS memiliki izin yang benar untuk menulis ke bucket S3 Anda sebelum memulai pekerjaan. Jika izin dicabut selama pemrosesan, Resolusi Entitas AWS cobalah untuk mengirimkan kembali hasil hingga 30 hari setelah pekerjaan selesai setelah Anda memulihkan izin bucket yang benar.

Prosedur berikut memandu Anda melalui proses mencari atau membuat ID Pencocokan, memilih jenis pemrosesan, dan melihat hasilnya. 

------
#### [ Console ]

**Untuk mengubah atau membuat ID Pencocokan menggunakan konsol**

1. Masuk ke Konsol Manajemen AWS dan buka Resolusi Entitas AWS konsol di [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/).

1. **Di panel navigasi kiri, di bawah **Alur Kerja**, pilih Pencocokan.**

1. **Pilih alur kerja pencocokan berbasis aturan yang telah diproses (**Status Job Selesai**).**

1. Pada halaman detail alur kerja yang cocok, pilih IDs tab **Cocokkan**.

1. Pilih **Ubah atau buat ID kecocokan**.
**catatan**  
Opsi **Ubah atau buat ID kecocokan** hanya tersedia untuk alur kerja yang cocok yang menggunakan irama pemrosesan **Otomatis**. Jika Anda telah memilih irama pemrosesan **Manual**, opsi ini akan muncul tidak aktif. Untuk menggunakan opsi ini, edit alur kerja Anda untuk menggunakan irama pemrosesan **otomatis**. Untuk informasi selengkapnya tentang mengedit alur kerja, lihat[Mengedit alur kerja yang cocok](edit-matching-workflow.md).

1. Pilih **AWS Glue tabel dari daftar** dropdown.

   Jika hanya ada satu AWS Glue tabel dalam alur kerja, itu dipilih secara default.

1. Pilih **jenis Processing**.
   + **Konsisten** — Anda dapat mencari ID kecocokan yang ada atau membuat dan menyimpan ID kecocokan baru dengan segera. Opsi ini memiliki akurasi tertinggi dan waktu respons yang lebih lambat.
   + **Latar Belakang** (ditampilkan seperti `EVENTUAL` di API) — Anda dapat mencari ID kecocokan yang ada atau segera menghasilkan ID kecocokan baru. Catatan yang diperbarui disimpan di latar belakang. Opsi ini memiliki respons awal yang cepat, dengan hasil lengkap tersedia di S3 nanti.
   + **Pembuatan ID cepat** (ditampilkan seperti `EVENTUAL_NO_LOOKUP` di API) - Anda dapat membuat ID kecocokan baru tanpa mencari yang sudah ada. Catatan yang diperbarui disimpan di latar belakang. Opsi ini memiliki respons tercepat. Disarankan hanya untuk catatan unik.

1. Untuk **atribut Rekam**, 

   1. Masukkan **Nilai** untuk **ID Unik**.

   1. Masukkan **Nilai** untuk setiap **tombol Pencocokan** yang akan cocok dengan catatan yang ada berdasarkan aturan yang dikonfigurasi dalam alur kerja Anda.

1. Pilih **Temukan ID kecocokan dan simpan catatan**.

   Pesan sukses muncul, yang menyatakan bahwa ID Pencocokan ditemukan atau ID Pencocokan baru dibuat dan catatan disimpan. 

1. Lihat ID Pencocokan terkait dan aturan terkait yang disimpan ke alur kerja yang cocok dalam pesan sukses. 

1. (Opsional) Untuk menyalin ID kecocokan, pilih **Salin**. 

------
#### [ API ]

**Untuk memodifikasi atau membuat ID Pencocokan menggunakan API**
**catatan**  
[Agar berhasil memanggil API ini, Anda harus terlebih dahulu berhasil menjalankan alur kerja pencocokan berbasis aturan menggunakan API. StartMatchingJob ](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_StartMatchingJob.html)   
Untuk daftar lengkap bahasa pemrograman yang didukung, [lihat Lihat juga](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GenerateMatchId.html#API_GenerateMatchId_SeeAlso) bagian [GenerateMatchID](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GenerateMatchId.html).

1. Buka terminal atau command prompt untuk membuat permintaan API.

1. Buat permintaan POST ke titik akhir berikut: 

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

1. Di header permintaan, atur Content-type ke application/json. 

1. Dalam URI permintaan, tentukan file Anda`workflowName`. 

   `workflowName`Keharusan: 
   + Panjangnya antara 1 dan 255 karakter 
   + Cocokkan pola [A-za-Z\_0-9-] \*

1. Untuk badan permintaan, berikan JSON berikut: 

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

   Di mana: 
   + `processingType`(opsional) - Default ke. `CONSISTENT` Pilih salah satu dari nilai-nilai ini: 
     + `CONSISTENT`- Untuk akurasi tertinggi dengan waktu respons yang lebih lambat 
     + `EVENTUAL`- Untuk respons awal yang lebih cepat dengan pemrosesan latar belakang 
     + `EVENTUAL_NO_LOOKUP`- Untuk respons tercepat ketika catatan diketahui unik 
   + `records`(wajib) - Array yang berisi tepat satu objek rekaman

1. Kirim permintaan . 

   Jika berhasil, Anda akan menerima respons dengan kode status 200 dan badan JSON yang berisi:

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

   Jika panggilan tidak berhasil, Anda mungkin menerima salah satu kesalahan berikut:
   + 403 - AccessDeniedException jika Anda tidak memiliki akses yang memadai
   + 404 - ResourceNotFoundException jika sumber daya tidak dapat ditemukan
   + 429 - ThrottlingException jika permintaan dibatasi
   + 400 - ValidationException jika input gagal validasi
   + 500 - InternalServerException jika ada kegagalan layanan internal

------