Memetakan metode Data Catalog API ke Knowledge Catalog

Data Catalog tidak digunakan lagi. Jika Anda memigrasikan alur kerja, skrip, library klien, atau konfigurasi Terraform secara terprogram dari Data Catalog ke Knowledge Catalog, Anda harus memperbarui kode untuk menggunakan Dataplex API.

Dokumen ini memberikan pemetaan komprehensif resource, fitur, dan metode API Data Catalog ke padanannya di Dataplex API.

Untuk proses migrasi langkah demi langkah, lihat Beralih dari Data Catalog ke Knowledge Catalog. Untuk dokumentasi referensi API, lihat dokumentasi REST API Dataplex dan dokumentasi RPC API Dataplex.

Pemetaan resource

Tabel berikut menjelaskan korespondensi resource di Data Catalog dengan resource di Knowledge Catalog:

Resource Data Catalog	Resource Knowledge Catalog	Deskripsi
Template tag publik	Jenis aspek (global)	Template tag adalah resource regional di Data Catalog yang dapat digunakan di seluruh region. Entitas ini sesuai dengan jenis aspek global di Knowledge Catalog.
Tag publik	Aspek opsional	Tag publik sesuai dengan aspek opsional yang dilampirkan ke entri atau kolom di Knowledge Catalog.
Grup entri	Grup entri	Grup entri berfungsi sebagai container organisasi dan keamanan di kedua layanan. Untuk sumber Google Cloud , grup entri sistem seperti @bigquery dibuat secara otomatis per project.
Entri kustom	Entri kustom (dengan aspek wajib)	Properti entri kustom standar dimodelkan sebagai aspek wajib yang ditentukan oleh EntryType entri kustom.
Entri Sistem (Google Cloud)	Entri sistem (dengan aspek yang diperlukan)	Metadata yang menjelaskan entity bawaan (seperti Schema untuk tabel BigQuery) dicatat dalam aspek yang diperlukan dari jenis aspek yang ditentukan sistem.
Glosarium bisnis	Glosarium bisnis	Taksonomi istilah bisnis yang menstandardisasi konteks bisnis di seluruh perusahaan.

Perbandingan fitur

Tabel berikut membandingkan kemampuan pengelolaan metadata Knowledge Catalog dan Data Catalog:

Fitur	Knowledge Catalog	Data Catalog
Sumber Google Cloud yang didukung	Semua sumber yang dijelaskan di Sumber yang didukung Google Cloud .	Semua sumber dijelaskan dalam dokumentasi Data Catalog.
Penyerapan sumber kustom	Penyerapan ke dalam entri kustom dengan struktur yang diatur yang ditentukan oleh jenis entri. Entri kustom dan grup entri Data Catalog tersedia di Knowledge Catalog dengan jenis entri generic.	Penyerapan ke entri kustom generik.
Pengayaan metadata	Diperoleh menggunakan glosarium bisnis, aspek, dan jenis aspek. Link entri didukung. Anda dapat melampirkan aspek langsung ke link entri.	Diperoleh menggunakan glosarium bisnis, tag, dan template tag. Link entri tidak didukung.
Link entri	Didukung. Jenis bawaan seperti synonym, definition, related, dan schema-join memungkinkan Anda menghubungkan entri dan kolom.	Tidak tersedia.
Feed perubahan metadata	Notifikasi perubahan metadata mendekati real-time yang di-streaming ke Pub/Sub.	Tidak tersedia.
Telusuri	Penelusuran dilakukan di semua sumber Google Cloud yang didukung, entri kustom, aspek, dan konten Data Catalog yang dimigrasikan dalam organisasi dan perimeter Kontrol Layanan VPC yang sama.	Penelusuran dilakukan di sumber yang didukung, entri kustom, dan tag yang dibuat di Data Catalog.
Silsilah data	Mengambil detail entri untuk node aset menggunakan Dataplex API. Menampilkan aspek terlampir di konsol Google Cloud .	Mengambil detail entri menggunakan Data Catalog API.
Glosarium bisnis	Memungkinkan Anda membuat taksonomi istilah bisnis dan mengaitkannya dengan aset data (entri) dan kolom.	Memungkinkan Anda mengaitkan istilah dengan kolom.

Memetakan metode Data Catalog API ke Knowledge Catalog

Tabel berikut menyediakan pemetaan metode demi metode antara Data Catalog API (google.cloud.datacatalog.v1) dan Dataplex API (google.cloud.dataplex.v1.CatalogService).

Grup entri

Konsep grup entri konsisten di kedua layanan:

