Mengelola glosarium bisnis

Glosarium bisnis Dataplex Universal Catalog menyediakan satu tempat untuk mengelola terminologi dan definisi terkait bisnis di seluruh perusahaan Anda.

Saat tim yang berbeda mengerjakan project bersama, atau perusahaan besar memiliki banyak departemen, setiap bagian perusahaan biasanya membuat terminologinya sendiri untuk mendeskripsikan berbagai sumber data yang mereka gunakan. Hal ini dapat menyebabkan miskomunikasi dan pemahaman yang tidak konsisten tentang resource tersebut. Selain itu, terkadang suatu konsep dapat memerlukan pengetahuan teknis atau khusus. Hal ini dapat menyulitkan pengguna bisnis di domain lain untuk memahami konsepnya.

Glosarium bisnis Dataplex Universal Catalog memungkinkan Anda membuat kosakata terpusat dan standar untuk resource data Anda. Anda dapat menggunakan glosarium bisnis untuk melakukan hal berikut:

  • Tentukan struktur hierarkis kategori dan konsep bisnis, yang disebut istilah.
  • Buat hubungan antar-konsep dengan menentukan sinonim dan istilah terkait.
  • Tautkan sumber data Anda dengan istilah dalam glosarium, yang memungkinkan Anda menelusuri sumber data berdasarkan konsep bisnis.

Glosarium bisnis membantu menyederhanakan penemuan data dan mengurangi ambiguitas, yang dapat menghasilkan analisis yang lebih akurat, tata kelola yang lebih baik, dan insight yang lebih cepat.

Elemen glosarium bisnis

Bagian ini menjelaskan elemen utama yang dapat Anda gunakan untuk menyusun glosarium bisnis.

Glosarium

Glosarium memiliki properti berikut:

  • Ringkasan. Menjelaskan tujuan dan isi glosarium bisnis. Anda dapat menambahkan gambar, link, tabel, atau teks yang diformat ke glosarium. Ukuran maksimum yang didukung adalah 120 KB.
  • Deskripsi. Menjelaskan daftar istilah. Teks dalam kolom ini diindeks untuk penelusuran. Ukuran maksimum yang didukung adalah 1 KB.
  • Region. Menentukan region tempat glosarium berada.

Kategori

Kategori memungkinkan Anda mengatur dan menyusun berbagai kategori dan istilah. Kategori ditentukan dalam glosarium bisnis. Anda dapat menyusun kategori bertingkat hingga tiga tingkat.

Kategori memiliki properti glosarium serta properti berikut:

  • Kontak. Menentukan orang yang bertanggung jawab untuk mengelola kategori. Properti ini bersifat deskriptif dan tidak memengaruhi izin kategori.
  • Orang tua. Menentukan hubungan yang digunakan untuk menetapkan induk kategori saat ini. Anda dapat menyusun bertingkat hingga tiga kategori.

Region kategori sama dengan region glosarium yang memuatnya.

Istilah

Istilah (singkatan dari "istilah glosarium") menjelaskan konsep yang digunakan dalam cabang bisnis tertentu di perusahaan Anda. Misalnya, departemen pemasaran perusahaan dapat membuat istilah yang menjelaskan biaya per klik. Istilah ditentukan dalam glosarium bisnis, baik dalam glosarium secara langsung maupun dalam kategori apa pun yang ditemukan dalam glosarium.

Istilah memiliki properti kategori serta properti berikut:

  • Sinonim. Menentukan link antaristilah yang memiliki makna yang sama. Lihat Istilah sinonim.
  • Istilah terkait. Menentukan link antaristilah yang secara konseptual saling terkait, tetapi memiliki arti yang berbeda. Lihat Istilah terkait.
  • Entri terkait. Menentukan link antara istilah dan aset data, atau antara istilah dan kolom dalam aset data.
  • Kontak. Menentukan orang yang bertanggung jawab untuk memelihara istilah. Istilah tidak mewarisi kontak yang ditentukan dalam kategori.

Region suatu istilah sama dengan region glosarium yang memuatnya.

Istilah sinonim

Sinonim adalah hubungan yang menunjukkan kesetaraan antara dua istilah yang berbeda. Gunakan sinonim jika dua istilah dengan makna yang sama ditentukan oleh tim yang berbeda dalam glosarium yang berbeda. Misalnya, Anda dapat membuat sinonim untuk menautkan istilah "laba" dan "penghasilan".

Istilah terkait adalah hubungan yang menunjukkan bahwa dua istilah saling terkait, tetapi memiliki arti yang berbeda. Misalnya, Anda dapat membuat istilah terkait untuk menautkan istilah "pendapatan" dan "laba".

