Memodifikasi atau membuat ID Pencocokan untuk alur kerja pencocokan berbasis aturan - Resolusi Entitas AWS

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

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 upaya 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 AWS Management Console dan buka Resolusi Entitas AWS konsol di https://console.aws.amazon.com/entityresolution/.

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

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

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

  5. 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, lihatMengedit alur kerja yang cocok.

  6. Pilih AWS Glue tabel dari daftar dropdown.

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

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

  8. Untuk atribut Rekam,

    1. Masukkan Nilai untuk ID Unik.

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

  9. Pilih Temukan ID kecocokan dan simpan catatan.

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

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

  11. (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

Untuk daftar lengkap bahasa pemrograman yang didukung, lihat Lihat juga bagian GenerateMatchID.

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

  2. Buat permintaan POST ke titik akhir berikut: 

    /matchingworkflows/workflowName/generateMatches

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

  4. Dalam URI permintaan, tentukan file AndaworkflowName.

    workflowNameKeharusan:

    • Panjangnya antara 1 dan 255 karakter

    • Cocokkan pola [A-za-Z_0-9-] *

  5. 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 respon tercepat ketika catatan diketahui unik

    • records(wajib) - Array yang berisi tepat satu objek rekaman

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