Mengelola aspek dan memperkaya metadata

Dokumen ini menjelaskan cara membuat dan mengelola jenis aspek, serta memberi anotasi pada entri dengan aspek.

Katalog Universal Dataplex mendeskripsikan entri berdasarkan serangkaian aspek. Anda dapat mendeskripsikan entri dengan metadata tambahan menggunakan aspek dan jenis aspek.

Untuk mengetahui informasi selengkapnya, lihat Tentang pengelolaan katalog data di Dataplex Universal Catalog.

Aspek

Aspek memungkinkan Anda mengambil metadata dalam entri. Menambahkan aspek ke entri membantu memberikan konteks yang bermakna kepada siapa pun yang perlu menggunakan aset. Anda dapat menggunakan aspek untuk menyimpan metadata bisnis (misalnya, klasifikasi data) dan metadata teknis (misalnya, skema).

Aspek dianggap sebagai bagian dari resource entri dan bukan resource terpisah. Saat Anda mengubah aspek, Anda akan mengubah entri yang berisi aspek tersebut.

Anda dapat menentukan aspek di tingkat entri untuk mendeskripsikan entri, atau di tingkat kolom untuk mendeskripsikan kolom dalam entri.

Setiap aspek adalah instance dari jenis aspek. Jenis aspek menentukan template untuk aspeknya. Setiap jenis aspek berisi sekumpulan kolom. Saat membuat aspek, Anda harus memberikan nilai untuk kolom tersebut.

Untuk entri tertentu, paling banyak ada satu aspek yang dikaitkan dengan entri, per jenis aspek. Anda dapat memiliki beberapa aspek yang terkait dengan kolom entri per jenis aspek.

Kategori aspek

Aspek dikategorikan sebagai berikut:

  • Aspek wajib: aspek yang wajib ada saat pembuatan entri. Aspek tersebut ditentukan oleh jenis entri dari entri tertentu. Semua entri yang termasuk dalam jenis entri harus selalu memiliki semua aspek wajib yang ditentukan oleh jenis entri tersebut.

    Dataplex Universal Catalog mengelola aspek yang diperlukan (misalnya, skema) untuk entri sistem.

    Perhatikan hal berikut:

    • Anda hanya dapat mengaitkan aspek wajib dengan entri, bukan dengan kolom entri.

    • Anda tidak dapat menghapus aspek wajib dari entri.

    • Anda dapat membaca aspek yang diperlukan dari entri sistem, tetapi tidak dapat mengubahnya.

  • Aspek opsional: Anda dapat mengaitkan aspek opsional dengan entri atau dengan kolom entri. Anda dapat mengisi aspek opsional pada saat pembuatan entri atau nanti dengan memperbarui entri.

    Anda dapat menghapus aspek opsional setelah diisi.

Jenis aspek

Jenis aspek adalah resource yang dapat digunakan kembali yang menyediakan template untuk aspek.

Kategori jenis aspek

Jenis aspek dikategorikan sebagai berikut:

  • Jenis aspek kustom: jenis aspek yang Anda buat di Dataplex Universal Catalog.

  • Jenis aspek sistem: jenis aspek yang disediakan, digunakan, dan dikelola oleh Dataplex Universal Catalog.

    Jenis aspek sistem selanjutnya dikategorikan menjadi dapat digunakan kembali dan dibatasi. Tabel berikut menjelaskan kategori jenis aspek sistem, dan daftar jenis aspek yang disediakan Dataplex Universal Catalog untuk setiap kategori:

    Kategori jenis aspek sistem Deskripsi Jenis aspek yang disediakan oleh Katalog Universal Dataplex
    Jenis aspek sistem yang dapat digunakan kembali Anda dapat menggunakan jenis aspek ini untuk membuat atau mengubah aspek.
    • contacts
    • data-quality-scorecard
    • generic
    • overview
    • schema
    • usage
    Jenis aspek sistem yang dibatasi Dataplex Universal Catalog mengelola jenis aspek ini.
    Anda dapat membaca aspek dalam jenis aspek ini, tetapi tidak dapat membuat atau mengedit aspek dalam jenis aspek ini.     		Termasuk, tetapi tidak terbatas pada:
    • analytics-hub
    • aspecttype-aspect
    • bigquery-dataset
    • bigquery-table
    • cloudsql-database
    • cloudsql-instance
    • cloudsql-table
    • entrygroup-aspect
    • entrytype-aspect
    • sensitive-data-protection-profile
    • storage
    • storage-bucket
    • storage-folder