Metode Data Catalog API	Metode Dataplex API
projects.locations.entryGroups.create (REST) CreateEntryGroup (RPC)	projects.locations.entryGroups.create (REST) CreateEntryGroup (RPC)
projects.locations.entryGroups.get (REST) GetEntryGroup (RPC)	projects.locations.entryGroups.get (REST) GetEntryGroup (RPC)
projects.locations.entryGroups.patch (REST) UpdateEntryGroup (RPC)	projects.locations.entryGroups.patch (REST) UpdateEntryGroup (RPC)
projects.locations.entryGroups.delete (REST) DeleteEntryGroup (RPC)	projects.locations.entryGroups.delete (REST) DeleteEntryGroup (RPC)
projects.locations.entryGroups.list (REST) ListEntryGroups (RPC)	projects.locations.entryGroups.list (REST) ListEntryGroups (RPC)

Entri

Konsep entri, yang merepresentasikan aset data, konsisten di kedua layanan:

Metode Data Catalog API	Metode Dataplex API
projects.locations.entryGroups.entries.create (REST) CreateEntry (RPC)	projects.locations.entryGroups.entries.create (REST) CreateEntry (RPC)
projects.locations.entryGroups.entries.get (REST) GetEntry (RPC)	projects.locations.entryGroups.entries.get (REST) GetEntry (RPC)
projects.locations.entryGroups.entries.patch (REST) UpdateEntry (RPC)	projects.locations.entryGroups.entries.patch (REST) UpdateEntry (RPC) Catatan: Anda juga dapat menggunakan metode projects.locations.modifyEntry (REST) dan ModifyEntry (RPC) untuk memperbarui entri sistem menggunakan izin sistem sumber, bukan izin katalog.
projects.locations.entryGroups.entries.delete (REST) DeleteEntry (RPC)	projects.locations.entryGroups.entries.delete (REST) DeleteEntry (RPC)
projects.locations.entryGroups.entries.list (REST) ListEntries (RPC)	projects.locations.entryGroups.entries.list (REST) ListEntries (RPC)
entries.lookup (REST) LookupEntry (RPC)	projects.locations.lookupEntry (REST) LookupEntry (RPC) Catatan: Untuk menggunakan lookupEntry, Anda harus memberikan nama entri. Untuk menerjemahkan nama SQL BigQuery, nama yang sepenuhnya memenuhi syarat, atau nama resource tertaut ke nama entri, panggil projects.locations.searchEntries (REST) atau SearchEntries (RPC) terlebih dahulu.
projects.locations.entryGroups.entries.modifyEntryContacts (REST) ModifyEntryContacts (RPC)	projects.locations.entryGroups.entries.patch (REST) UpdateEntry (RPC) Catatan: Gunakan update_mask untuk mengubah hanya aspek contacts.
projects.locations.entryGroups.entries.modifyEntryOverview (REST) ModifyEntryOverview (RPC)	projects.locations.entryGroups.entries.patch (REST) UpdateEntry (RPC) Catatan: Gunakan update_mask untuk mengubah hanya aspek overview.
projects.locations.entryGroups.entries.tags.reconcile (REST) ReconcileTags (RPC)	projects.locations.metadataJobs.create (REST) CreateMetadataJob (RPC), projects.locations.entryGroups.entries.patch (REST) UpdateEntry (RPC) Catatan: Gunakan CreateMetadataJob dengan jenis pekerjaan impor untuk mengimpor konten metadata untuk beberapa entri dalam batch. Untuk memperbarui semua aspek satu entri, gunakan UpdateEntry.
catalog.search (REST) SearchCatalog (RPC)	projects.locations.searchEntries (REST) SearchEntries (RPC) Catatan: searchEntries menelusuri dalam organisasi pemanggil. Penelusuran lintas organisasi harus dilakukan secara terpisah per organisasi.

Template tag dan jenis aspek

Jenis aspek adalah pengganti template tag Data Catalog:

Metode Data Catalog API	Metode Dataplex API
projects.locations.tagTemplates.create (REST) CreateTagTemplate (RPC)	projects.locations.aspectTypes.create (REST) CreateAspectType (RPC)
projects.locations.tagTemplates.get (REST) GetTagTemplate (RPC)	projects.locations.aspectTypes.get (REST) GetAspectType (RPC)
projects.locations.tagTemplates.patch (REST) UpdateTagTemplate (RPC)	projects.locations.aspectTypes.patch (REST) UpdateAspectType (RPC)
projects.locations.tagTemplates.delete (REST) DeleteTagTemplate (RPC)	projects.locations.aspectTypes.delete (REST) DeleteAspectType (RPC)
catalog.search (REST) dengan type=tag_template SearchCatalog (RPC) dengan type=tag_template	projects.locations.aspectTypes.list (REST) ListAspectTypes (RPC)

Kolom template tag

Kolom template tag sesuai dengan konten kolom metadata_template dalam jenis aspek. Gunakan UpdateAspectType dengan metadata_template yang telah diubah untuk membuat, memperbarui, mengganti nama, atau menghapus kolom:

Metode Data Catalog API	Metode Dataplex API
projects.locations.tagTemplates.fields.create (REST) CreateTagTemplateField (RPC)	projects.locations.aspectTypes.patch (REST) UpdateAspectType (RPC)
projects.locations.tagTemplates.fields.patch (REST) UpdateTagTemplateField (RPC)	projects.locations.aspectTypes.patch (REST) UpdateAspectType (RPC)
projects.locations.tagTemplates.fields.rename (REST) RenameTagTemplateField (RPC)	projects.locations.aspectTypes.patch (REST) UpdateAspectType (RPC)
projects.locations.tagTemplates.fields.delete (REST) DeleteTagTemplateField (RPC)	projects.locations.aspectTypes.patch (REST) UpdateAspectType (RPC)

Nilai enum kolom template tag

Ubah nilai enum dengan memperbarui kolom metadata_template di jenis aspek yang sesuai:

Metode Data Catalog API	Metode Dataplex API
projects.locations.tagTemplates.fields.enumValues.rename (REST) RenameTagTemplateFieldEnumValue (RPC)	projects.locations.aspectTypes.patch (REST) UpdateAspectType (RPC)

Tag dan aspek

Aspek adalah pengganti tag Data Catalog. Aspek dienkapsulasi langsung dalam entri induk atau link entri, dan dikelola menggunakan metode UpdateEntry dengan update_mask:

Metode Data Catalog API	Metode Dataplex API
projects.locations.entryGroups.entries.tags.create (REST) CreateTag (RPC)	projects.locations.entryGroups.entries.patch (REST) UpdateEntry (RPC)
projects.locations.entryGroups.entries.tags.list (REST) ListTags (RPC)	projects.locations.entryGroups.entries.get (REST) GetEntry (RPC) Catatan: Untuk memfilter aspek dalam respons, gunakan parameter views, aspect_types, dan paths.
projects.locations.entryGroups.entries.tags.patch (REST) UpdateTag (RPC)	projects.locations.entryGroups.entries.patch (REST) UpdateEntry (RPC)
projects.locations.entryGroups.entries.tags.delete (REST) DeleteTag (RPC)	projects.locations.entryGroups.entries.patch (REST) UpdateEntry (RPC)

Tag kebijakan dan taksonomi

API untuk tag kebijakan dan taksonomi tidak berubah dan tidak memerlukan migrasi. Iklan tersebut terus ditayangkan di endpoint datacatalog.googleapis.com (layanan Policy Tag Manager). Data Catalog API (datacatalog.googleapis.com) harus tetap diaktifkan di project yang menggunakan kontrol akses tingkat kolom BigQuery atau penyamaran data dinamis.

Fitur yang tidak didukung di Knowledge Catalog

Perilaku dan fitur Data Catalog berikut tidak didukung atau beroperasi secara berbeda di Knowledge Catalog:

• Jenis aspek pribadi: Konsep aspek pribadi dan jenis aspek pribadi (padanan untuk tag pribadi dan template tag pribadi di Data Catalog) tidak ada. Semua jenis aspek kustom diatur oleh izin Identity and Access Management project dan grup entri.
• Penelusuran tag kebijakan: Penelusuran tag kebijakan menggunakan predikat policytag atau policytagid tidak didukung dalam penelusuran katalog.
• Transfer izin: Saat Anda mengimpor grup entri kustom, entri kustom, template tag, dan tag Data Catalog ke Knowledge Catalog, izin aslinya tidak akan ditransfer. Anda harus mengonfigurasi izin IAM untuk resource yang diimpor. Untuk perbandingan mendetail izin lama dan izin pengganti, lihat Memetakan izin IAM antara Data Catalog dan Knowledge Catalog.
• Hasil pemeriksaan Sensitive Data Protection: Mengirimkan hasil pemeriksaan Sensitive Data Protection langsung ke Knowledge Catalog tidak didukung. Sebagai gantinya, kirim hasil pemeriksaan ke Data Catalog dan alihkan hasil tersebut ke Knowledge Catalog.
• Listingan jenis lintas project: Jenis entri listingan, jenis link entri, dan jenis aspek di seluruh project dalam satu panggilan API tidak didukung; permintaan harus dicakup ke satu project.
• Penelusuran administrator: Penelusuran administrator (panggilan ulang penuh) tidak didukung. Sebagai gantinya, ekspor metadata ke Cloud Storage dan kueri menggunakan BigQuery.

Langkah berikutnya

Panduan

Bertransisi dari Data Catalog

Panduan langkah demi langkah untuk memigrasikan template tag, entri kustom, dan alur kerja.

Konsep

Tentang metadata di Knowledge Catalog

Pelajari metamodel fleksibel Knowledge Catalog dan Active Context Graph.

Referensi

Referensi Dataplex REST API

Jelajahi dokumentasi referensi API REST untuk layanan Dataplex Catalog.

Referensi

Referensi Dataplex RPC API

Jelajahi dokumentasi referensi API gRPC untuk layanan Dataplex Catalog.