Batasan

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membuat dan mengelola glosarium, minta administrator untuk memberi Anda peran IAM berikut di project Anda:

  • Untuk administrator data, dapatkan akses penuh ke glosarium, kategori, istilah, sinonim, dan istilah terkait, serta untuk menetapkan kebijakan IAM: Admin Katalog Dataplex (roles/dataplex.catalogAdmin)
  • Untuk pengelola data atau pemilik data, dapatkan akses untuk membuat, mengedit, atau menghapus glosarium, kategori, istilah, link antar-istilah, link antara istilah dan aset data, serta penelusuran: Editor Katalog Dataplex (roles/dataplex.catalogEditor)
  • Untuk analis data atau konsumen data, dapatkan akses hanya baca ke glosarium, kategori, istilah, link antara istilah dan antara istilah dan aset data, serta penelusuran: Pelihat Katalog Dataplex (roles/dataplex.catalogViewer)

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

Peran bawaan ini berisi izin yang diperlukan untuk membuat dan mengelola glosarium. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk membuat dan mengelola glosarium:

  • Membuat, membaca, memperbarui, dan menghapus glosarium bisnis, kategori, dan istilah dalam project Anda:
    • dataplex.glossaries.list
    • dataplex.glossaries.create
    • dataplex.glossaries.get
    • dataplex.glossaries.update
    • dataplex.glossaries.delete
    • dataplex.glossaryCategories.create
    • dataplex.glossaryCategories.list
    • dataplex.glossaryCategories.get
    • dataplex.glossaryCategories.update
    • dataplex.glossaryCategories.delete
    • dataplex.glossaryTerms.create
    • dataplex.glossaryTerms.list
    • dataplex.glossaryTerms.get
    • dataplex.glossaryTerms.update
    • dataplex.glossaryTerms.delete
  • Membuat dan menghapus link istilah ke istilah sinonim dalam project Anda:
    • dataplex.entryLinks.create pada grup entri Dataplex Universal Catalog di project tempat salah satu istilah glosarium berada. Link dibuat di grup entri yang diberi izin.
    • dataplex.entryGroups.useSynonymEntryLink pada grup entri Dataplex Universal Catalog di project tempat salah satu istilah glosarium berada. Link dibuat di grup entri yang diberi izin.
    • dataplex.glossaryTerms.use pada glosarium yang istilahnya perlu dikaitkan.
    • dataplex.entryLinks.delete di grup entri Dataplex Universal Catalog dalam project tempat link berada.
  • Membuat dan menghapus link istilah ke istilah terkait dalam project Anda:
    • dataplex.entryLinks.create pada grup entri Dataplex Universal Catalog di project tempat salah satu istilah glosarium berada. Link dibuat di grup entri yang diberi izin.
    • dataplex.entryGroups.useRelatedEntryLink pada grup entri Dataplex Universal Catalog di project tempat salah satu istilah glosarium berada. Link dibuat di grup entri yang diberi izin.
    • dataplex.entries.link pada grup entri Dataplex Universal Catalog di project yang berisi entri yang sesuai dengan istilah glosarium.
    • dataplex.entryLinks.delete di grup entri Dataplex Universal Catalog dalam project tempat link berada.
  • Buat link antara istilah dan aset data atau kolom dalam project Anda:
    • dataplex.entryLinks.create pada grup entri sistem yang sesuai dengan aset atau kolom data dalam project. Link dibuat di project yang diberi izin.
    • dataplex.entryGroups.useDefinitionEntryLink pada grup entri sistem yang sesuai dengan aset atau kolom data dalam project. Link dibuat di project yang diberi izin.
    • dataplex.entries.link pada grup entri sistem yang sesuai dengan aset atau kolom data dalam project. Link dibuat di project yang diberi izin.
    • dataplex.glossaryTerms.use pada glosarium yang istilahnya perlu dikaitkan.
    • dataplex.entryLinks.delete pada grup entri sistem tempat link berada.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk mengetahui informasi selengkapnya, lihat Peran standar untuk Data Catalog.

Membuat dan mengelola glosarium bisnis

Bagian berikut menjelaskan cara membuat, melihat, mengedit, dan menghapus glosarium bisnis.

Membuat glosarium bisnis

Konsol

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

    Buka Glosarium

  2. Klik Buat glosarium bisnis.

  3. Di halaman Create business glossary, tentukan nama dan lokasi untuk glosarium bisnis. Setelah membuat glosarium, Anda tidak dapat mengubah lokasinya.

  4. Klik Buat. Glosarium dibuat di project saat ini.

  5. Opsional: Tambahkan deskripsi singkat di Deskripsi (hingga 1.024 karakter) atau deskripsi panjang di Ringkasan (hingga 120 KB).

REST

