View a markdown version of this page

Membuat alur kerja pencocokan berbasis aturan dengan tipe aturan sederhana - Resolusi Entitas AWS

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

Membuat alur kerja pencocokan berbasis aturan dengan tipe aturan sederhana

Prasyarat

Sebelum membuat alur kerja pencocokan berbasis aturan, Anda harus:

  1. Buat pemetaan skema. Untuk informasi selengkapnya, lihat Membuat pemetaan skema.

  2. Jika menggunakan Connect Customer Customer Profiles sebagai tujuan keluaran Anda, pastikan Anda telah mengonfigurasi izin yang sesuai.

Prosedur berikut menunjukkan cara membuat alur kerja pencocokan berbasis aturan dengan tipe aturan Sederhana menggunakan Kon Resolusi Entitas AWS sol atau CreateMatchingWorkflow API.

Console
Untuk membuat alur kerja pencocokan berbasis aturan dengan Sederhana jenis aturan 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. Pada halaman Alu r kerja Pencocokan, di sudut kanan atas, pilih Buat alur kerja yang cocok.

  4. Untuk Langkah 1: Tentukan detail alur kerja yang cocok, lakukan hal berikut:

    1. Masukkan nama alur kerja Pen coco kan dan Deskripsi opsional.

    2. Untuk input data, pilih AWS Glue database Wilayah AWS, AWS Glue tabel , dan kemudian pemetaan Skema yang sesuai.

      Anda dapat menambahkan hingga 19 input data.

    3. Opsi Normalisasi data dipilih secara default, sehingga input data dinormalisasi sebelum pencocokan. Jika Anda tidak ingin menormalkan data, hapus pilihan Normalisasi data.

      catatan

      Normalisasi hanya didukung untuk skenario berikut di Buat pemetaan skema:

      • Jika sub-tipe Nama berikut dikelompokkan: Nama depan, Nama tengah, Nama belakang.

      • Jika sub-tipe Alamat berikut dikelompokkan: Alamat jalan 1, Alamat jalan 2, Alamat jalan 3, Kota, Negara Bagian, Negara, Kode pos.

      • Jika sub-tipe Telep on berikut dikelompokkan: Nomor telepon, Kode negara telepon.

    4. Untuk menentukan izin akses Layanan, pilih opsi dan lakukan tindakan yang disarankan.

      Opsi Tindakan yang disarankan
      Membuat dan menggunakan peran layanan baru
      • Resolusi Entitas AWS membuat peran layanan dengan kebijakan yang diperlukan untuk tabel ini.

      • Nama peran Layanan default adalahentityresolution-matching-workflow-<timestamp>.

      • Anda harus memiliki izin untuk membuat peran dan melampirkan kebijakan.

      • Jika data input Anda dienkripsi, Anda dapat memilih opsi Data ini dienkripsi dengan kunci KMS dan kemudian memasukkan AWS KMS kunci yang akan digunakan untuk mendekripsi input data Anda.

      Menggunakan peran layanan yang ada
      1. Pilih nama peran layanan yang ada dari daftar dropdown.

        Daftar peran ditampilkan jika Anda memiliki izin untuk daftar peran.

        Jika Anda tidak memiliki izin untuk membuat daftar peran, Anda dapat memasukkan Nama Sumber Daya Amazon (ARN) dari peran yang ingin Anda gunakan.

        Jika tidak ada peran layanan yang ada, opsi untuk Menggunakan peran layanan yang ada tidak tersedia.

      2. Lihat peran layanan dengan memilih T ampilan di tautan eksternal IAM.

        Secara default, Resolusi Entitas AWS tidak mencoba memperbarui kebijakan peran yang ada untuk menambahkan izin yang diperlukan.

    5. (Opsional) Untuk mengaktifkan Tag untuk sumber daya, pilih Tambahkan tag baru, lalu masukkan pasangan Kunci dan Nilai.

    6. Pilih Berikutnya.

  5. Untuk Langkah 2: Pilih teknik pencocokan:

    1. Untuk Metode Pencocokan, pilih pen Rule-based cocokan.

    2. Untuk Jenis aturan, pilih Seder hana.

      Pilih layar teknik pencocokan dengan opsi pencocokan berbasis aturan sederhana dipilih.
    3. Untuk Memproses ir ama, pilih salah satu opsi berikut.

      • Pilih Manual untuk menjalankan alur kerja sesuai permintaan untuk pembaruan massal

      • Pilih Otom atis untuk menjalankan alur kerja segera setelah data baru ada di bucket S3 Anda

      catatan

      Jika Anda memilih Otom atis, pastikan Anda mengaktifkan EventBridge notifikasi Amazon untuk bucket S3 Anda. Untuk petunjuk tentang cara mengaktifkan Amazon EventBridge menggunakan konsol S3, lihat Mengaktifkan Amazon EventBridge di Panduan Pengguna Amazon S3.

    4. (Opsional) Untuk Indeks hanya untuk pemetaan ID, Anda dapat memilih untuk Akti fkan kemampuan untuk hanya mengindeks data dan tidak menghasilkan ID.

      Secara default, alur kerja pencocokan menghasilkan ID setelah data diindeks.

    5. Untuk Aturan Pencocokan, masukkan nama A turan, lalu pilih tombol Cocok kan untuk aturan tersebut.

      Anda dapat membuat hingga 15 aturan dan Anda dapat menerapkan hingga 15 kunci kecocokan yang berbeda di seluruh aturan Anda untuk menentukan kriteria kecocokan.

      Antarmuka aturan pencocokan dengan bidang untuk memasukkan nama aturan dan memilih kunci kecocokan.
    6. Untuk Jenis perbandingan, pilih salah satu opsi berikut berdasarkan tujuan Anda.

      Tujuan Anda Opsi yang disarankan
      Temukan kombinasi kecocokan di seluruh data yang disimpan di beberapa bidang input Beberapa bidang masukan
      Batasi perbandingan ke satu bidang input Bidang masukan tunggal
      Opsi jenis perbandingan: Beberapa bidang masukan untuk menemukan kecocokan di seluruh data yang disimpan di beberapa bidang, atau bidang input tunggal untuk membatasi perbandingan dalam satu bidang.
    7. Pilih Berikutnya.

  6. Untuk Langkah 3: Tentukan output data dan format:

    1. Untuk tujuan dan format keluaran data, pilih lokasi Amazon S3 untuk keluaran data dan apakah format Data akan menjadi Data Normalisasi atau Data Asli.

    2. Untuk Enkripsi, jika Anda memilih untuk Men yesuaikan pengaturan enkripsi, masukkan AWS KMS kunci ARN.

    3. Lihat output yang dihasilkan Sistem.

    4. Untuk Output Data, tentukan bidang mana yang ingin Anda sertakan, sembunyikan, atau disembunyikan, lalu lakukan tindakan yang disarankan berdasarkan tujuan Anda.

      Tujuan Anda Tindakan yang disarankan
      Sertakan bidang Pertahankan status output sebagai Ter masuk.
      Sembunyikan bidang (dikecualikan dari output) Pilih bidang Output, lalu pilih Sem bunyikan.
      Bidang topeng Pilih bidang Output, lalu pilih Hash output.
      Setel ulang pengaturan sebelumnya Pilih Reset.
    5. Pilih Berikutnya.

  7. Untuk Langkah 4: Tinjau dan buat:

    1. Tinjau pilihan yang Anda buat untuk langkah-langkah sebelumnya dan edit jika perlu.

    2. Pilih Buat dan jalankan.

      Sebuah pesan muncul, menunjukkan bahwa alur kerja yang cocok telah dibuat dan pekerjaan telah dimulai.

  8. Pada halaman detail alur kerja yang cocok, pada tab Metrik, lihat berikut ini di bawah Metrik pekerjaan terakhir:

    • ID Pekerjaan.

    • Status pekerjaan alur kerja yang cocok: An trian, Sed ang berlangsung, Sel esai, Gagal

    • Waktu selesai untuk pekerjaan alur kerja.

    • Jumlah Rekaman yang diproses.

    • Jumlah Catatan yang tidak diproses.

    • ID kec ocokan unik yang dihasilkan.

    • Jumlah catatan Input.

    Anda juga dapat melihat metrik pekerjaan untuk pekerjaan alur kerja yang cocok yang telah dijalankan sebelumnya di bawah Ri wayat pekerjaan.

  9. Setelah pekerjaan alur kerja pencocokan selesai (Status Selesai), Anda dapat membuka tab Output data dan kemudian memilih lokasi Amazon S3 Anda untuk melihat hasilnya.

  10. (Hanya jenis pemrosesan manual) Jika Anda telah membuat alur kerja yang Rule-based cocok dengan jenis pemrosesan manual, Anda dapat menjalankan alur kerja yang cocok kapan saja dengan memilih Jalankan alur kerja pada halaman detail alur kerja yang cocok.

