Membuat alur kerja pencocokan berbasis aturan dengan tipe aturan Sederhana

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

Console

Untuk membuat alur kerja pencocokan berbasis aturan dengan tipe aturan Sederhana 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. Pada halaman Pencocokan alur kerja, 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 yang cocok dan deskripsi opsional.

   2. Untuk input Data, pilih AWS Glue database dari dropdown, pilih 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, batalkan pilihan opsi 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 Telepon 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 Data ini dienkripsi dengan opsi kunci KMS dan kemudian masukkan AWS KMS kunci yang akan digunakan untuk mendekripsi input data Anda.
      Gunakan peran layanan yang ada	Pilih nama peran layanan yang ada dari daftar tarik-turun. Daftar peran ditampilkan jika Anda memiliki izin untuk membuat daftar peran. Jika Anda tidak memiliki izin untuk membuat daftar peran, Anda dapat memasukkan Nama Sumber Daya Amazon (ARN) peran yang ingin Anda gunakan. Jika tidak ada peran layanan yang ada, opsi untuk Menggunakan peran layanan yang ada tidak tersedia. Lihat peran layanan dengan memilih tautan eksternal Lihat di 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 Pencocokan berbasis aturan.

   2. Untuk tipe Rule, pilih Simple.

      

   3. Untuk Memproses irama, pilih salah satu opsi berikut.

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

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

      catatan

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

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

      Secara default, alur kerja yang cocok dihasilkan IDs setelah data diindeks.

   5. Untuk aturan Pencocokan, masukkan nama Aturan dan kemudian pilih tombol Cocokkan untuk aturan itu.

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

      

   6. Untuk tipe 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 dengan satu bidang input	Bidang masukan tunggal

      

   7. Pilih Berikutnya.

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

   1. Untuk tujuan dan format keluaran Data, pilih lokasi Amazon S3 untuk output data dan apakah format Data akan dinormalisasi data atau Data asli.

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

   3. Lihat output yang dihasilkan Sistem.

   4. Untuk keluaran Data, tentukan bidang mana yang ingin Anda sertakan, sembunyikan, atau tutupi, lalu lakukan tindakan yang disarankan berdasarkan sasaran Anda.

      Tujuan Anda	Tindakan yang disarankan
      Sertakan bidang	Pertahankan status output sebagai Termasuk.
      Sembunyikan bidang (kecualikan dari output)	Pilih bidang Output, lalu pilih Sembunyikan.
      Bidang topeng	Pilih bidang Output, dan kemudian pilih output Hash.
      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 bahwa pekerjaan telah dimulai.

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

   • ID Job.

   • Status pekerjaan alur kerja yang cocok: Antrian, Sedang berlangsung, Selesai, Gagal

   • Waktu selesai untuk pekerjaan alur kerja.

   • Jumlah Rekaman yang diproses.

   • Jumlah Rekaman yang tidak diproses.

   • Pertandingan Unik IDs yang dihasilkan.

   • Jumlah catatan Input.

   Anda juga dapat melihat metrik pekerjaan untuk mencocokkan pekerjaan alur kerja yang sebelumnya telah dijalankan di bawah riwayat Job.

9. Setelah pekerjaan alur kerja yang cocok selesai (Status Selesai), Anda dapat pergi ke tab Output data dan kemudian pilih lokasi Amazon S3 Anda untuk melihat hasilnya.

10. (Hanya jenis pemrosesan manual) Jika Anda telah membuat alur kerja pencocokan berbasis Aturan 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 tipe aturan Simple 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 Referensi Resolusi Entitas AWS 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 yang cocok pola [A-za-Z_0-9-] *

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

   • outputSourceConfig(wajib) - Tepat satu konfigurasi sumber keluaran

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

   • roleArn(wajib) - ARN peran IAM untuk eksekusi alur kerja

   • ruleConditionProperties(wajib) - Daftar kondisi aturan dan nama aturan yang cocok.

   Parameter opsional meliputi:

   • description— Hingga 255 karakter

   • incrementalRunConfig— Konfigurasi tipe run inkremental

   • tags— Hingga 200 pasangan nilai kunci

5. (Opsional) Untuk menggunakan pemrosesan inkremental 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 memadai

   • 429 - ThrottlingException jika permintaan dibatasi

   • 500 - InternalServerException jika ada kegagalan layanan internal