Panduan untuk memberi nama resource Knowledge Catalog

Resource Google Cloud adalah komponen apa pun yang Anda buat atau gunakan dalam Google Cloud. Resource ini membentuk elemen penyusun aplikasi dan sistem Anda yang berjalan di platform.

Resource di Knowledge Catalog mencakup hal berikut:

  • Grup entri

  • Entri

  • Jenis entri

  • Jenis aspek

  • Link entri

  • Tugas metadata

  • Feed metadata

  • Glosarium

  • Kategori glosarium

  • Istilah glosarium

  • Produk data

  • Domain data

  • Proses silsilah

  • Eksekusi silsilah

  • Peristiwa silsilah

Untuk mengetahui informasi selengkapnya tentang penamaan resource Google Cloud umum, lihat Nama resource.

Format penamaan resource

Berikut adalah format untuk berbagai resource:

  • Grup entri: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/entryGroups/{ENTRY_GROUP_ID}

  • Entri: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/entryGroups/{ENTRY_GROUP_ID}/entries/{ENTRY_ID}

  • Jenis entri: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/entryTypes/{ENTRY_TYPE_ID}

  • Jenis aspek: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/aspectTypes/{ASPECT_TYPE_ID}

  • Link entri: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/entryGroups/{ENTRY_GROUP_ID}/entryLinks/{ENTRY_LINK_ID}

  • Tugas metadata: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/metadataJobs/{METADATA_JOB_ID}

  • Feed metadata: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/metadataFeeds/{METADATA_FEED_ID}

  • Glosarium: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/glossaries/{GLOSSARY_ID}

  • Kategori glosarium: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/glossaries/{GLOSSARY_ID}/categories/{GLOSSARY_CATEGORY_ID}

  • Istilah glosarium: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/glossaries/{GLOSSARY_ID}/terms/{GLOSSARY_TERM_ID}

  • Produk data: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/dataProducts/{DATA_PRODUCT_ID}

  • Domain data: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/dataDomains/{DATA_DOMAIN_ID}

  • Proses: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/processes/{PROCESS_ID}

  • Jalankan: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/processes/{PROCESS_ID}/runs/{RUN_ID}

  • Peristiwa silsilah: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/processes/{PROCESS_ID}/runs/{RUN_ID}/lineageEvents/{LINEAGE_EVENT_ID}

Bagian berikut memberikan perincian setiap komponen.

ID Project

Nilainya harus berupa project ID atau nomor project, yang tersedia dari konsol Google Cloud . Misalnya, my-cool-project adalah project ID, sedangkan 123456789123 adalah nomor project.

Lokasi

Nilai harus berupa salah satu lokasi Knowledge Catalog yang didukung. Untuk mengetahui daftar lokasi yang tersedia, lihat Lokasi Knowledge Catalog.

ID

ID adalah segmen terakhir di jalur resource.

Untuk sebagian besar resource (grup entri, jenis entri, jenis aspek, link entri, tugas metadata, feed metadata, glosarium, kategori glosarium, istilah glosarium, produk data, dan domain data), variabel seperti {ENTRY_GROUP_ID}, {ENTRY_TYPE_ID}, {ASPECT_TYPE_ID}, {ENTRY_LINK_ID}, {METADATA_JOB_ID}, {METADATA_FEED_ID}, {GLOSSARY_ID}, {GLOSSARY_CATEGORY_ID}, {GLOSSARY_TERM_ID}, {DATA_PRODUCT_ID}, dan {DATA_DOMAIN_ID} harus sesuai dengan panduan berikut:

  • Dimulai dengan huruf kecil.

  • Berisi antara 1 dan 63 karakter.

  • Hanya boleh berisi huruf kecil, angka, tanda hubung, dan garis bawah.

  • Diakhiri dengan angka atau huruf kecil.

Panduan penamaan untuk {ENTRY_ID} berbeda:

  • Berisi hingga 4.000 karakter.

  • Gunakan format ID entri berdasarkan Google Cloud nama lengkap resource. Formatnya adalah nama lengkap resource tanpa garis miring ganda awalan di bagian nama layanan API. Hal ini memungkinkan pengambilan entri menggunakan nama resource terkaitnya.

    Contoh:

    • Jika nama resource lengkap instance Looker adalah //looker.googleapis.com/projects/my-project/locations/us-central1/instances/my-instance, maka {ENTRY_ID} yang disarankan adalah looker.googleapis.com/projects/my-project/locations/us-central1/instances/my-instance.

Untuk resource silsilah data, seperti proses, eksekusi, dan peristiwa silsilah, variabel {PROCESS_ID}, {RUN_ID}, dan {LINEAGE_EVENT_ID} harus sesuai dengan panduan berikut:

  • Berisi hingga 200 karakter.

  • Hanya berisi huruf (peka huruf besar/kecil), angka, tanda hubung, garis bawah, titik dua, dan titik.

Nama entri BigQuery

Saat berinteraksi dengan resource BigQuery melalui Knowledge Catalog API, Anda harus menggunakan format tertentu untuk ID grup entri dan ID entri.

  • ID grup entri: @bigquery
  • ID Entri: bigquery.googleapis.com/projects/{PROJECT_ID}/datasets/{DATASET_ID}/tables/{TABLE_ID}

Contoh

Jika tabel BigQuery Anda adalah projects/test-project/datasets/test_dataset/tables/test_table, nama entri Knowledge Catalog yang sepenuhnya memenuhi syarat adalah sebagai berikut:

projects/{PROJECT_ID}/locations/{LOCATION_NAME}/entryGroups/@bigquery/entries/bigquery.googleapis.com/projects/test-project/datasets/test_dataset/tables/test_table