Saat Anda membuat glosarium, Dataplex Universal Catalog akan membuat entri untuk merepresentasikan glosarium.

  1. Buat glosarium.

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries?glossary_id=GLOSSARY_ID --data @- << EOF
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

    Ganti kode berikut:

    • PROJECT_ID: ID project tempat Anda ingin membuat glosarium
    • LOCATION_ID: ID lokasi tempat Anda ingin membuat glosarium
    • GLOSSARY_ID: ID glosarium
    • DISPLAY_NAME: nama tampilan glosarium
    • DESCRIPTION: deskripsi glosarium, hingga maksimum 1.024 karakter

  2. Opsional: Tambahkan ringkasan ke glosarium.

    1. Cari entri untuk glosarium Anda:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID
\
\&view=ALL

      Ganti PROJECT_NUMBER dengan nomor project tempat glosarium Anda dibuat.

    2. Menambahkan ringkasan ke glosarium Anda:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview \
--data @- << EOF
{
"aspects": {
   "dataplex-types.global.overview": {
      "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/overview",
      "data": {
      "content": "OVERVIEW",
      "links": []
      },
   }
}
}
EOF

      Ganti OVERVIEW dengan teks biasa atau HTML untuk mendeskripsikan kategori atau istilah glosarium Anda.

Melihat glosarium yang tersedia

Konsol

  • Di konsol Google Cloud , buka halaman Glosarium Dataplex Universal Catalog.

    Buka Glosarium

    Panel Glosarium saya menampilkan semua glosarium organisasi yang izin aksesnya Anda miliki, beserta deskripsi dan stempel waktu modifikasi terakhirnya.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries

Mengedit glosarium

Anda dapat mengedit nama dan deskripsi glosarium.

Konsol

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

    Buka Glosarium

  2. Klik glosarium yang ingin Anda edit.

  3. Klik Edit di samping nama, deskripsi, atau ringkasan, lalu buat perubahan.

  4. Klik Simpan.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID?update_mask=displayName,description --data @- << EOF
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

Menghapus glosarium

Sebelum dapat menghapus glosarium, Anda harus menghapus semua kategori dan istilah dalam glosarium terlebih dahulu.

Konsol

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

    Buka Glosarium

  2. Klik glosarium yang ingin Anda hapus.

  3. Klik Hapus, lalu konfirmasi saat diminta.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID

Membuat dan mengelola kategori

Bagian berikut menjelaskan cara membuat, melihat, memperbarui, dan menghapus kategori.

Membuat kategori dalam glosarium

Glosarium bisnis dapat memiliki maksimum 200 kategori.

Konsol

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

    Buka Glosarium

  2. Pilih glosarium tempat Anda ingin membuat kategori, lalu klik Buat kategori.

  3. Masukkan nama untuk kategori.

  4. Klik Buat.

  5. Opsional: Tambahkan deskripsi singkat di Deskripsi (hingga 1.024 karakter) atau deskripsi panjang di Ringkasan (hingga 120 KB).

REST

Saat Anda membuat kategori, Dataplex Universal Catalog akan membuat entri untuk merepresentasikan kategori tersebut.

  1. Buat kategori.

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories?category_id=CATEGORY_ID --data @- << EOF
{
"displayName": "CATEGORY_DISPLAY_NAME",
"description": "CATEGORY_DESCRIPTION",
"parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID"
}
EOF

    Ganti kode berikut:

    • CATEGORY_ID: ID kategori
    • CATEGORY_DISPLAY_NAME: nama tampilan kategori
    • CATEGORY_DESCRIPTION: deskripsi kategori

  2. Opsional: Tambahkan ringkasan ke kategori.

    1. Cari entri untuk kategori Anda:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID
\
\&view=ALL

    2. Menambahkan ringkasan ke kategori Anda:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
\
--data @- << EOF
{
"aspects": {
"dataplex-types.global.overview": {
   "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
",
   "data": {
   "content": "OVERVIEW",
   "links": []
   },
}
}
}
EOF

      Ganti OVERVIEW dengan teks biasa atau HTML untuk mendeskripsikan kategori atau istilah glosarium Anda.

  3. Opsional: Tambahkan kontak

    1. Cari entri untuk kategori Anda:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID
\
\&view=ALL

    2. Perbarui entri untuk kategori Anda dengan kontak:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
--data @- << EOF
{
"aspects": {
"dataplex-types.global.contacts": {
   "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
   "data": {
   "identities": [
      {
         "role": "steward",
         "name": "CONTACT_NAME",
         "id": "CONTACT_EMAIL"
      }
   ]
   },
}
}
}
EOF

Membuat kategori bertingkat

Glosarium bisnis dapat memiliki maksimum tiga tingkat kategori bertingkat, tidak termasuk tingkat glosarium root.