Jenis aspek kustom dapat bersifat global atau regional. Anda dapat membuat jenis aspek kustom baik di lokasi regional tertentu atau sebagai resource global.

Jenis aspek global digunakan untuk membuat aspek entri di wilayah mana pun. Konten jenis aspek global direplikasi di semua region. Jenis aspek regional digunakan untuk membuat aspek untuk entri di wilayah yang sama.

Lokasi jenis aspek memengaruhi cakupan penerapannya. Untuk mengetahui informasi selengkapnya, lihat Batasan project dan lokasi.

Jenis aspek sistem selalu bersifat global. Jenis aspek sistem disimpan di project yang dikelola Google dengan project ID 655216118709. Contoh, projects/655216118709/locations/global/aspectTypes/schema.

Sebelum memulai

Sebelum Anda membuat dan mengelola jenis aspek dan aspek, selesaikan tugas yang dijelaskan di bagian ini.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membuat dan mengelola jenis aspek dan aspek, minta administrator Anda untuk memberi Anda peran IAM berikut pada resource:

  • Set lengkap izin pada resource metadata di Katalog Universal Dataplex, termasuk jenis aspek: Admin Katalog Dataplex (roles/dataplex.catalogAdmin)
  • Buat dan kelola resource metadata di Dataplex Universal Catalog, termasuk jenis aspek: Dataplex Catalog Editor (roles/dataplex.catalogEditor)
  • Set izin lengkap pada jenis aspek kustom (kecuali izin untuk menggunakan jenis aspek guna membuat atau mengedit entri): Pemilik Jenis Aspek Dataplex (roles/dataplex.aspectTypeOwner)
  • Melihat jenis aspek dan kebijakan IAM yang terkait dengannya: Dataplex Catalog Viewer (roles/dataplex.catalogViewer)
  • Gunakan jenis aspek untuk membuat dan mengubah entri dengan aspek yang sesuai: Pengguna Jenis Aspek Dataplex (roles/dataplex.aspectTypeUser)
  • Tambahkan aspek dari beberapa jenis aspek sistem, seperti schema, overview, contacts: Pemilik Entri Dataplex (roles/dataplex.entryOwner)

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Untuk mengetahui informasi selengkapnya, lihat Peran IAM Dataplex Universal Catalog.

Mengaktifkan API

Aktifkan Dataplex API di project Katalog Universal Dataplex Anda.

Mengaktifkan API

Membuat jenis aspek

