Perubahan pada metadata yang disimpan di Dataplex Universal Catalog

Antara 12 Januari 2026 dan 2 Februari 2026, beberapa metadata yang disimpan di Dataplex Universal Catalog akan berubah.

Perubahan ini membuat metadata yang disimpan di Katalog Universal Dataplex konsisten dengan metadata dari sistem sumber asli.

Jika beban kerja Anda termasuk dalam cakupan perubahan yang dijelaskan di bagian berikutnya, ikuti petunjuk dalam dokumen ini.

Cakupan perubahan

Perubahan yang dijelaskan di bagian ini berlaku untuk entri dari sistem sumber berikut:

  • Vertex AI
  • Bigtable
  • Spanner
  • Pub/Sub
  • Dataform
  • Dataproc Metastore

Metode Dataplex API berikut terpengaruh oleh perubahan ini:

Nama resource

Nama resource berubah untuk kolom entri tingkat teratas entrySource.resource. Kolom diubah agar berisi nama resource relatif, bukan nama resource lengkap dengan API. Awalan //<service_name>.googleapis.com/ dihapus dari nama resource. Tabel berikut mencantumkan beberapa contoh sampel.

Sistem Sumber Nilai sebelum perubahan Nilai setelah perubahan
Vertex AI //aiplatform.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/REMAINING_PATH
Contoh: //aiplatform.googleapis.com/projects/test-project-id/locations/us-central1/featureOnlineStores/test-store		 projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/REMAINING_PATH
Contoh: projects/test-project-id/locations/us-central1/featureOnlineStores/test-store
Bigtable //bigtable.googleapis.com/projects/PROJECT_ID/instances/INSTANCE_ID/tables/TABLE_ID
Contoh: //bigtable.googleapis.com/projects/test-project-id/instances/test-instance/tables/test-table		 projects/PROJECT_ID/instances/INSTANCE_ID/tables/TABLE_ID
Contoh: projects/test-project-id/instances/test-instance/tables/test-table
Spanner //spanner.googleapis.com/projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID
Contoh: //spanner.googleapis.com/projects/test-project-id/instances/test-instance/databases/test-database		 projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID
Contoh: projects/test-project-id/instances/test-instance/databases/test-database
Pub/Sub //pubsub.googleapis.com/projects/PROJECT_ID/topics/TOPIC_ID
Contoh: //pubsub.googleapis.com/projects/test-project-id/topics/test-topic		 projects/PROJECT_ID/topics/TOPIC_ID
Contoh: projects/test-project-id/topics/test-topic
Dataform //dataform.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/repositories/REPOSITORY_ID
Contoh: //dataform.googleapis.com/projects/test-project-id/locations/us-central1/repositories/test-repo		 projects/PROJECT_ID/locations/LOCATION_ID/repositories/REPOSITORY_ID
Contoh: projects/test-project-id/locations/us-central1/repositories/test-repo
Dataproc Metastore //metastore.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID
Contoh: //metastore.googleapis.com/projects/test-project-id/locations/us-central1/services/test-service		 projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID
Contoh: projects/test-project-id/locations/us-central1/services/test-service

Untuk mengetahui informasi selengkapnya tentang kolom ini, lihat referensi API EntrySource.

Nilai jenis ancestor

Kolom entri tingkat teratas entrySource.ancestors.type berubah menjadi berisi project ID jenis Dataplex (dataplex-types) dan bukan nomor project jenis Dataplex (655216118709). Tabel berikut mencantumkan beberapa contoh.

Sistem Sumber Nilai sebelum perubahan Nilai setelah perubahan
Vertex AI DATAPLEX_TYPE_PROJECT_NUMBER.global.vertexai-feature-online-store
Contoh: 655216118709.global.vertexai-feature-online-store		 DATAPLEX_TYPE_PROJECT_ID.global.vertexai-feature-online-store
Contoh: dataplex-types.global.vertexai-feature-online-store
Dataproc Metastore DATAPLEX_TYPE_PROJECT_NUMBER.global.DataprocMetastoreDatabase
Contoh: 655216118709.global.DataprocMetastoreDatabase		 DATAPLEX_TYPE_PROJECT_ID.global.dataproc-metastore-database
Contoh: dataplex-types.global.dataproc-metastore-database
Spanner DATAPLEX_TYPE_PROJECT_NUMBER.global.cloud-spanner-instance
Contoh: 655216118709.global.cloud-spanner-instance		 DATAPLEX_TYPE_PROJECT_ID.global.cloud-spanner-instance
Contoh: dataplex-types.global.cloud-spanner-instance
Bigtable DATAPLEX_TYPE_PROJECT_NUMBER.global.cloud-bigtable-instance
Contoh: 655216118709.global.cloud-bigtable-instance		 DATAPLEX_TYPE_PROJECT_ID.global.cloud-bigtable-instance
Contoh: dataplex-types.global.cloud-bigtable-instance

Untuk mengetahui informasi selengkapnya tentang kolom ini, lihat referensi API Ancestor.

Yang perlu dilakukan

Periode peluncuran dimulai pada 12 Januari 2026 dan berakhir pada 2 Februari 2026. Perubahan pada metadata diterapkan secara bertahap selama periode peluncuran.

Berikut hal-hal yang perlu Anda lakukan:

  • Sebelum 12 Januari 2026, perbarui beban kerja Anda untuk menafsirkan metadata versi lama dan metadata versi yang diperbarui.

  • Selama periode peluncuran, entri dapat merekam versi metadata lama atau versi metadata yang diperbarui. Workload Anda harus dapat menafsirkan kedua versi.

  • Setelah 2 Februari 2026, Anda dapat memperbarui beban kerja untuk menafsirkan hanya metadata versi baru.

Cara menentukan versi metadata

Untuk menentukan apakah entri menggunakan metadata yang diperbarui, cari objek aspects entri dan temukan jenis aspek yang relevan. Dalam objek aspectSource jenis aspek, jika kolom dataVersion ada dan ditetapkan ke Ingestion/1.0.0, entri akan menggunakan versi metadata yang diperbarui. Untuk mengetahui informasi selengkapnya, lihat API lookupEntry dan getAspectType.

Dukungan

Jika ada pertanyaan, hubungi dataplex-msa-support@google.com.

Informasi tambahan