Konsol

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

    Buka Glosarium

  2. Luaskan glosarium tempat Anda ingin membuat kategori.

  3. Pilih kategori induk tempat Anda ingin membuat kategori lain, lalu klik Buat kategori.

  4. Masukkan nama untuk kategori.

  5. Klik Buat.

  6. Opsional: Tambahkan deskripsi singkat di Deskripsi (hingga 1.024 karakter) atau deskripsi panjang di Ringkasan (hingga 120 KB).

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories?category_id=CATEGORY_ID --data @- << EOF
{
  "displayName": "CATEGORY_DISPLAY_NAME",
  "description": "CATEGORY_DESCRIPTION",
  "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/PARENT_CATEGORY_ID"
}
EOF

Ganti PARENT_CATEGORY_ID dengan ID kategori induk.

Melihat kategori yang termasuk dalam glosarium

Konsol

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

    Buka Glosarium

  2. Untuk melihat kategori dalam glosarium, luaskan glosarium.

  3. Untuk melihat kategori bertingkat dalam suatu kategori, luaskan kategori tersebut.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories

Mengedit kategori

Anda dapat mengedit nama, deskripsi, dan kontak untuk kategori. Untuk kategori bertingkat, Anda juga dapat mengedit kategori induk.

Konsol

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

    Buka Glosarium

  2. Luaskan glosarium, lalu klik kategori yang ingin Anda edit.

  3. Klik Edit di samping nama, deskripsi, atau ringkasan, lalu buat perubahan.

  4. Klik Simpan.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID?update_mask=displayName,description --data @- << EOF
{
"displayName": "CATEGORY_DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

Menghapus kategori

Konsol

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

    Buka Glosarium

  2. Luaskan glosarium dan klik kategori yang ingin Anda hapus.

  3. Klik Hapus, lalu konfirmasi saat diminta.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID

Membuat dan mengelola istilah

Bagian berikut menjelaskan cara membuat, melihat, mengakses, mengedit, dan menghapus istilah.

Membuat istilah dalam glosarium bisnis

Glosarium bisnis dapat memiliki maksimum 5.000 istilah.

Konsol

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

    Buka Glosarium

  2. Untuk membuat istilah di tingkat glosarium, pilih glosarium tempat Anda ingin membuat istilah, lalu klik Buat istilah.

  3. Masukkan nama untuk istilah.

  4. Klik Buat.

  5. Opsional: Tambahkan deskripsi singkat di Deskripsi (hingga 1.024 karakter) atau deskripsi panjang di Ringkasan (hingga 120 KB).

  6. Opsional: Untuk menambahkan kontak, klik Edit, lalu berikan daftar alamat email untuk pengelola data, pemilik data, atau pemilik domain data. Kemudian, klik Simpan.

REST

Saat Anda membuat istilah, Dataplex Universal Catalog akan membuat entri untuk merepresentasikan istilah tersebut.

  1. Buat istilah.

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms?term_id=TERM_ID --data @- << EOF
{
"displayName": "TERM_DISPLAY_NAME",
"description": "TERM_DESCRIPTION",
"parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID"
}
EOF

    Ganti kode berikut:

    • TERM_ID: ID masa berlaku yang Anda buat
    • TERM_DISPLAY_NAME: nama tampilan untuk istilah yang Anda buat
    • TERM_DESCRIPTION: deskripsi untuk istilah yang Anda buat

  2. Opsional: Tambahkan ringkasan ke istilah.

    1. Cari entri untuk istilah Anda:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
\&view=ALL

    2. Tambahkan ringkasan ke istilah Anda:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
\
--data @- << EOF
{
"aspects": {
"dataplex-types.global.overview": {
   "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
",
   "data": {
   "content": "OVERVIEW",
   "links": []
   },
}
}
}
EOF

      Ganti OVERVIEW dengan teks biasa atau HTML untuk mendeskripsikan kategori atau istilah glosarium Anda.

  3. Opsional: Tambahkan kontak.

    1. Cari entri untuk istilah Anda:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
\&view=ALL

    2. Perbarui entri untuk istilah Anda dengan kontak:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
--data @- << EOF
{
"aspects": {
"dataplex-types.global.contacts": {
   "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
   "data": {
   "identities": [
      {
         "role": "steward",
         "name": "CONTACT_NAME",
         "id": "CONTACT_EMAIL"
      }
   ]
   },
}
}
}
EOF

Membuat istilah dalam kategori

Konsol

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

    Buka Glosarium

  2. Untuk membuat istilah dalam kategori, pilih kategori tempat Anda ingin membuat istilah, lalu klik Tambahkan istilah.

  3. Masukkan nama untuk istilah.

  4. Klik Buat.

  5. Opsional: Tambahkan deskripsi singkat di Deskripsi (hingga 1.024 karakter) atau deskripsi panjang di Ringkasan (hingga 120 KB).

  6. Opsional: Untuk menambahkan kontak, klik Edit, lalu berikan daftar alamat email untuk pengelola data, pemilik data, atau pemilik domain data. Kemudian, klik Simpan.

REST

Saat Anda membuat istilah, Dataplex Universal Catalog akan membuat entri untuk merepresentasikan istilah tersebut.

  1. Buat istilah.

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms?term_id=TERM_ID --data @- << EOF
{
"displayName": "TERM_DISPLAY_NAME",
"description": "TERM_DESCRIPTION",
"parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/PARENT_CATEGORY_ID"
}
EOF

    Ganti kode berikut:

    • TERM_ID: ID masa berlaku yang Anda buat
    • TERM_DISPLAY_NAME: nama tampilan untuk istilah yang Anda buat
    • TERM_DESCRIPTION: deskripsi untuk istilah yang Anda buat

  2. Opsional: Tambahkan ringkasan ke istilah.

    1. Cari entri untuk istilah Anda:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
\&view=ALL

    2. Tambahkan ringkasan ke istilah Anda:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
\
--data @- << EOF
{
"aspects": {
"dataplex-types.global.overview": {
   "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
",
   "data": {
   "content": "OVERVIEW",
   "links": []
   },
}
}
}
EOF

      Ganti OVERVIEW dengan teks biasa atau HTML untuk mendeskripsikan kategori atau istilah glosarium Anda.

  3. Opsional: Tambahkan kontak.

    1. Cari entri untuk istilah Anda:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
\&view=ALL

    2. Perbarui entri untuk istilah Anda dengan kontak:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
--data @- << EOF
{
"aspects": {
"dataplex-types.global.contacts": {
   "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
   "data": {
   "identities": [
      {
         "role": "steward",
         "name": "CONTACT_NAME",
         "id": "CONTACT_EMAIL"
      }
   ]
   },
}
}
}
EOF

Melihat istilah dalam glosarium atau kategori

Konsol

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

    Buka Glosarium

  2. Untuk melihat istilah dalam glosarium, luaskan glosarium. Untuk melihat istilah dalam kategori di glosarium ini, perluas kategori. Untuk melihat istilah dalam kategori bertingkat, luaskan kategori bertingkat.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms

Melihat detail istilah

Konsol

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

    Buka Glosarium

  2. Untuk melihat daftar istilah dalam glosarium, luaskan glosarium.

  3. Klik istilah. Halaman Detail istilah menampilkan nama istilah, deskripsi, istilah terkait, sinonim, dan entri terkait.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID

Mengedit istilah

Anda dapat mengedit nama, deskripsi, ringkasan, kontak, dan induk untuk sebuah istilah.

Konsol

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

    Buka Glosarium

  2. Luaskan glosarium dan klik istilah yang ingin Anda edit.

  3. Klik Edit.

  4. Edit kolom, lalu klik Simpan.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID?update_mask=displayName,description --data @- << EOF
{
  "displayName": "TERM_DISPLAY_NAME",
  "description": "TERM_DESCRIPTION"
}
EOF

Menghapus istilah

Konsol

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

    Buka Glosarium

  2. Perluas glosarium, lalu klik istilah yang ingin Anda hapus.

  3. Klik Hapus, lalu konfirmasi saat diminta.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID

Anda dapat menambahkan hubungan antar-istilah dengan menautkannya sebagai sinonim atau istilah terkait.

Hubungan istilah bersifat dua arah. Misalnya, saat Anda menautkan profit sebagai sinonim earnings, earnings juga menjadi sinonim profit.

Konsol

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

    Buka Glosarium

  2. Luaskan glosarium dan klik istilah yang ingin Anda buat tautannya.

  3. Klik Edit di samping Istilah sinonim.

  4. Telusuri, lalu pilih istilah yang akan ditautkan.

    Istilah akan langsung ditautkan saat Anda memilihnya.

  5. Klik Close.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/TERM1_PROJECT_ID/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/synonym",
"entry_references": [{
     "name": "projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/glossaries/TERM1_GLOSSARY_ID/terms/TERM1_ID",
     "type": "UNSPECIFIED"
  }, {
     "name": "projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/glossaries/TERM2_GLOSSARY_ID/terms/TERM2_ID",
     "type": "UNSPECIFIED"
  }
  ]

}
EOF
)"