Konsol

  1. Di konsol Google Cloud , buka halaman Katalog Dataplex Universal Catalog.

    Buka Katalog

  2. Klik tab Jenis aspek & template tag > Kustom.

  3. Klik Create aspect type (Dataplex Catalog).

  4. Di jendela Create aspect type, masukkan hal berikut:

    1. Opsional: Di kolom Nama tampilan, masukkan nama untuk jenis aspek.
    2. Di kolom Aspect type ID, masukkan ID unik untuk jenis aspek.
    3. Opsional: Di kolom Deskripsi, masukkan deskripsi untuk jenis aspek.
    4. Di kolom Location, pilih lokasi untuk jenis aspek. Anda tidak dapat mengubah lokasi jenis aspek setelah membuatnya.

  5. Opsional: Tentukan template untuk jenis aspek Anda.

    Di bagian Template, klik Tambahkan kolom. Di bagian Kolom baru, masukkan berikut ini:

    1. Di kolom Name, masukkan nama.
    2. Opsional: Di kolom Nama tampilan, masukkan nama tampilan.
    3. Opsional: Di kolom Deskripsi, masukkan deskripsi.

    4. Di kolom Type, pilih jenis data untuk kolom. Berdasarkan pilihan Anda, serangkaian kolom dan opsi berikutnya akan ditampilkan:

      • Jika Anda memilih Teks sebagai jenis data, ikuti langkah-langkah berikut:

        1. Di kolom Jenis teks, pilih jenis teks.
        2. Di kolom Nilai teks, berikan petunjuk untuk kolom teks. Untuk melakukannya, klik Tambahkan nilai dan masukkan petunjuk. Anda dapat menambahkan beberapa petunjuk untuk kolom teks.
        3. Klik Selesai.

      • Jika Anda memilih Enum sebagai jenis data, tambahkan nilai enum:

        1. Klik Tambahkan nilai enum.
        2. Di kolom Nilai, masukkan nilai enum. Anda dapat menambahkan beberapa nilai enum.
        3. Klik Selesai.

      • Jika Anda memilih Array sebagai jenis data, di bagian Item array, tentukan jenis item yang akan ada dalam array:

        1. Klik Tambahkan item array.
        2. Di kolom Name, masukkan nama untuk item array.
        3. Opsional: Di kolom Nama tampilan, masukkan nama tampilan untuk item array.
        4. Opsional: Di kolom Deskripsi, masukkan deskripsi untuk item array.

        5. Di kolom Type, pilih jenis data untuk item array.

          Berdasarkan pilihan Anda, kumpulan kolom dan opsi berikutnya akan ditampilkan. Opsi ini serupa dengan opsi yang dijelaskan untuk jenis data Teks, Enum, Peta, Array, dan Catatan di bagian ini.

        6. Klik Selesai.

      • Jika Anda memilih Peta sebagai jenis data, di bagian Nilai peta, tentukan jenis nilai yang akan ada di peta:

        1. Klik Tambahkan nilai peta.
        2. Di kolom Name, masukkan nama untuk peta.
        3. Opsional: Di kolom Nama tampilan, masukkan nama tampilan untuk peta.
        4. Opsional: Di kolom Deskripsi, masukkan deskripsi peta.

        5. Di kolom Type, pilih jenis data untuk peta.

          Berdasarkan pilihan Anda, kumpulan kolom dan opsi berikutnya akan ditampilkan. Opsi ini serupa dengan opsi yang dijelaskan untuk jenis data Teks, Enum, Peta, Array, dan Catatan di bagian ini.

        6. Klik Selesai.

      • Jika Anda memilih Rekaman sebagai jenis data, masukkan yang berikut:

        1. Di kolom ID Kumpulan Data, masukkan ID unik yang dapat digunakan oleh kolom kumpulan data lain untuk merujuk ke kumpulan data ini. Lihat bagian Contoh penggunaan kolom ID Data dan Referensi data dalam dokumen ini.
        2. Opsional: Jika Anda ingin menambahkan referensi ke data lain dari template ini, gunakan kolom Referensi data. Anda tidak dapat mengubahnya setelah membuat jenis aspek. Lihat bagian Contoh penggunaan kolom ID Data dan Referensi data dalam dokumen ini.

        3. Di bagian Kolom rekaman, Anda dapat menentukan objek kompleks dengan beberapa kolom bertingkat. Untuk melakukannya, klik Tambahkan item kolom data, lalu tentukan hal berikut:

        4. Di kolom Name, masukkan nama untuk kolom data.

        5. Opsional: Di kolom Nama tampilan, masukkan nama tampilan untuk kolom data.

        6. Opsional: Di kolom Deskripsi, masukkan deskripsi untuk kolom data.

        7. Di kolom Type, pilih jenis data.

          Berdasarkan pilihan Anda, kumpulan kolom dan opsi berikutnya akan ditampilkan. Opsi ini serupa dengan opsi yang dijelaskan untuk jenis data Teks, Enum, Peta, Array, dan Record sebelumnya di bagian ini.

        8. Klik Selesai.

    5. Untuk membuat kolom wajib diisi untuk aspek jenis ini, pilih Wajib diisi. Untuk mengetahui informasi selengkapnya tentang aspek wajib dan aspek opsional, lihat bagian kategori aspek dalam dokumen ini.

    6. Klik Selesai.

    7. Untuk menambahkan beberapa kolom, klik Tambahkan kolom dan ulangi langkah-langkah sebelumnya.

  6. Opsional: Di bagian Labels, tambahkan label arbitrer sebagai pasangan nilai kunci ke resource Anda:

    1. Klik Tambahkan label.
    2. Di kolom Key, masukkan kunci.
    3. Di kolom Nilai, masukkan nilai untuk kunci.
    4. Untuk menambahkan label lainnya, klik Tambahkan label, lalu ulangi langkah-langkahnya.

  7. Klik Simpan.