API
Untuk membuat alur kerja pencocokan berbasis aturan dengan Sederhana jenis aturan menggunakan API
catatan

Secara default, alur kerja menggunakan pemrosesan standar (batch). Untuk menggunakan inkremental (pemrosesan otomatis, Anda harus mengkonfigurasinya secara eksplisit.

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

  2. Buat permintaan POST ke titik akhir berikut:

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

    catatan

    Untuk daftar lengkap bahasa pemrograman yang didukung, lihat Refer Resolusi Entitas AWS ensi API .

  4. Untuk badan permintaan, berikan parameter JSON yang diperlukan berikut:

    { "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" }

    Di mana:

    • workflowName(wajib) — Harus unik dan antara 1-255 karakter pola pencocokan [a-z A-Z _0-9-] *

    • inputSourceConfig(wajib) - Daftar 1-20 konfigurasi sumber input

    • outputSourceConfig(wajib) - Tepat satu konfigurasi sumber keluaran

    • resolutionTechniques(wajib) - Setel ke “RULE_MATCHING” untuk pencocokan berbasis aturan

    • roleArn(wajib) — Peran IAM ARN untuk eksekusi alur kerja

    • ruleConditionProperties(required) — Daftar kondisi aturan dan nama aturan yang cocok.

    Parameter opsional meliputi:

    • description— Hingga 255 karakter

    • incrementalRunConfig— Konfigurasi tipe run inkremental

    • tags— Hingga 200 pasangan kunci-nilai

  5. (Opsional) Untuk menggunakan pemrosesan tambahan alih-alih pemrosesan standar (batch) default, tambahkan parameter berikut ke badan permintaan:

    "incrementalRunConfig": { "incrementalRunType": "AUTOMATIC" }
  6. Kirim permintaan .

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

    { "workflowArn": "string", "workflowName": "string", // Plus all configured workflow details }
  8. Jika panggilan tidak berhasil, Anda mungkin menerima salah satu kesalahan berikut:

    • 400 — ConflictException jika nama alur kerja sudah ada

    • 400 - ValidationException jika input gagal validasi

    • 402 — ExceedsLimitException jika batas akun terlampaui

    • 403 — AccessDeniedException jika Anda tidak memiliki akses yang cukup

    • 429 - ThrottlingException jika permintaan dibatasi

    • 500 - InternalServerException jika ada kegagalan layanan internal