Ganti kode berikut:

  • TERM1_PROJECT_NUMBER: nomor project untuk periode pertama yang ditautkan.
  • TERM1_LOCATION_ID: ID lokasi glosarium yang berisi istilah pertama.
  • TERM1_GLOSSARY_ID: ID glosarium yang berisi istilah pertama.
  • TERM1_ID: ID istilah pertama.
  • TERM2_PROJECT_NUMBER: nomor project untuk istilah kedua yang ingin Anda tautkan sebagai istilah sinonim. Jika kedua istilah berada dalam project yang sama, nilai ini sama dengan nomor project untuk istilah pertama.
  • TERM2_LOCATION_ID: ID lokasi glosarium yang berisi istilah kedua. Jika kedua istilah berada di lokasi yang sama, nilai ini sama dengan ID lokasi untuk istilah pertama.
  • TERM2_GLOSSARY_ID: ID glosarium yang berisi istilah kedua. Jika kedua istilah berada dalam glosarium yang sama, maka nilai ini sama dengan ID glosarium untuk istilah pertama.
  • TERM2_ID: ID istilah kedua.
  • ENTRY_LINK_ID: ID untuk link antara dua istilah. Setiap istilah ditampilkan sebagai entri Katalog Universal Dataplex. Link entri adalah hubungan antara istilah sinonim.