gcloud

Untuk membuat jenis aspek, gunakan perintah gcloud dataplex aspect-types create.

REST

Untuk membuat jenis aspek, gunakan metode aspectType.create.

Setelah membuat jenis aspek, Anda dapat menambahkan aspek ke entri.

Contoh penggunaan kolom ID Data dan Referensi data

Anda dapat menggunakan kolom ID Rekaman dan Referensi rekaman untuk referensi rekursif. Contoh berikut menunjukkan cara menggunakan kolom ini:

Pertimbangkan jenis aspek yang disebut Employee, dengan kolom berikut:

  • Nama (jenis:Text)
  • Tanggal mulai (jenis:Date & time)
  • Jabatan (jenis:Text)
  • Alamat saat ini (jenis:Record)
  • Alamat tetap (jenis:Record)

Dua kolom alamat Alamat saat ini dan Alamat tetap memiliki jenis data Record yang sama. Untuk menghindari duplikasi, Anda dapat menetapkan nilai ID record dan Referensi record saat menentukan kolom ini.

Saat menentukan kolom Alamat saat ini, Anda dapat menentukan ID Rekaman sebagai address-field. Untuk Alamat permanen, Anda dapat menentukan nilai yang sama (address-field) untuk Referensi catatan. Contoh:

  • Nama (jenis:Text)
  • Tanggal mulai (jenis:Date & time)
  • Jabatan (jenis:Text)
  • Alamat saat ini (jenis:Record, ID Data:address-field)
  • Alamat tetap (jenis:Record, Referensi catatan:address-field)

Dengan begitu, Anda tidak perlu menduplikasi kolom alamat lain.

Menambahkan aspek ke entri

Setelah membuat jenis aspek, Anda dapat membuat aspek dari jenis tersebut. Untuk menambahkan aspek ke entri, Anda harus memperbarui entri, karena aspek disimpan dalam entri.

Perhatikan hal berikut:

  • Anda dapat menambahkan aspek ke entri atau ke kolom entri.
  • Anda hanya dapat mengedit aspek yang diperlukan untuk entri kustom. Anda tidak dapat menghapus aspek yang diperlukan.
  • Anda dapat mengedit dan menghapus aspek opsional untuk entri kustom dan entri sistem.

Konsol

  1. Di konsol Google Cloud , buka halaman Penelusuran Dataplex Universal Catalog.

    Buka Penelusuran

  2. Untuk Pilih platform penelusuran, pilih Dataplex Catalog sebagai mode penelusuran.

  3. Telusuri entri yang ingin Anda tambahkan aspeknya, lalu klik entri tersebut. Halaman detail entri akan terbuka.

  4. Untuk menambahkan aspek ke entri, ikuti langkah-langkah berikut:

    1. Klik tab Detail.
    2. Untuk menambahkan aspek wajib atau aspek opsional ke entri, di bagian Tag & aspek, klik Tambahkan untuk masing-masing kategori.
      Anda tidak dapat menambahkan aspek wajib jika jenis entri dari entri yang dipilih tidak memiliki aspek wajib yang ditentukan.
    3. Telusuri dan pilih aspek yang ingin Anda tambahkan.
    4. Di jendela Tambahkan aspek, masukkan nilai untuk kolom.
    5. Klik Simpan.

  5. Untuk menambahkan aspek ke kolom entri, ikuti langkah-langkah berikut:

    1. Di halaman detail entri, klik tab Schema.
    2. Pilih kolom yang ingin Anda tambahi aspek.
    3. Klik Tambahkan aspek.
    4. Telusuri dan pilih aspek yang ingin Anda tambahkan.
    5. Di jendela Tambahkan aspek, masukkan nilai untuk kolom.
    6. Klik Simpan.

