Memecahkan masalah feed perubahan metadata

Dokumen ini membantu Anda memecahkan masalah dan menyelesaikan masalah umum terkait feed perubahan metadata Katalog Universal Dataplex.

Error pembuatan feed perubahan metadata

Bagian ini menjelaskan cara mengatasi error yang mungkin Anda alami saat membuat feed perubahan metadata.

Error izin ditolak

Anda menerima error PERMISSION_DENIED saat mencoba membuat feed perubahan metadata.

Masalah ini terjadi karena Anda atau akun layanan Dataplex Universal Catalog mungkin tidak memiliki izin yang diperlukan.

Untuk mengatasi masalah ini, tinjau persyaratan berikut:

  • Pastikan Anda memiliki izin dataplex.metadataFeeds.create.

  • Pastikan Anda memiliki izin dataplex.entryGroups.export pada cakupan feed (Organisasi, Project, atau Grup Entri).

  • Pastikan akun layanan Dataplex Universal Catalog (service-{PROJECT_NUMBER}@gcp-sa-dataplex.iam.gserviceaccount.com) memiliki peran roles/pubsub.publisher di topik Pub/Sub tujuan.

Error Kontrol Layanan VPC

Anda menerima error PERMISSION_DENIED atau Kontrol Layanan VPC saat membuat feed.

Untuk mengatasi masalah ini, periksa apakah feed perubahan metadata dan resource yang dipantaunya termasuk dalam perimeter Kontrol Layanan VPC yang sama:

  • Jika feed memiliki cakupan organisasi, hanya project dalam perimeter yang sama yang dipantau.

  • Jika feed memiliki cakupan project atau grup entri, pastikan semua project atau grup entri yang ditentukan berada dalam perimeter yang sama dengan project tempat Anda membuat feed.

Masalah pengiriman notifikasi

Bagian ini menjelaskan cara mengatasi masalah pengiriman notifikasi.

Tidak menerima notifikasi

Anda tidak menerima notifikasi di topik Pub/Sub. Hal ini dapat disebabkan oleh beberapa faktor:

  • Izin tidak ada: akun layanan Dataplex Universal Catalog kehilangan peran roles/pubsub.publisher pada topik.

  • Penundaan aktivasi: feed yang baru dibuat atau diperbarui dapat memerlukan waktu hingga 10 menit untuk menjadi aktif.

  • Topik dihapus: jika topik Pub/Sub tujuan dihapus, Dataplex Universal Catalog berhenti memublikasikan.

  • Ketidakcocokan cakupan atau filter: perubahan mungkin tidak sesuai dengan cakupan atau filter yang dikonfigurasi.

Untuk mengatasi masalah ini, periksa hal-hal berikut:

  • Pastikan akun layanan Dataplex Universal Catalog memiliki peran roles/pubsub.publisher pada topik.

  • Tunggu setidaknya 10 menit setelah membuat atau memperbarui feed.

  • Periksa apakah topik Pub/Sub ada. Jika dihapus, Anda harus membuatnya ulang.

  • Tinjau konfigurasi feed Anda untuk memastikan cakupan dan filter cocok dengan perubahan metadata yang diharapkan.

Notifikasi duplikat

Anda menerima pesan notifikasi duplikat. Katalog Universal Dataplex memastikan pengiriman "setidaknya sekali", yang berarti pesan duplikat dapat terjadi, terutama selama percobaan ulang.

Konfigurasi aplikasi pelanggan Anda untuk menangani potensi duplikat. Anda dapat menggunakan messageId atau stempel waktu perubahan untuk mengidentifikasi dan menghapus duplikat pesan.

Masalah konten

Bagian ini menjelaskan cara menyelesaikan masalah terkait konten notifikasi feed perubahan metadata.

Metadata lengkap tidak ada dalam payload

Pesan notifikasi hanya berisi nama resource dan jenis perubahan, tetapi tidak berisi metadata lengkap atau perubahan spesifik.

Hal ini karena menurut desainnya, notifikasi feed perubahan metadata memberikan "tanda tangan perubahan" (apa yang berubah), bukan payload lengkap. Hal ini membuat pesan berukuran kecil dan menghindari batas ukuran payload.

Gunakan nama resource yang diberikan dalam notifikasi untuk memanggil Dataplex Universal Catalog API (misalnya, GetEntry) dan mengambil status resource saat ini.