Konsol

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

    Buka Glosarium

  2. Luaskan glosarium dan klik istilah yang ingin Anda buat tautannya.

  3. Klik Edit di samping Istilah terkait.

  4. Telusuri, lalu pilih istilah yang akan ditautkan.

    Istilah akan langsung ditautkan saat Anda memilihnya.

  5. Klik Close.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/TERM1_PROJECT_ID/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/related",
"entry_references": [{
     "name": "projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/glossaries/TERM1_GLOSSARY_ID/terms/TERM1_ID",
     "type": "UNSPECIFIED"
  }, {
     "name": "projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/glossaries/TERM2_GLOSSARY_ID/terms/TERM2_ID",
     "type": "UNSPECIFIED"
  }
  ]

}
EOF
)"

Ganti kode berikut:

  • TERM1_PROJECT_NUMBER: nomor project untuk istilah pertama yang ditautkan.
  • TERM1_LOCATION_ID: ID lokasi glosarium yang berisi istilah pertama.
  • TERM1_GLOSSARY_ID: ID glosarium yang berisi istilah pertama.
  • TERM1_ID: ID istilah pertama.
  • TERM2_PROJECT_NUMBER: nomor project untuk istilah kedua yang ingin Anda tautkan sebagai istilah terkait. Jika kedua istilah berada dalam project yang sama, nilai ini sama dengan nomor project untuk istilah pertama.
  • TERM2_LOCATION_ID: ID lokasi glosarium yang berisi istilah kedua. Jika kedua istilah berada di lokasi yang sama, nilai ini sama dengan ID lokasi untuk istilah pertama.
  • TERM2_GLOSSARY_ID: ID glosarium yang berisi istilah kedua. Jika kedua istilah berada dalam glosarium yang sama, maka nilai ini sama dengan ID glosarium untuk istilah pertama.
  • TERM2_ID: ID istilah kedua.
  • ENTRY_LINK_ID: ID untuk link antara dua istilah. Setiap istilah ditampilkan sebagai entri Katalog Universal Dataplex. Link entri adalah hubungan antara istilah terkait.

Konsol

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

    Buka Glosarium

  2. Perluas glosarium dan klik istilah yang sinonim atau istilah terkaitnya ingin Anda hapus.

  3. Untuk menghapus link antara istilah terkait, klik Edit di samping Istilah terkait. Hapus istilah terkait, lalu klik Tutup.

  4. Untuk menghapus link antar-sinonim, klik Edit di samping Istilah sinonim. Hapus sinonim, lalu klik Tutup.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID

Anda dapat melampirkan istilah ke aset data atau kolom aset data. Misalnya, Anda dapat melampirkan persyaratan ke set data BigQuery.

Konsol

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

    Buka Penelusuran

  2. Telusuri aset data (seperti set data, file, atau tabel) yang ingin Anda tautkan dengan istilah, lalu klik aset data tersebut.

  3. Di halaman aset data, lakukan salah satu hal berikut:

    • Untuk menautkan istilah ke aset, di tab Detail, di bagian Istilah glosarium, klik Tambahkan. Telusuri, lalu pilih istilah, lalu klik Tutup.
    • Jika aset memiliki skema, Anda dapat menautkan istilah ke kolom. Di tab Skema, pilih kolom untuk menautkan istilah, lalu klik Tambahkan istilah bisnis. Telusuri, lalu pilih istilah, lalu klik Tutup.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
  "entry_references": [{
     "name": "projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
     "type": "SOURCE"
  }, {
     "name": "projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID",
     "type": "TARGET"
  }
  ]
}
EOF
)"

Ganti kode berikut:

  • PROJECT_NUMBER: nomor project aset data yang ditautkan
  • ENTRY_LOCATION_ID: ID lokasi aset data yang ditautkan
  • ENTRY_GROUP_ID: grup entri aset data yang ditautkan
  • ENTRY_LINK_ID: ID untuk link antara istilah dan entri Katalog Universal Dataplex yang merepresentasikan aset data.
  • TERM_PROJECT_NUMBER: nomor project untuk istilah yang ditautkan.

