View a markdown version of this page

Memodifikasi atau menghasilkan 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 menghasilkan ID Pencocokan untuk alur kerja pencocokan berbasis aturan

ID Pen cocokan adalah pengidentifikasi yang dihasilkan oleh Resolusi Entitas AWS dan diterapkan ke setiap kumpulan rekaman yang cocok setelah alur kerja pencocokan dijalankan. Ini adalah bagian dari metadata alur kerja yang cocok yang disertakan dalam output.

Bila Anda perlu memperbarui catatan untuk pelanggan yang sudah ada atau menambahkan pelanggan baru ke dataset Anda, Anda dapat menggunakan Resolusi Entitas AWS konsol atau GenerateMatchId API. Memodifikasi ID kecocokan yang ada membantu menjaga konsistensi saat Anda memperbarui informasi pelanggan. Membuat ID kecocokan baru diperlukan saat Anda menambahkan pelanggan yang sebelumnya tidak dikenal ke sistem Anda.

catatan

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

Real-time persyaratan pencocokan

Untuk memanggil GenerateMatchId API pada alur kerja pen coco kan berbasis aturan Lanjutan, setel enableRealTimeMatching ketrue. Untuk al ur kerja pen cocokan Sederhana, pencocokan real-time selalu tersedia dan Anda tidak perlu menyetel tanda ini.

Anda tidak dapat mengaktifkan pencocokan waktu nyata pada alur kerja yang menggunakan salah satu dari berikut ini:

  • Atribut fuzzy:Cosine,Soundex, atau Levenshtein

  • EmptyValues=Ignore

Jika enableRealTimeMatching disetel ketrue, alur kerja tidak dapat digunakan dengan StartMatchingJob API untuk menjalankan pekerjaan alur kerja.

penting

Jika Anda mencabut Resolusi Entitas AWS izin ke bucket S3 Anda saat pekerjaan sedang berlangsung, Resolusi Entitas AWS akan tetap memproses dan mengenakan biaya untuk mengeluarkan hasil ke S3 tetapi tidak dapat mengirimkan hasilnya ke bucket Anda. Untuk menghindari masalah ini, pastikan Resolusi Entitas AWS memiliki izin yang benar untuk menulis ke bucket S3 Anda sebelum memulai pekerjaan. Jika izin dicabut selama pemrosesan, cobalah Resolusi Entitas AWS 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 memodifikasi 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/.

  2. Di panel navigasi kiri, di bawah Alur kerja, pilih Pen coco kan.

  3. Pilih alur kerja pencocokan berbasis aturan yang telah diproses (Status pekerjaan selesai).

  4. Pada halaman detail alur kerja yang cocok, pilih tab ID Pen cocokan.

  5. Pilih Ubah atau buat ID kecocokan.

    catatan

    Opsi Ubah atau buat ID keco cokan hanya tersedia untuk alur kerja pencocokan yang menggunakan ir ama pemrosesan otomatis. Jika Anda telah memilih ir ama pemrosesan manual, opsi ini akan tampak tidak aktif. Untuk menggunakan opsi ini, edit alur kerja Anda untuk menggunakan ir ama pemrosesan otomatis. Untuk informasi selengkapnya tentang alur kerja mengedit, 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 Pem rosesan.

    • Konsisten — Anda dapat mencari ID kecocokan yang ada atau membuat dan menyimpan ID kecocokan baru segera. Opsi ini memiliki akurasi tertinggi dan waktu respons yang lebih lambat.

    • Lat ar belakang (ditampilkan seperti EVENTUAL di API) — Anda dapat mencari ID kecocokan yang ada atau segera membuat 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 ID yang sudah ada. Catatan yang diperbarui disimpan di latar belakang. Opsi ini memiliki respons tercepat. Disarankan hanya untuk catatan unik.

  8. Untuk atribut Rekaman,

    1. Masukkan Nilai untuk ID Unik.

    2. Masukkan Nilai untuk setiap kunci Pen cocokan 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 yang sesuai dan aturan terkait yang disimpan ke alur kerja pencocokan dalam pesan sukses.

  11. (Opsional) Untuk menyalin ID kecocokan, pilih Salin.

API
Untuk memodifikasi atau menghasilkan ID Pencocokan menggunakan API
catatan

Agar berhasil memanggil API ini, Anda harus berhasil menjalankan alur kerja pencocokan berbasis aturan terlebih dahulu menggunakan StartMatchingJob API.

Untuk daftar lengkap bahasa pemrograman yang didukung, lihat bagian Lihat Juga dari 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 AndaworkflowName.

    Yang workflowName harus:

    • Panjang antara 1 dan 255 karakter

    • Cocokkan pola [a-z A-Z _0-9-] *

  5. Untuk badan permintaan, berikan JSON berikut: 

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

    Di mana:

    • processingType(opsional) - Defaultnya. CONSISTENT Pilih salah satu dari nilai-nilai ini:

      • CONSISTENT- Untuk akurasi tertinggi dengan waktu respons yang lebih lambat

      • EVENTUAL- Untuk respon awal yang lebih cepat dengan pemrosesan latar belakang

      • EVENTUAL_NO_LOOKUP- Untuk respon tercepat ketika catatan diketahui unik

    • records(wajib) - Array berisi persis 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 cukup

    • 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