Meminta perubahan metadata dengan alur kerja tata kelola

Dokumen ini menjelaskan cara mengusulkan perubahan resource tunggal pada kategori dan istilah glosarium bisnis, serta entri Knowledge Catalog (sebelumnya Dataplex Universal Catalog), menggunakan alur kerja tata kelola.

Sebelum memulai

Untuk menggunakan alur kerja tata kelola untuk perubahan metadata, pastikan Anda telah mengaktifkan API yang diperlukan dan memiliki peran serta izin Identity and Access Management (IAM) yang diperlukan.

Aktifkan Dataplex API, jika belum diaktifkan.

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

Mengaktifkan API

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk meminta perubahan metadata, minta administrator untuk memberi Anda peran IAM berikut pada project, glosarium, atau grup entri Anda:

Untuk mengetahui informasi selengkapnya tentang pemberian 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 tentang peran dan izin, lihat Peran IAM Knowledge Catalog.

Meminta perubahan untuk kategori glosarium

Jika tidak memiliki akses tulis langsung untuk membuat, memperbarui, atau menghapus kategori glosarium, Anda dapat meminta perubahan tersebut menggunakan alur kerja tata kelola. Setelah permintaan perubahan metadata dikirimkan, pemohon, pemberi persetujuan, dan administrator alur kerja dapat memantau dan mengelola permintaan selama siklus prosesnya.

Membuat kategori

Konsol

Ikuti langkah-langkah berikut untuk meminta kategori:

  1. Di konsol Google Cloud , buka halaman Glossaries Knowledge Catalog.

    Buka Glosarium

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

  3. Masukkan Nama tampilan untuk kategori.

  4. Opsional: Di bagian Labels, tambahkan label untuk glosarium.

  5. Opsional: Di bagian Justification, berikan alasan perubahan Anda kepada pemberi persetujuan.

  6. Di bagian Advanced Settings, Anda dapat mengedit Category ID jika ingin mengubah ID yang dibuat otomatis.

  7. Klik Kirim untuk ditinjau.

Sistem akan mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan. Anda dapat melacak progres permintaan di halaman Governance Workflows di tab My Requests.

REST