Melampirkan istilah ke kolom dalam skema entri

Konsol

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

    Buka Penelusuran

  2. Telusuri aset data (seperti set data, file, atau tabel) yang memiliki skema dengan kolom yang ingin Anda kaitkan dengan istilah. Klik aset data.

  3. Di halaman aset data, lakukan salah satu hal berikut:

    • Untuk menautkan istilah ke kolom di aset data, di tab skema, pilih kolom yang ingin Anda lampirkan istilahnya.
    • Klik Tambahkan istilah bisnis. Telusuri istilah yang ingin Anda lampirkan dan klik istilah yang akan dilampirkan.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
  "type": "SOURCE"
  "path": "Schema/COLUMN_NAME"
}, {
  "name": "projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID",
  "type": "TARGET"
}
]
}
EOF
)"

Ganti kode berikut:

  • PROJECT_NUMBER: nomor project aset data yang ditautkan
  • ENTRY_LOCATION_ID: ID lokasi aset data yang ditautkan
  • ENTRY_GROUP_ID: grup entri aset data yang ditautkan
  • ENTRY_LINK_ID: ID untuk link antara istilah dan entri Katalog Universal Dataplex yang merepresentasikan aset data
  • TERM_PROJECT_NUMBER: nomor project untuk istilah yang ditautkan
  • COLUMN_NAME: kolom yang ingin Anda lampirkan istilahnya

Konsol

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

    Buka Penelusuran

  2. Telusuri aset data (seperti set data, file, atau tabel) yang ingin Anda hapus persyaratannya, lalu klik aset data tersebut.

  3. Di halaman aset data, lakukan salah satu hal berikut:

    • Untuk menghapus istilah dari aset, di tab Detail, di bagian Istilah glosarium, klik istilah. Kemudian, klik .
    • Untuk menghapus istilah dari kolom, di tab Skema, klik di samping istilah.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/ENTRY_PROJECT_ID/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID

Menemukan glosarium, istilah, dan aset data tertaut

Konsol

Untuk menjelajahi konten glosarium bisnis, gunakan hierarki glosarium dan istilah di halaman Glosarium.

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

    Buka Glosarium

  2. Di halaman Glosarium, gunakan kolom filter untuk menemukan kategori. Filter berikut tersedia:

    • Nama: menampilkan glosarium, kategori, dan istilah yang namanya berisi teks yang Anda berikan.
    • Induk: menampilkan istilah yang nama atau deskripsi glosarium induknya cocok dengan teks yang Anda berikan. Misalnya, parent:Finance menampilkan istilah yang terhubung dengan glosarium induk yang nama atau deskripsinya berisi frasa Finance.
    • Sinonim: menampilkan daftar istilah dengan sinonim yang nama atau ID-nya berisi teks yang Anda berikan. Misalnya, synonym:Profit menampilkan istilah yang memiliki istilah sinonim yang nama atau ID-nya berisi frasa profit.
    • Kontak: menampilkan persyaratan yang mencantumkan pengelola data sebagai kontak. Misalnya, contact:alex@example.com menampilkan entri yang terhubung ke istilah dengan pengelola data yang cocok dengan alex@example.com.

REST

Untuk menemukan glosarium, istilah, dan aset data tertaut menggunakan REST API, Anda harus mendaftar untuk Pratinjau.

Menelusuri aset data yang ditautkan ke istilah

Konsol

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

    Buka Glosarium

  2. Di halaman Glosarium, gunakan panel filter untuk memasukkan kueri penelusuran teks bentuk bebas. Tindakan ini akan menampilkan daftar kecocokan yang sesuai dalam glosarium, kategori, dan nama istilah.

  3. Klik istilah yang cocok.

  4. Di halaman Detail istilah, lihat istilah tertaut (sinonim dan istilah terkait) serta entri tertaut (aset data) untuk istilah ini.

  5. Jika Anda ingin melihat detail entri di Dataplex Universal Catalog, klik entri.

REST

Untuk menemukan glosarium, istilah, dan aset data tertaut menggunakan REST API, Anda harus mendaftar untuk Pratinjau.

Untuk mengimpor glosarium dan link dari alat katalog lainnya atau memperbarui glosarium di Katalog Universal Dataplex, Anda dapat mengimpor glosarium, kategori, istilah, link antar-istilah, link antara istilah dan aset data, atau kolom secara massal menggunakan REST API.

  1. Buat glosarium target.

    REST

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries?glossary_id=GLOSSARY_ID -d "$(cat<<EOF

