Memetakan metode Data Catalog API ke Knowledge Catalog

Data Catalog tidak digunakan lagi. Jika Anda memigrasikan alur kerja, skrip, library klien, atau konfigurasi Terraform 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 mengetahui proses migrasi langkah demi langkah, lihat Transisi dari Data Catalog ke Knowledge Catalog. Untuk dokumentasi referensi API, lihat dokumentasi REST Dataplex API dan dokumentasi RPC Dataplex API.

Pemetaan resource

Tabel berikut menjelaskan bagaimana resource di Data Catalog sesuai 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. Template tag sesuai dengan jenis globalaspek 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 penampung organisasi dan keamanan di kedua layanan. Untuk Google Cloud sumber, grup entri sistem seperti @bigquery dibuat secara otomatis per project.
Entri kustom	Entri kustom (dengan aspek yang diperlukan)	Properti entri kustom standar dimodelkan sebagai aspek yang diperlukan ditentukan oleh EntryType entri kustom.
Entri sistem (Google Cloud)	Entri sistem (dengan aspek yang diperlukan)	Metadata yang menjelaskan entitas bawaan (seperti Schema untuk tabel BigQuery) diambil dalam aspek yang diperlukan dari jenis aspek yang ditentukan sistem.
Glosarium bisnis	Glosarium bisnis	Taksonomi istilah bisnis yang menstandarkan konteks bisnis di seluruh perusahaan.

Perbandingan fitur

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

Fitur	Knowledge Catalog	Data Catalog
Sumber yang didukung Google Cloud	Semua sumber yang dijelaskan di Sumber yang didukung Google Cloud .	Semua sumber yang dijelaskan dalam dokumentasi Data Catalog.
Penyerapan sumber kustom	Penyerapan ke dalam entri kustom dengan struktur yang diatur yang ditentukan oleh jenis entri. Grup entri dan entri kustom Data Catalog tersedia di Knowledge Catalog di bagian jenis entri generic.	Penyerapan ke dalam entri kustom generik.
Pengayaan metadata	Diambil menggunakan glosarium bisnis, aspek, dan jenis aspek. Link entri didukung. Anda dapat melampirkan aspek langsung ke entri link.	Diambil 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 hampir real-time yang di-streaming ke Pub/Sub.	Tidak tersedia.
Penelusuran	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 dibuat di Data Catalog.
Silsilah data	Mengambil detail entri untuk node aset menggunakan Dataplex API. Menampilkan aspek terlampir di Google Cloud konsol.	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 memberikan 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 mewakili 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 untuk 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 dikeluarkan secara terpisah per organisasi.

Template tag dan jenis aspek

Jenis aspek adalah penerus 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 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 dalam 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 penerus 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 dan taksonomi kebijakan

API untuk tag dan taksonomi kebijakan tidak berubah dan tidak memerlukan migrasi.

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 terbawa. Anda harus mengonfigurasi izin IAM untuk resource yang diimpor. Untuk perbandingan mendetail tentang izin lama dan pengganti, lihat Memetakan izin IAM antara Data Catalog dan Knowledge Catalog.
• Hasil pemeriksaan Sensitive Data Protection: Pengiriman hasil pemeriksaan Sensitive Data Protection langsung ke Knowledge Catalog tidak didukung. Sebagai gantinya, kirim hasil pemeriksaan ke Data Catalog dan transisikan hasilnya ke Knowledge Catalog.
• Pencantuman jenis lintas project: Pencantuman jenis entri, 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 (recall penuh) tidak didukung. Sebagai gantinya, ekspor metadata ke Cloud Storage dan kueri menggunakan BigQuery.

Langkah berikutnya

Panduan

Transisi 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 REST API Dataplex

Pelajari dokumentasi referensi API REST untuk layanan Dataplex Catalog.

Referensi

Referensi RPC API Dataplex

Pelajari dokumentasi referensi API gRPC untuk layanan Dataplex Catalog.