gcloud

Untuk menambahkan aspek ke entri atau ke kolom entri, gunakan perintah gcloud dataplex entries update.

REST

Untuk menambahkan aspek ke entri atau ke kolom entri, gunakan metode entry.patch.

Membuat dan menggunakan aspek dalam entri yang jenis aspek dan entrinya berada di organisasi Google Cloud yang berbeda tidak didukung.

Mengelola aspek yang ada untuk entri

Bagian ini menjelaskan cara memperbarui dan menghapus aspek yang ada untuk entri.

Memperbarui aspek

Anda dapat mengedit aspek opsional untuk entri kustom dan entri sistem. Anda hanya dapat mengedit aspek yang diperlukan untuk entri kustom.

Konsol

  1. Di konsol Google Cloud , buka halaman Penelusuran Dataplex Universal Catalog.

    Buka Penelusuran

  2. Untuk Pilih platform penelusuran, pilih Dataplex Catalog sebagai mode penelusuran.

  3. Cari entri yang aspeknya ingin Anda perbarui, lalu klik entri tersebut.

    Halaman detail entri akan terbuka.

  4. Klik tab Detail.

  5. Di bagian Tag & aspek, luaskan aspek atau tag yang ingin Anda perbarui, lalu klik Edit.

  6. Di jendela Edit aspek, perbarui kolom yang wajib diisi.

  7. Klik Simpan.

gcloud

Untuk memperbarui aspek entri atau kolom entri, gunakan perintah gcloud dataplex entries update.

REST

Untuk memperbarui aspek entri atau kolom entri, gunakan metode entry.update.

Menghapus aspek

Konsol

  1. Di konsol Google Cloud , buka halaman Penelusuran Dataplex Universal Catalog.

    Buka Penelusuran

  2. Untuk Pilih platform penelusuran, pilih Dataplex Catalog sebagai mode penelusuran.

  3. Telusuri entri yang aspeknya ingin Anda hapus, lalu klik entri tersebut.

    Halaman detail entri akan terbuka.

  4. Klik tab Detail.

  5. Di bagian Tag & aspek, luaskan aspek atau tag yang ingin Anda hapus, klik Hapus.

  6. Klik Konfirmasi.

gcloud

Untuk menghapus aspek entri, gunakan perintah gcloud dataplex entries update.

REST

Untuk menghapus aspek entri, gunakan metode entry.update.

Mengelola jenis aspek

Bagian ini menjelaskan cara melihat, memperbarui, dan menghapus jenis aspek.

Melihat daftar jenis aspek dan template tag yang tersedia

Konsol

  1. Di konsol Google Cloud , buka halaman Katalog Dataplex Universal Catalog.

    Buka Katalog

  2. Klik tab Jenis aspek & template tag.

    Halaman ini mencantumkan semua jenis aspek Katalog Universal Dataplex dan template tag Data Catalog yang tersedia.

  3. Untuk melihat jenis aspek kustom dan template tag, klik tab Kustom. Di tab Kustom, kolom Sumber katalog menampilkan tempat resource berada—Dataplex Universal Catalog atau Data Catalog.

    Untuk melihat jenis aspek sistem, klik tab Sistem.

    Untuk mengetahui informasi selengkapnya tentang jenis aspek kustom dan sistem, lihat bagian kategori jenis aspek dalam dokumen ini.

  4. Opsional: Untuk melihat daftar jenis aspek dan template tag di project yang Anda pilih, klik tab Kustom, lalu klik tombol Tampilkan dari semua project ke posisi nonaktif.

    Tombol Tampilkan dari semua project aktif secara default, dan daftar mencakup resource Dataplex Universal Catalog dari organisasi yang Anda pilih dan resource Data Catalog dari semua organisasi yang dapat Anda akses.