{
 "displayName": "DISPLAY_NAME",
 "description": "DESCRIPTION"
}
EOF
)"

    Ganti kode berikut:

    • PROJECT_ID: project ID tempat Anda membuat glosarium
    • LOCATION_ID: lokasi tempat kita ingin membuat glosarium
    • GLOSSARY_ID: ID glosarium
    • DISPLAY_NAME: nama tampilan glosarium
    • DESCRIPTION: deskripsi glosarium

  2. Untuk mengimpor kategori, istilah, dan link antara istilah dan aset data dalam glosarium target yang dibuat, upload file untuk setiap item ini ke bucket Cloud Storage. File ini memiliki format berikut:

    • Contoh format untuk istilah dan kategori glosarium

       {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-category","aspects":{"dataplex-types.global.glossary-category-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","displayName":"CATEGORY_NAME","description":"CATEGORY_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"}]}}}
 {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM1_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-term","aspects":{"dataplex-types.global.glossary-term-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"TERM1_CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM1_ID","displayName":"TERM1_DISPLAY_NAME","description":"TERM1_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"},{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary-category"}]}}}
 {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM2_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-term","aspects":{"dataplex-types.global.glossary-term-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"TERM1_CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM2_ID","displayName":"TERM2_DISPLAY_NAME","description":"TERM2_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"},{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary-category"}]}}}

    • Contoh format untuk link antaristilah

       {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-0606e3f2-8206-4f3a-aba9-32c6196f6048","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/synonym","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-2"}]}}
 {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-2f7408e3-af3d-405d-81bb-861cf9ec5146","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/related","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-2"}]}}

    • Format contoh untuk link antara istilah dan aset data

       projects/PROJECT_NUMBER/locations/us-central1/entryGroups/entry-group-1/entries/entry-1 and term projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1
 {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-0606e3f2-8206-4f3a-aba9-32c6196f6048","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/definition","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/us-central1/entryGroups/entry-group-1/entries/entry-1"}]}}
 
    # Set GCURL alias
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
{
  "type":"IMPORT",
  "import_spec":{
     "log_level":"DEBUG",
     "source_storage_uri":"gs://STORAGE_BUCKET/",
     "entry_sync_mode":"FULL",
     "aspect_sync_mode":"INCREMENTAL",
     "scope":{
        "glossaries": "GLOSSARY_NAME"
     }
  }
}
EOF
)"

    Ganti DATAPLEX_API dengan endpoint API Dataplex Universal Catalog dalam format dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.

  3. Opsional: Dapatkan status operasi.

    gcurl https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/operation-OPERATION_ID

    Ganti OPERATION_ID dengan ID operasi.

  4. Opsional: Dapatkan status tugas metadata.

    gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/metadataJobs/JOB_ID

  5. Impor link antar-istilah sebagai sinonim atau istilah terkait.

    gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
{
  "type":"IMPORT",
  "import_spec":{
     "log_level":"DEBUG",
     "source_storage_uri":"gs://STORAGE_BUCKET/",
     "entry_sync_mode":"FULL",
     "aspect_sync_mode":"INCREMENTAL",
     "scope":{
        "entry_groups":[  "projects/PROJECT_ID/locations/LOCATION_ID/entryGroups/@dataplex"
        ],
        "entry_link_types":[
           "projects/dataplex-types/locations/global/entryLinkTypes/synonym",
           "projects/dataplex-types/locations/global/entryLinkTypes/related"
        ],
        "referenced_entry_scopes":[
           "PROJECT_IDS"
        ]
     }
  }
}
EOF
)"

    Ganti DATAPLEX_API dengan dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.

  6. Mengimpor link antara istilah dan aset data atau kolom.

    Untuk membuat penautan antara istilah glosarium dan aset data, jalankan tugas impor untuk setiap grup entri yang berisi entri untuk aset data. Semua link entri definisi dibuat dalam grup entri ini.

    gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
{
"type":"IMPORT",
"import_spec":{
  "log_level":"DEBUG",
  "source_storage_uri":"gs://STORAGE_BUCKET/",
  "entry_sync_mode":"FULL",
  "aspect_sync_mode":"INCREMENTAL",
  "scope":{
     "entry_groups":[  "projects/PROJECT_ID/locations/ENTRY_GROUP_LOCATION_ID/entryGroups/@dataplex"
     ],
     "entry_link_types":[
        "projects/dataplex-types/locations/global/entryLinkTypes/definition"
     ],
     "referenced_entry_scopes":[
        "PROJECT_IDS"
     ]
  }
}
}
EOF
)"

    Ganti DATAPLEX_API dengan dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.

Harga

Mulai Juli 2026, glosarium bisnis Dataplex Universal Catalog akan ditagih sama seperti harga penyimpanan metadata. Lihat Harga penyimpanan metadata Katalog Universal Dataplex.

Langkah berikutnya