Untuk meminta pembuatan kategori, gunakan metode glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "createCategoryRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
      "categoryId": "sample-category-id",
      "category": {
        "displayName": "Sample category name",
        "description": "Sample category description",
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID"
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • LOCATION: region tempat glosarium berada, seperti us-central1.
  • GLOSSARY_ID: ID glosarium induk.
  • JUSTIFICATION: penjelasan alasan Anda mengusulkan perubahan.

Layanan akan menampilkan respons yang berisi nama resource permintaan perubahan. Sistem mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan.

Memperbarui kategori

Konsol

Ikuti langkah-langkah berikut untuk menyarankan perubahan pada kategori:

  1. Di konsol Google Cloud , buka halaman Glossaries Knowledge Catalog.

    Buka Glosarium

  2. Pilih glosarium yang menyertakan kategori yang ingin Anda perbarui.

  3. Klik nama kategori untuk membuka panel Detail kategori.

  4. Untuk menambahkan atau memperbarui detail kategori, klik Tambahkan atau Edit di samping bagian yang ingin Anda perbarui.

  5. Klik Kirim untuk ditinjau. Beberapa item mungkin memerlukan justifikasi tambahan untuk perubahan tersebut. Berikan justifikasi dan klik Proceed to Submit Changes.

Sistem akan mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan. Anda dapat melacak progres permintaan di halaman Governance Workflows di tab My Requests.

REST

Untuk meminta pembaruan pada nama tampilan dan deskripsi kategori, gunakan metode glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "updateCategoryRequest": {
      "category": {
        "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/categories/CATEGORY_ID",
        "displayName": "Sample new name",
        "description": "Sample new description"
      },
      "updateMask": {
        "paths": [
          "display_name",
          "description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • LOCATION: region tempat glosarium berada, seperti us-central1.
  • GLOSSARY_ID: ID glosarium induk.
  • CATEGORY_ID: ID kategori target yang ingin Anda perbarui.
  • JUSTIFICATION: penjelasan alasan Anda mengusulkan perubahan.

Layanan akan menampilkan respons yang berisi nama resource permintaan perubahan. Sistem mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan.

Menghapus kategori

Konsol

Ikuti langkah-langkah berikut untuk meminta penghapusan kategori:

  1. Di konsol Google Cloud , buka halaman Glossaries Knowledge Catalog.

    Buka Glosarium

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

  3. Di panel Category details, pilih Delete dari menu.

  4. Opsional: Di bagian Justification, berikan alasan perubahan Anda kepada pemberi persetujuan.

  5. Klik Kirim untuk ditinjau.

Sistem akan mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan. Anda dapat melacak progres permintaan di halaman Governance Workflows di tab My Requests.

REST

Untuk meminta penghapusan kategori, gunakan metode glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "deleteCategoryRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/categories/CATEGORY_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • LOCATION: region tempat glosarium berada, seperti us-central1.
  • GLOSSARY_ID: ID glosarium induk.
  • CATEGORY_ID: ID kategori target yang ingin Anda hapus.
  • JUSTIFICATION: penjelasan alasan Anda mengusulkan perubahan.

Layanan akan menampilkan respons yang berisi nama resource permintaan perubahan. Sistem mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan.

Meminta perubahan untuk istilah glosarium

Jika tidak memiliki akses tulis langsung untuk membuat, memperbarui, atau menghapus istilah glosarium, Anda dapat meminta perubahan tersebut menggunakan alur kerja tata kelola.

Membuat istilah glosarium

Konsol

Ikuti langkah-langkah berikut untuk meminta pembuatan istilah glosarium:

  1. Di konsol Google Cloud , buka halaman Glossaries Knowledge Catalog.

    Buka Glosarium

  2. Pilih glosarium atau kategori tempat Anda ingin membuat istilah untuk membuka panel detail.

    • Jika Anda membuat istilah dari halaman detail glosarium, pilih Create term dari menu.
    • Jika Anda membuat istilah dari halaman detail kategori, pilih Tambahkan istilah dari menu.

  3. Masukkan Nama tampilan untuk kategori.

  4. Opsional: Di bagian Label, tambahkan label untuk istilah.

  5. Opsional: Di bagian Justification, berikan alasan perubahan Anda kepada pemberi persetujuan.

  6. Di bagian Advanced Settings, Anda dapat mengedit Term ID jika ingin mengubah ID yang dibuat otomatis.

  7. Klik Kirim untuk ditinjau.

Sistem akan mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan. Anda dapat melacak progres permintaan di halaman Governance Workflows di tab My Requests.

REST

Untuk meminta pembuatan istilah glosarium, gunakan metode glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "createTermRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
      "termId": "sample-term-id",
      "term": {
        "displayName": "Sample term name",
        "description": "Sample term description",
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID"
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • LOCATION: region tempat glosarium berada, seperti us-central1.
  • GLOSSARY_ID: ID glosarium induk.
  • JUSTIFICATION: penjelasan alasan Anda mengusulkan perubahan.

Layanan akan menampilkan respons yang berisi nama resource permintaan perubahan. Sistem mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan.

Memperbarui istilah glosarium

Konsol

Ikuti langkah-langkah berikut untuk meminta perubahan pada istilah glosarium:

  1. Di konsol Google Cloud , buka halaman Glossaries Knowledge Catalog.

    Buka Glosarium

  2. Pilih glosarium yang menyertakan istilah yang ingin Anda perbarui.

  3. Klik nama istilah untuk membuka panel Detail istilah.

  4. Tambahkan atau perbarui detail persyaratan dengan mengklik Tambahkan atau Edit di samping bagian yang ingin Anda perbarui.

  5. Klik Kirim untuk ditinjau. Beberapa bagian mungkin mengharuskan Anda memberikan justifikasi tambahan sebelum dapat mengirimkan permintaan. Berikan justifikasi dan klik Lanjutkan untuk Mengirimkan Perubahan.

Sistem akan mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan. Anda dapat melacak progres permintaan di halaman Governance Workflows di tab My Requests.

REST

Untuk meminta pembaruan pada nama tampilan dan deskripsi istilah glosarium, gunakan metode glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "updateTermRequest": {
      "term": {
        "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/terms/TERM_ID",
        "displayName": "Sample new name",
        "description": "Sample new description"
      },
      "updateMask": {
        "paths": [
          "display_name",
          "description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • LOCATION: region tempat glosarium berada, seperti us-central1.
  • GLOSSARY_ID: ID glosarium induk.
  • TERM_ID: ID istilah target yang ingin Anda perbarui.
  • JUSTIFICATION: penjelasan alasan Anda mengusulkan perubahan.

Layanan akan menampilkan respons yang berisi nama resource permintaan perubahan. Sistem mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan.

Menghapus istilah glosarium

Konsol

Ikuti langkah-langkah berikut untuk meminta penghapusan istilah:

  1. Di konsol Google Cloud , buka halaman Glossaries Knowledge Catalog.

    Buka Glosarium

  2. Pilih glosarium yang berisi istilah yang ingin Anda hapus.

  3. Klik nama istilah untuk membuka panel Detail istilah.

  4. Klik Hapus.

  5. Klik Kirim untuk ditinjau. Beberapa bagian mungkin mengharuskan Anda memberikan justifikasi tambahan sebelum dapat mengirimkan permintaan. Berikan justifikasi dan klik Lanjutkan untuk Mengirimkan Perubahan.

Sistem akan mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan. Anda dapat melacak progres permintaan di halaman Governance Workflows di tab My Requests.

REST

Untuk meminta penghapusan istilah glosarium, gunakan metode glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "deleteTermRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/terms/TERM_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • LOCATION: region tempat glosarium berada, seperti us-central1.
  • GLOSSARY_ID: ID glosarium induk.
  • TERM_ID: ID istilah target yang ingin Anda hapus.
  • JUSTIFICATION: penjelasan alasan Anda mengusulkan perubahan.

Layanan akan menampilkan RequestGlossaryChangeResponse yang berisi nama resource ChangeRequest.Sistem akan mencatat permintaan perubahan baru ke dalam log dan memberi tahu pemberi persetujuan.

Meminta perubahan untuk entri

Jika tidak memiliki akses tulis langsung untuk membuat, mengubah, atau menghapus entri Knowledge Catalog, Anda dapat meminta perubahan tersebut menggunakan alur kerja tata kelola.

Membuat entri

Konsol

Ikuti langkah-langkah berikut untuk meminta pembuatan entri:

  1. Di konsol Google Cloud , buka halaman Metadata types Knowledge Catalog.

    Buka Jenis metadata

  2. Klik tab Entry groups.

  3. Pilih grup entri tempat Anda ingin membuat entri, lalu klik Create entry.

  4. Masukkan ID dan nama tampilan untuk entri.

  5. Pilih jenis entri.

  6. Opsional: Berikan detail aspek atau tambahkan deskripsi.

  7. Klik Kirim untuk ditinjau. Beberapa bagian mungkin mengharuskan Anda memberikan justifikasi tambahan sebelum dapat mengirimkan permintaan. Berikan justifikasi dan klik Lanjutkan untuk Mengirimkan Perubahan.

Sistem akan mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan. Anda dapat melacak progres permintaan di halaman Governance Workflows di tab My Requests.

REST

Untuk meminta pembuatan entri, gunakan metode entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "createEntryRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
      "entryId": "sample-entry-id",
      "entry": {
        "entryType": "projects/PROJECT_ID/locations/LOCATION/entryTypes/ENTRY_TYPE_ID",
        "entrySource": {
          "displayName": "Sample entry name",
          "description": "Sample entry description"
        }
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • LOCATION: region tempat grup entri berada, seperti us-central1.
  • ENTRY_GROUP_ID: ID grup entri induk.
  • ENTRY_TYPE_ID: ID jenis entri.
  • JUSTIFICATION: penjelasan alasan Anda mengusulkan perubahan.

Layanan akan menampilkan respons yang berisi nama resource permintaan perubahan. Sistem mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan.

Memperbarui entri

Konsol

Ikuti langkah-langkah berikut untuk meminta pembaruan entri:

  1. Di konsol Google Cloud , buka halaman Search atau Catalog Knowledge Catalog.

Buka Penelusuran

  1. Telusuri dan pilih entri yang ingin Anda perbarui.
  2. Klik entri untuk membuka halaman Entry details.
  3. Klik Tambahkan di samping bagian yang ingin Anda perbarui.
  4. Perbarui bagian.
  5. Klik Kirim untuk ditinjau. Beberapa bagian mungkin mengharuskan Anda memberikan justifikasi tambahan sebelum dapat mengirimkan permintaan. Berikan justifikasi dan klik Lanjutkan untuk Mengirimkan Perubahan.

Sistem akan mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan. Anda dapat melacak progres permintaan di halaman Governance Workflows di tab My requests.

REST

Untuk meminta pembaruan pada nama tampilan dan deskripsi sumber entri, gunakan metode entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "updateEntryRequest": {
      "entry": {
        "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
        "entrySource": {
          "displayName": "Sample new name",
          "description": "Sample new description"
        }
      },
      "updateMask": {
        "paths": [
          "entry_source.display_name",
          "entry_source.description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • LOCATION: region tempat grup entri berada, seperti us-central1.
  • ENTRY_GROUP_ID: ID grup entri induk.
  • ENTRY_ID: ID entri target.
  • JUSTIFICATION: penjelasan alasan Anda mengusulkan perubahan.

Layanan akan menampilkan respons yang berisi nama resource permintaan perubahan. Sistem mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan.

Menghapus entri

Konsol

Ikuti langkah-langkah berikut untuk meminta penghapusan entri:

  1. Di konsol Google Cloud , buka halaman Search atau Catalog Knowledge Catalog.

Buka Penelusuran

  1. Telusuri dan pilih entri yang ingin Anda hapus.
  2. Klik entri untuk membuka halaman Entry details.
  3. Klik Hapus.
  4. Klik Kirim untuk ditinjau. Beberapa bagian mungkin mengharuskan Anda memberikan justifikasi tambahan sebelum dapat mengirimkan permintaan. Berikan justifikasi dan klik Lanjutkan untuk Mengirimkan Perubahan.

Sistem akan mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan. Anda dapat melacak progres permintaan di halaman Governance Workflows di tab My Requests.

REST

Untuk meminta penghapusan entri, gunakan metode entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "deleteEntryRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • LOCATION: region tempat grup entri berada, seperti us-central1.
  • ENTRY_GROUP_ID: ID grup entri induk.
  • ENTRY_ID: ID entri target yang ingin Anda hapus.
  • JUSTIFICATION: penjelasan alasan Anda mengusulkan perubahan.

Layanan akan menampilkan respons yang berisi nama resource permintaan perubahan. Sistem mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan.

Memperbarui aspek

Konsol

Ikuti langkah-langkah berikut untuk meminta pembaruan pada aspek:

  1. Di konsol Google Cloud , buka halaman Search Knowledge Catalog.

Buka Penelusuran

  1. Telusuri dan pilih entri yang ingin Anda minta perubahannya.
  2. Klik entri untuk membuka halaman Entry details.
  3. Buka bagian Aspects dan klik Add.
  4. Berikan detail aspek.
  5. Opsional: Berikan alasan untuk perubahan Anda.
  6. Klik Kirim untuk ditinjau.

Sistem akan mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan. Anda dapat melacak progres permintaan di halaman Governance Workflows di tab My Requests.

REST

Untuk meminta pemasangan atau pembaruan aspek Kontak pada entri, gunakan metode entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "updateEntryRequest": {
      "entry": {
        "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
        "aspects": {
          "dataplex-types.global.contacts": {
            "data": {
              "identities": [
                {
                  "role": "Data Steward",
                  "name": "Dana",
                  "id": "dana@example.com"
                }
              ]
            }
          }
        }
      },
      "updateMask": {
        "paths": [
          "aspects"
        ]
      },
      "aspectKeys": [
        "dataplex-types.global.contacts"
      ]
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • LOCATION: region tempat grup entri berada, seperti us-central1.
  • ENTRY_GROUP_ID: ID grup entri induk.
  • ENTRY_ID: ID entri target.
  • JUSTIFICATION: penjelasan alasan Anda mengusulkan perubahan.

Layanan akan menampilkan respons yang berisi nama resource permintaan perubahan. Sistem mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan.

Membuat link entri

Konsol

Ikuti langkah-langkah berikut untuk meminta pembuatan link entri—misalnya, untuk melampirkan istilah glosarium:

  1. Di konsol Google Cloud , buka halaman Search Knowledge Catalog.

    Buka Penelusuran

  2. Telusuri dan pilih entri aset data yang ingin Anda tautkan dengan istilah.

  3. Di halaman detail entri, lakukan salah satu hal berikut:

    • Untuk menautkan istilah ke entri, di tab Details, di bagian Glossary terms, klik Add.
    • Untuk menautkan istilah ke kolom, di tab Schema, pilih kolom, lalu klik Add business term.

  4. Telusuri dan pilih istilah yang akan ditautkan.

  5. Opsional: Berikan alasan untuk perubahan Anda.

  6. Klik Kirim untuk ditinjau.

Sistem akan mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan. Anda dapat melacak progres permintaan di halaman Governance Workflows di tab My Requests.

REST

Untuk meminta pembuatan link definisi antara istilah glosarium dan entri aset data, gunakan metode entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "createEntryLinkRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
      "entryLinkId": "sample-definition-link",
      "entryLink": {
        "entryLinkType": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
        "entryReferences": [
          {
            "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
            "type": "SOURCE"
          },
          {
            "name": "projects/PROJECT_ID/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_ID/locations/global/glossaries/GLOSSARY_ID/terms/TERM_ID",
            "type": "TARGET"
          }
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • LOCATION: region tempat grup entri berada, seperti us-central1.
  • ENTRY_GROUP_ID: ID grup entri induk.
  • ENTRY_ID: ID entri target.
  • GLOSSARY_ID: ID glosarium yang berisi istilah tersebut.
  • TERM_ID: ID istilah glosarium.
  • JUSTIFICATION: penjelasan alasan Anda mengusulkan perubahan.

Layanan akan menampilkan respons yang berisi nama resource permintaan perubahan. Sistem mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan.

Menghapus link entri

Konsol

Ikuti langkah-langkah berikut untuk meminta penghapusan link entri—misalnya, untuk menghapus istilah glosarium yang dilampirkan:

  1. Di konsol Google Cloud , buka halaman Search Knowledge Catalog.

    Buka Penelusuran

  2. Telusuri dan pilih entri aset data yang ingin Anda hapus istilah tertautnya.

  3. Di halaman detail entri, lakukan salah satu hal berikut:

    • Untuk menghapus istilah dari entri, di tab Details, di bagian Glossary terms, klik istilah, lalu klik Remove.
    • Untuk menghapus istilah dari kolom, di tab Schema, klik Remove di samping istilah.

  4. Opsional: Berikan alasan untuk perubahan Anda.

  5. Klik Kirim untuk ditinjau.

Sistem akan mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan. Anda dapat melacak progres permintaan di halaman Governance Workflows di tab My Requests.

REST

Untuk meminta penghapusan link entri antara istilah glosarium dan entri aset data, gunakan metode entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "deleteEntryLinkRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • LOCATION: region tempat grup entri berada, seperti us-central1.
  • ENTRY_GROUP_ID: ID grup entri induk.
  • ENTRY_LINK_ID: ID link entri target yang ingin Anda hapus.
  • JUSTIFICATION: penjelasan alasan Anda mengusulkan perubahan.

Layanan akan menampilkan respons yang berisi nama resource permintaan perubahan. Sistem mencatat permintaan perubahan baru dan memberi tahu pemberi persetujuan.

Langkah berikutnya