gcloud

Untuk mencantumkan semua jenis aspek yang tersedia, gunakan perintah gcloud dataplex aspect-types list.

REST

Untuk mencantumkan semua jenis aspek yang tersedia, gunakan metode aspectTypes.list.

Melihat detail jenis aspek atau template tag

Konsol

  1. Di konsol Google Cloud , buka halaman Katalog Dataplex Universal Catalog.

    Buka Katalog

  2. Klik tab Jenis aspek & template tag.

  3. Untuk melihat detail jenis aspek Katalog Universal Dataplex, klik jenis aspek. Halaman detail jenis aspek akan terbuka, tempat Anda dapat mengakses detail, seperti nama tampilan, ID jenis aspek, deskripsi, ID project, lokasi, label, tanggal pembuatan, dan tanggal terakhir diubah.

    • Untuk melihat struktur jenis aspek yang dipilih, klik tab Template.
    • Untuk melihat daftar 10 entri terkait yang dibuat baru-baru ini, klik tab Contoh entri.
    • Untuk menelusuri semua entri terkait, klik Tampilkan semua entri terkait di Penelusuran. Tombol ini hanya muncul jika ada minimal satu entri terkait.

  4. Untuk melihat detail template tag Data Catalog, klik template tag. Halaman detail template tag akan terbuka di Data Catalog, tempat Anda dapat mengakses detail, seperti nama tampilan, ID template, ID project, lokasi, visibilitas, dan label.

gcloud

Untuk mendapatkan detail jenis aspek, gunakan perintah gcloud dataplex aspect-types describe.

REST

Untuk mendapatkan detail jenis aspek, gunakan metode aspectTypes.get.

Memperbarui jenis aspek

Anda dapat memperbarui nama tampilan, deskripsi, kolom template, dan label dari jenis aspek. Anda tidak dapat menghapus kolom yang ada dalam template.

Anda tidak dapat memperbarui ID jenis aspek dan lokasi setelah membuat jenis aspek.

Konsol

  1. Di konsol Google Cloud , buka halaman Katalog Dataplex Universal Catalog.

    Buka Katalog

  2. Klik tab Jenis aspek & template tag.

  3. Klik jenis aspek yang ingin Anda perbarui.

  4. Di halaman Detail jenis aspek, klik Edit.

  5. Edit nama tampilan, deskripsi, kolom template, dan label, sesuai kebutuhan.

  6. Opsional: Untuk menandai kolom dalam jenis aspek sebagai tidak digunakan lagi, ikuti langkah-langkah berikut:

    1. Di bagian Template, luaskan kolom.
    2. Pilih Tidak Digunakan Lagi.
    3. Di kolom Alasan penghentian penggunaan, masukkan alasan penghentian penggunaan kolom yang dipilih.
    4. Klik Selesai.

  7. Klik Save.

gcloud

Untuk memperbarui jenis aspek, gunakan perintah gcloud dataplex aspect-types update.

REST

Untuk memperbarui jenis aspek, gunakan metode aspectTypes.patch.

Menghapus jenis aspek

Konsol

  1. Di konsol Google Cloud , buka halaman Katalog Dataplex Universal Catalog.

    Buka Katalog

  2. Klik tab Jenis aspek & template tag.

  3. Klik jenis aspek yang ingin Anda hapus.

  4. Di halaman Detail jenis aspek, klik Hapus. Konfirmasi saat diminta.

gcloud

Untuk menghapus jenis aspek, gunakan perintah gcloud dataplex aspect-types delete.

REST

Untuk menghapus jenis aspek yang ada, gunakan metode aspectTypes.delete.

Langkah berikutnya