Mengelola glosarium bisnis

Glosarium bisnis di Knowledge Catalog (sebelumnya Dataplex Universal Catalog) memungkinkan Anda membuat kosakata standar untuk aset data di seluruh organisasi. Anda dapat membuat dan mengelola kategori dan istilah untuk membantu mengurangi ambiguitas serta meningkatkan penemuan dan tata kelola data. Jika ini pertama kalinya Anda membuat glosarium bisnis, lihat panduan memulai Membuat dan menggunakan glosarium bisnis.

Kasus penggunaan glosarium bisnis Knowledge Catalog

Dengan membuat bahasa umum untuk data menggunakan glosarium bisnis Knowledge Catalog, Anda dapat mencapai hal berikut:

• Tentukan hierarki kategori bisnis dan istilah yang jelas.
• Menautkan konsep menggunakan sinonim dan menunjukkan hubungan antar-istilah.
• Menelusuri resource data berdasarkan konsep bisnis, bukan hanya nama teknis.

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

Elemen glosarium bisnis

Bagian ini menjelaskan elemen-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, dan tabel. Meskipun pemformatan HTML tidak didukung, Anda dapat menyertakan kode HTML yang diformat sebagai kode atau menambahkan link ke halaman HTML. Anda juga dapat menggunakan opsi pemformatan rich text seperti tebal, miring, garis bawah, daftar berbutir, paragraf, judul, dan blok kode. Ukuran maksimum yang didukung adalah 120 KB.

• Deskripsi. Menjelaskan glosarium. Teks di 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 membuat 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 dalam perusahaan Anda. Misalnya, departemen pemasaran perusahaan mungkin membuat istilah yang menjelaskan biaya per klik. Istilah ditentukan dalam glosarium bisnis, baik dalam glosarium secara langsung atau dalam kategori apa pun yang ditemukan dalam glosarium.

Istilah memiliki properti kategori serta properti berikut:

• Sinonim. Menentukan link antara istilah yang memiliki arti yang sama. Lihat Istilah sinonim.
• Istilah terkait. Menentukan link antara istilah yang secara konseptual terkait satu sama lain, 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.
• Aturan kualitas data. Menentukan persyaratan kualitas data untuk istilah tersebut. Untuk mengetahui informasi selengkapnya, lihat Menggunakan kembali aturan kualitas data.
• Kontak. Menentukan orang yang bertanggung jawab untuk mengelola istilah. Persyaratan tidak mewarisi kontak yang ditentukan dalam kategori.

Region 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 arti yang sama ditentukan oleh tim yang berbeda dalam glosarium yang berbeda. Misalnya, Anda dapat membuat sinonim untuk menautkan istilah "profit" dan "pendapatan".

Istilah terkait

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

• Glosarium bisnis ditempatkan dalam project dan lokasi; batasan untuk project dan lokasi berlaku untuk glosarium.
• Saat Anda menggunakan glosarium bisnis dengan agen data BigQuery, agen data dapat mengimpor maksimum 10 istilah glosarium per tabel. Jika Anda melampirkan lebih dari 10 istilah ke tabel, agen data akan mengabaikan istilah tambahan. Untuk performa agen data yang optimal, pastikan Anda juga memberikan deskripsi tingkat tabel dan tingkat kolom yang komprehensif pada tabel Anda.

Peran yang diperlukan

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

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

Untuk mengetahui informasi selengkapnya tentang pemberian 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, perluas 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 di 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, mencari, dan menghapus link istilah ke istilah sinonim di project Anda:
  • dataplex.entryLinks.create pada grup entri Knowledge Catalog dalam project tempat salah satu istilah glosarium berada. Link dibuat di grup entri yang diberi izin.
  • dataplex.entryGroups.useSynonymEntryLink pada grup entri Knowledge Catalog dalam project yang berisi salah satu istilah glosarium. Link dibuat di grup entri yang diberi izin.
  • dataplex.glossaryTerms.use pada glosarium yang istilahnya perlu dikaitkan.
  • dataplex.glossaryTerms.get pada istilah yang link sinonimnya Anda cari. Knowledge Catalog menyamarkan istilah sinonim dalam respons jika Anda tidak memiliki izin dataplex.glossaryTerms.get untuk istilah tersebut.
  • dataplex.entryLinks.delete pada grup entri Knowledge Catalog dalam project tempat link berada.
• Membuat, mencari, dan menghapus link istilah-ke-istilah terkait di project Anda:
  • dataplex.entryLinks.create pada grup entri Knowledge Catalog dalam project tempat salah satu istilah glosarium berada. Link dibuat di grup entri yang diberi izin.
  • dataplex.entryGroups.useRelatedEntryLink pada grup entri Knowledge Catalog dalam project yang berisi salah satu istilah glosarium. Link dibuat di grup entri yang diberi izin.
  • dataplex.entries.link pada grup entri Knowledge Catalog dalam project yang berisi entri yang sesuai dengan istilah glosarium.
  • dataplex.glossaryTerms.get pada istilah yang link terkaitnya Anda cari. Knowledge Catalog akan menyamarkan istilah terkait dalam respons jika Anda tidak memiliki izin dataplex.glossaryTerms.get untuk istilah tersebut.
  • dataplex.entryLinks.delete pada grup entri Knowledge Catalog di project tempat link berada.
• Membuat, mencari, dan menghapus link antara istilah dan aset atau kolom data di 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.
  • Izin baca sistem sumber (misalnya, bigquery.tables.get atau dataplex.glossaryTerms.get) pada entri yang link-nya Anda cari. Knowledge Catalog menyamarkan aset data dalam respons jika Anda tidak memiliki izin baca sistem sumber untuk aset tersebut.
  • 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 IAM Knowledge Catalog.

Membuat dan mengelola glosarium bisnis

Bagian berikut menjelaskan cara membuat, melihat, mengedit, dan menghapus glosarium bisnis. Saat Anda membuat glosarium bisnis, kategori, atau istilah, pastikan ID-nya mematuhi panduan penamaan resource Knowledge Catalog.

Catatan: Meminta perubahan metadata pada glosarium bisnis dan entri Knowledge Catalog dengan alur kerja tata kelola tersedia dalam pratinjau pribadi. Untuk meminta akses ke fitur ini, isi formulir akses berikut.

Membuat glosarium bisnis

Konsol

1. Di konsol Google Cloud , buka halaman Glossaries Knowledge 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 Create. Glosarium dibuat di project saat ini.

5. Opsional: Tambahkan deskripsi singkat di Description (maksimal 1.024 karakter) atau deskripsi panjang di Overview (maksimal 120 KB).

C#

C#

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan C# di Panduan memulai Knowledge Catalog menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Knowledge Catalog C# API.

Untuk melakukan autentikasi ke Knowledge Catalog, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

using Google.Api.Gax.ResourceNames;
using Google.Cloud.Dataplex.V1;
using Google.LongRunning;

public sealed partial class GeneratedBusinessGlossaryServiceClientSnippets
{
    /// <summary>Snippet for CreateGlossary</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void CreateGlossaryRequestObject()
    {
        // Create client
        BusinessGlossaryServiceClient businessGlossaryServiceClient = BusinessGlossaryServiceClient.Create();
        // Initialize request argument(s)
        CreateGlossaryRequest request = new CreateGlossaryRequest
        {
            ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
            GlossaryId = "",
            Glossary = new Glossary(),
            ValidateOnly = false,
        };
        // Make the request
        Operation<Glossary, OperationMetadata> response = businessGlossaryServiceClient.CreateGlossary(request);

        // Poll until the returned long-running operation is complete
        Operation<Glossary, OperationMetadata> completedResponse = response.PollUntilCompleted();
        // Retrieve the operation result
        Glossary result = completedResponse.Result;

        // Or get the name of the operation
        string operationName = response.Name;
        // This name can be stored, then the long-running operation retrieved later by name
        Operation<Glossary, OperationMetadata> retrievedResponse = businessGlossaryServiceClient.PollOnceCreateGlossary(operationName);
        // Check if the retrieved long-running operation has completed
        if (retrievedResponse.IsCompleted)
        {
            // If it has completed, then access the result
            Glossary retrievedResult = retrievedResponse.Result;
        }
    }
}

Go

Go

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di Panduan memulai Knowledge Catalog menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Knowledge Catalog Go API.

Untuk melakukan autentikasi ke Knowledge Catalog, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

//go:build examples

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewBusinessGlossaryClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.CreateGlossaryRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#CreateGlossaryRequest.
	}
	op, err := c.CreateGlossary(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}

	resp, err := op.Wait(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

Java

Java

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di Panduan memulai Knowledge Catalog menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Knowledge Catalog Java API.

Untuk melakukan autentikasi ke Knowledge Catalog, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

import com.google.cloud.dataplex.v1.BusinessGlossaryServiceClient;
import com.google.cloud.dataplex.v1.CreateGlossaryRequest;
import com.google.cloud.dataplex.v1.Glossary;
import com.google.cloud.dataplex.v1.LocationName;

public class SyncCreateGlossary {

  public static void main(String[] args) throws Exception {
    syncCreateGlossary();
  }

  public static void syncCreateGlossary() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (BusinessGlossaryServiceClient businessGlossaryServiceClient =
        BusinessGlossaryServiceClient.create()) {
      CreateGlossaryRequest request =
          CreateGlossaryRequest.newBuilder()
              .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
              .setGlossaryId("glossaryId1849967577")
              .setGlossary(Glossary.newBuilder().build())
              .setValidateOnly(true)
              .build();
      Glossary response = businessGlossaryServiceClient.createGlossaryAsync(request).get();
    }
  }
}

Node.js

Node.js

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di Panduan memulai Knowledge Catalog menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Knowledge Catalog Node.js API.

Untuk melakukan autentikasi ke Knowledge Catalog, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. The parent resource where this Glossary will be created.
 *  Format: projects/{project_id_or_number}/locations/{location_id}
 *  where `location_id` refers to a Google Cloud region.
 */
// const parent = 'abc123'
/**
 *  Required. Glossary ID: Glossary identifier.
 */
// const glossaryId = 'abc123'
/**
 *  Required. The Glossary to create.
 */
// const glossary = {}
/**
 *  Optional. Validates the request without actually creating the Glossary.
 *  Default: false.
 */
// const validateOnly = true

// Imports the Dataplex library
const {BusinessGlossaryServiceClient} = require('@google-cloud/dataplex').v1;

// Instantiates a client
const dataplexClient = new BusinessGlossaryServiceClient();

async function callCreateGlossary() {
  // Construct request
  const request = {
    parent,
    glossaryId,
    glossary,
  };

  // Run request
  const [operation] = await dataplexClient.createGlossary(request);
  const [response] = await operation.promise();
  console.log(response);
}

callCreateGlossary();

Python

Python

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di Panduan memulai Knowledge Catalog menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Knowledge Catalog Python API.

Untuk melakukan autentikasi ke Knowledge Catalog, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_create_glossary():
    # Create a client
    client = dataplex_v1.BusinessGlossaryServiceClient()

    # Initialize request argument(s)
    request = dataplex_v1.CreateGlossaryRequest(
        parent="parent_value",
        glossary_id="glossary_id_value",
    )

    # Make the request
    operation = client.create_glossary(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

Ruby

Ruby

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Ruby di Panduan memulai Knowledge Catalog menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Knowledge Catalog Ruby API.

Untuk melakukan autentikasi ke Knowledge Catalog, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

require "google/cloud/dataplex/v1"

##
# Snippet for the create_glossary call in the BusinessGlossaryService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::BusinessGlossaryService::Client#create_glossary.
#
def create_glossary
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::BusinessGlossaryService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::CreateGlossaryRequest.new

  # Call the create_glossary method.
  result = client.create_glossary request

  # The returned object is of type Gapic::Operation. You can use it to
  # check the status of an operation, cancel it, or wait for results.
  # Here is how to wait for a response.
  result.wait_until_done! timeout: 60
  if result.response?
    p result.response
  else
    puts "No response received."
  end
end

REST

Saat Anda membuat glosarium, Knowledge Catalog akan membuat entri untuk mewakili glosarium tersebut.

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, 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. Tambahkan 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 Glossaries Knowledge Catalog.

  Buka Glosarium

  Panel My glossaries menampilkan semua glosarium organisasi yang izinnya Anda miliki untuk melihatnya, beserta deskripsi dan stempel waktu terakhir diubah.

C#

C#

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan C# di Panduan memulai Knowledge Catalog menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Knowledge Catalog C# API.

Untuk melakukan autentikasi ke Knowledge Catalog, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

using Google.Api.Gax;
using Google.Api.Gax.ResourceNames;
using Google.Cloud.Dataplex.V1;
using System;

public sealed partial class GeneratedBusinessGlossaryServiceClientSnippets
{
    /// <summary>Snippet for ListGlossaries</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void ListGlossariesRequestObject()
    {
        // Create client
        BusinessGlossaryServiceClient businessGlossaryServiceClient = BusinessGlossaryServiceClient.Create();
        // Initialize request argument(s)
        ListGlossariesRequest request = new ListGlossariesRequest
        {
            ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
            Filter = "",
            OrderBy = "",
        };
        // Make the request
        PagedEnumerable<ListGlossariesResponse, Glossary> response = businessGlossaryServiceClient.ListGlossaries(request);

        // Iterate over all response items, lazily performing RPCs as required
        foreach (Glossary item in response)
        {
            // Do something with each item
            Console.WriteLine(item);
        }

        // Or iterate over pages (of server-defined size), performing one RPC per page
        foreach (ListGlossariesResponse page in response.AsRawResponses())
        {
            // Do something with each page of items
            Console.WriteLine("A page of results:");
            foreach (Glossary item in page)
            {
                // Do something with each item
                Console.WriteLine(item);
            }
        }

        // Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
        int pageSize = 10;
        Page<Glossary> singlePage = response.ReadPage(pageSize);
        // Do something with the page of items
        Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
        foreach (Glossary item in singlePage)
        {
            // Do something with each item
            Console.WriteLine(item);
        }
        // Store the pageToken, for when the next page is required.
        string nextPageToken = singlePage.NextPageToken;
    }
}

Go

Go

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di Panduan memulai Knowledge Catalog menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Knowledge Catalog Go API.

Untuk melakukan autentikasi ke Knowledge Catalog, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

//go:build examples

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
	"google.golang.org/api/iterator"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewBusinessGlossaryClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.ListGlossariesRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#ListGlossariesRequest.
	}
	it := c.ListGlossaries(ctx, req)
	for {
		resp, err := it.Next()
		if err == iterator.Done {
			break
		}
		if err != nil {
			// TODO: Handle error.
		}
		// TODO: Use resp.
		_ = resp

		// If you need to access the underlying RPC response,
		// you can do so by casting the `Response` as below.
		// Otherwise, remove this line. Only populated after
		// first call to Next(). Not safe for concurrent access.
		_ = it.Response.(*dataplexpb.ListGlossariesResponse)
	}
}

Java

Java

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di Panduan memulai Knowledge Catalog menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Knowledge Catalog Java API.

Untuk melakukan autentikasi ke Knowledge Catalog, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

import com.google.cloud.dataplex.v1.BusinessGlossaryServiceClient;
import com.google.cloud.dataplex.v1.Glossary;
import com.google.cloud.dataplex.v1.ListGlossariesRequest;
import com.google.cloud.dataplex.v1.LocationName;

public class SyncListGlossaries {

  public static void main(String[] args) throws Exception {
    syncListGlossaries();
  }

  public static void syncListGlossaries() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (BusinessGlossaryServiceClient businessGlossaryServiceClient =
        BusinessGlossaryServiceClient.create()) {
      ListGlossariesRequest request =
          ListGlossariesRequest.newBuilder()
              .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setFilter("filter-1274492040")
              .setOrderBy("orderBy-1207110587")
              .build();
      for (Glossary element : businessGlossaryServiceClient.listGlossaries(request).iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

Node.js

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di Panduan memulai Knowledge Catalog menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Knowledge Catalog Node.js API.

Untuk melakukan autentikasi ke Knowledge Catalog, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. The parent, which has this collection of Glossaries.
 *  Format: projects/{project_id_or_number}/locations/{location_id}
 *  where `location_id` refers to a Google Cloud region.
 */
// const parent = 'abc123'
/**
 *  Optional. The maximum number of Glossaries to return. The service may
 *  return fewer than this value. If unspecified, at most 50 Glossaries will be
 *  returned. The maximum value is 1000; values above 1000 will be coerced to
 *  1000.
 */
// const pageSize = 1234
/**
 *  Optional. A page token, received from a previous `ListGlossaries` call.
 *  Provide this to retrieve the subsequent page.
 *  When paginating, all other parameters provided to `ListGlossaries` must
 *  match the call that provided the page token.
 */
// const pageToken = 'abc123'
/**
 *  Optional. Filter expression that filters Glossaries listed in the response.
 *  Filters on proto fields of Glossary are supported.
 *  Examples of using a filter are:
 *    - `display_name="my-glossary"`
 *    - `categoryCount=1`
 *    - `termCount=0`
 */
// const filter = 'abc123'
/**
 *  Optional. Order by expression that orders Glossaries listed in the
 *  response. Order by fields are: `name` or `create_time` for the result. If
 *  not specified, the ordering is undefined.
 */
// const orderBy = 'abc123'

// Imports the Dataplex library
const {BusinessGlossaryServiceClient} = require('@google-cloud/dataplex').v1;

// Instantiates a client
const dataplexClient = new BusinessGlossaryServiceClient();

async function callListGlossaries() {
  // Construct request
  const request = {
    parent,
  };

  // Run request
  const iterable = dataplexClient.listGlossariesAsync(request);
  for await (const response of iterable) {
      console.log(response);
  }
}

callListGlossaries();

Python

Python

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di Panduan memulai Knowledge Catalog menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Knowledge Catalog Python API.

Untuk melakukan autentikasi ke Knowledge Catalog, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_list_glossaries():
    # Create a client
    client = dataplex_v1.BusinessGlossaryServiceClient()

    # Initialize request argument(s)
    request = dataplex_v1.ListGlossariesRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_glossaries(request=request)

    # Handle the response
    for response in page_result:
        print(response)

Ruby

Ruby

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Ruby di Panduan memulai Knowledge Catalog menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Knowledge Catalog Ruby API.

Untuk melakukan autentikasi ke Knowledge Catalog, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

require "google/cloud/dataplex/v1"

##
# Snippet for the list_glossaries call in the BusinessGlossaryService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::BusinessGlossaryService::Client#list_glossaries.
#
def list_glossaries
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::BusinessGlossaryService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::ListGlossariesRequest.new

  # Call the list_glossaries method.
  result = client.list_glossaries request

  # The returned object is of type Gapic::PagedEnumerable. You can iterate
  # over elements, and API calls will be issued to fetch pages as needed.
  result.each do |item|
    # Each element is of type ::Google::Cloud::Dataplex::V1::Glossary.
    p item
  end
end

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 Glossaries Knowledge 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 Glossaries Knowledge Catalog.

   Buka Glosarium

2. Klik glosarium yang ingin Anda hapus.

3. Klik Delete, lalu konfirmasi saat diminta.

C#

C#

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan C# di Panduan memulai Knowledge Catalog menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Knowledge Catalog C# API.

Untuk melakukan autentikasi ke Knowledge Catalog, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

using Google.Cloud.Dataplex.V1;
using Google.LongRunning;
using Google.Protobuf.WellKnownTypes;

public sealed partial class GeneratedBusinessGlossaryServiceClientSnippets
{
    /// <summary>Snippet for DeleteGlossary</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void DeleteGlossaryRequestObject()
    {
        // Create client
        BusinessGlossaryServiceClient businessGlossaryServiceClient = BusinessGlossaryServiceClient.Create();
        // Initialize request argument(s)
        DeleteGlossaryRequest request = new DeleteGlossaryRequest
        {
            GlossaryName = GlossaryName.FromProjectLocationGlossary("[PROJECT]", "[LOCATION]", "[GLOSSARY]"),
            Etag = "",
        };
        // Make the request
        Operation<Empty, OperationMetadata> response = businessGlossaryServiceClient.DeleteGlossary(request);

        // Poll until the returned long-running operation is complete
        Operation<Empty, OperationMetadata> completedResponse = response.PollUntilCompleted();
        // Retrieve the operation result
        Empty result = completedResponse.Result;

        // Or get the name of the operation
        string operationName = response.Name;
        // This name can be stored, then the long-running operation retrieved later by name
        Operation<Empty, OperationMetadata> retrievedResponse = businessGlossaryServiceClient.PollOnceDeleteGlossary(operationName);
        // Check if the retrieved long-running operation has completed
        if (retrievedResponse.IsCompleted)
        {
            // If it has completed, then access the result
            Empty retrievedResult = retrievedResponse.Result;
        }
    }
}

Go

Go

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di Panduan memulai Knowledge Catalog menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Knowledge Catalog Go API.

Untuk melakukan autentikasi ke Knowledge Catalog, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

//go:build examples

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewBusinessGlossaryClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.DeleteGlossaryRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#DeleteGlossaryRequest.
	}
	op, err := c.DeleteGlossary(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}

	err = op.Wait(ctx)
	if err != nil {
		// TODO: Handle error.
	}
}

Java

Java

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di Panduan memulai Knowledge Catalog menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Knowledge Catalog Java API.

Untuk melakukan autentikasi ke Knowledge Catalog, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

import com.google.cloud.dataplex.v1.BusinessGlossaryServiceClient;
import com.google.cloud.dataplex.v1.DeleteGlossaryRequest;
import com.google.cloud.dataplex.v1.GlossaryName;
import com.google.protobuf.Empty;

public class SyncDeleteGlossary {

  public static void main(String[] args) throws Exception {
    syncDeleteGlossary();
  }

  public static void syncDeleteGlossary() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (BusinessGlossaryServiceClient businessGlossaryServiceClient =
        BusinessGlossaryServiceClient.create()) {
      DeleteGlossaryRequest request =
          DeleteGlossaryRequest.newBuilder()
              .setName(GlossaryName.of("[PROJECT]", "[LOCATION]", "[GLOSSARY]").toString())
              .setEtag("etag3123477")
              .build();
      businessGlossaryServiceClient.deleteGlossaryAsync(request).get();
    }
  }
}

Node.js

Node.js

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di Panduan memulai Knowledge Catalog menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Knowledge Catalog Node.js API.

Untuk melakukan autentikasi ke Knowledge Catalog, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. The name of the Glossary to delete.
 *  Format:
 *  projects/{project_id_or_number}/locations/{location_id}/glossaries/{glossary_id}
 */
// const name = 'abc123'
/**
 *  Optional. The etag of the Glossary.
 *  If this is provided, it must match the server's etag.
 *  If the etag is provided and does not match the server-computed etag,
 *  the request must fail with a ABORTED error code.
 */
// const etag = 'abc123'

// Imports the Dataplex library
const {BusinessGlossaryServiceClient} = require('@google-cloud/dataplex').v1;

// Instantiates a client
const dataplexClient = new BusinessGlossaryServiceClient();

async function callDeleteGlossary() {
  // Construct request
  const request = {
    name,
  };

  // Run request
  const [operation] = await dataplexClient.deleteGlossary(request);
  const [response] = await operation.promise();
  console.log(response);
}

callDeleteGlossary();

Python

Python

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di Panduan memulai Knowledge Catalog menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Knowledge Catalog Python API.

Untuk melakukan autentikasi ke Knowledge Catalog, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_delete_glossary():
    # Create a client
    client = dataplex_v1.BusinessGlossaryServiceClient()

    # Initialize request argument(s)
    request = dataplex_v1.DeleteGlossaryRequest(
        name="name_value",
    )

    # Make the request
    operation = client.delete_glossary(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

Ruby

Ruby

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Ruby di Panduan memulai Knowledge Catalog menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Knowledge Catalog Ruby API.

Untuk melakukan autentikasi ke Knowledge Catalog, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

require "google/cloud/dataplex/v1"

##
# Snippet for the delete_glossary call in the BusinessGlossaryService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::BusinessGlossaryService::Client#delete_glossary.
#
def delete_glossary
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::BusinessGlossaryService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::DeleteGlossaryRequest.new

  # Call the delete_glossary method.
  result = client.delete_glossary request

  # The returned object is of type Gapic::Operation. You can use it to
  # check the status of an operation, cancel it, or wait for results.
  # Here is how to wait for a response.
  result.wait_until_done! timeout: 60
  if result.response?
    p result.response
  else
    puts "No response received."
  end
end

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 di glosarium

Glosarium bisnis dapat memiliki maksimum 200 kategori.

Konsol

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 untuk kategori.

4. Klik Create.

5. Opsional: Tambahkan deskripsi singkat di Description (maksimal 1.024 karakter) atau deskripsi panjang di Overview (maksimal 120 KB).

REST

Saat Anda membuat kategori, Knowledge Catalog akan membuat entri untuk mewakili 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. Tambahkan 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 Glossaries Knowledge Catalog.

   Buka Glosarium

2. Luaskan glosarium tempat Anda ingin membuat kategori.

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

4. Masukkan nama untuk kategori.

5. Klik Create.

6. Opsional: Tambahkan deskripsi singkat di Description (maksimal 1.024 karakter) atau deskripsi panjang di Overview (maksimal 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 Glossaries Knowledge 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 Glossaries Knowledge Catalog.

   Buka Glosarium

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

3. Klik Edit di samping nama, deskripsi, atau ringkasan, lalu lakukan 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 Glossaries Knowledge Catalog.

   Buka Glosarium

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

3. Klik Delete, 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 persyaratan

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 Glossaries Knowledge Catalog.

   Buka Glosarium

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

3. Masukkan nama untuk istilah.

4. Klik Create.

5. Opsional: Tambahkan deskripsi singkat di Description (maksimal 1.024 karakter) atau deskripsi panjang di Overview (maksimal 120 KB).

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

REST

Saat Anda membuat istilah, Knowledge Catalog akan membuat entri untuk mewakili 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 istilah 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 Glossaries Knowledge 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 Create.

5. Opsional: Tambahkan deskripsi singkat di Description (maksimal 1.024 karakter) atau deskripsi panjang di Overview (maksimal 120 KB).

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

REST

Saat Anda membuat istilah, Knowledge Catalog akan membuat entri untuk mewakili 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 istilah 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

Menambahkan aspek ke istilah

Anda dapat menambahkan aspek ke istilah untuk memberikan konteks atau metadata tambahan.

Konsol

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

   Buka Glosarium

2. Luaskan glosarium dan klik istilah yang ingin Anda tambahkan aspeknya.

3. Di bagian Aspects, klik Add.

4. Telusuri aspek, berikan detail untuk aspek, lalu klik Save.

REST

Istilah glosarium adalah entri. Untuk melampirkan aspek, patch resource entri. Grup entri untuk glosarium adalah @dataplex.

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_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID?update_mask=aspects\&aspect_keys=ASPECT_PROJECT_ID.ASPECT_LOCATION_ID.ASPECT_TYPE_ID --data @- << EOF
{
 "aspects": {
   "ASPECT_PROJECT_ID.ASPECT_LOCATION_ID.ASPECT_TYPE_ID": {
     "aspect_type": "projects/ASPECT_PROJECT_ID/locations/ASPECT_LOCATION_ID/aspectTypes/ASPECT_TYPE_ID",
     "data": {
       "sensitivity": "HIGH",
       "data_owner": "[e-mail]"
     }
   }
 }
}
EOF

Ganti kode berikut:

• PROJECT_NUMBER: nomor project yang berisi istilah glosarium.
• LOCATION_ID: lokasi istilah glosarium.
• GLOSSARY_ID: ID glosarium yang berisi istilah tersebut.
• TERM_ID: ID istilah yang akan dilampiri aspek.
• ASPECT_PROJECT_ID: ID project yang berisi jenis aspek.
• ASPECT_LOCATION_ID: lokasi jenis aspek.
• ASPECT_TYPE_ID: ID jenis aspek.

Melihat istilah dalam glosarium atau kategori

Konsol

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

   Buka Glosarium

2. Untuk melihat istilah dalam glosarium, luaskan glosarium. Untuk melihat istilah dalam kategori dalam glosarium ini, luaskan 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 Glossaries Knowledge Catalog.

   Buka Glosarium

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

3. Klik istilah. Halaman Term details 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 istilah.

Konsol

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

   Buka Glosarium

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

3. Klik Edit.

4. Edit salah satu 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 Glossaries Knowledge Catalog.

   Buka Glosarium

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

3. Klik Delete, 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

Mengelola sinonim dan istilah terkait

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 dari earnings, earnings juga menjadi sinonim dari profit.

Membuat link sinonim antar-istilah

Konsol

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

   Buka Glosarium

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

3. Klik Edit di samping Synonym terms.

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 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 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, nilai ini sama dengan ID glosarium untuk istilah pertama.
• TERM2_ID: ID istilah kedua.
• ENTRY_LINK_ID: ID untuk link antara kedua istilah. Setiap istilah direpresentasikan sebagai entri Knowledge Catalog. Link entri adalah hubungan antara istilah sinonim.

Membuat link terkait antar-istilah

Konsol

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

   Buka Glosarium

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

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, nilai ini sama dengan ID glosarium untuk istilah pertama.
• TERM2_ID: ID istilah kedua.
• ENTRY_LINK_ID: ID untuk link antara kedua istilah. Setiap istilah direpresentasikan sebagai entri Knowledge Catalog. Link entri adalah hubungan antara istilah terkait.

Mencari link sinonim untuk sebuah istilah

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/TERM_PROJECT_ID/locations/SYNONYM_LINKS_LOCATION_ID:lookupEntryLinks?entry=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&entry_link_types=projects/dataplex-types/locations/global/entryLinkTypes/synonym&page_size=10

Ganti kode berikut:

• TERM_PROJECT_ID: project ID istilah yang link sinonimnya Anda cari.
• TERM_PROJECT_NUMBER: nomor project dari istilah yang link sinonimnya Anda cari.
• SYNONYM_LINKS_LOCATION_ID: ID lokasi tempat Anda mencari link sinonim.
• TERM_LOCATION_ID: ID lokasi istilah.
• TERM_GLOSSARY_ID: ID glosarium yang berisi istilah tersebut.
• TERM_ID: ID istilah.

Catatan: Untuk mengambil halaman berikutnya, tambahkan &page_token=PAGE_TOKEN ke permintaan. Ganti PAGE_TOKEN dengan nilai token halaman yang Anda terima dari respons lookupEntryLinks sebelumnya.

Mencari link terkait untuk suatu istilah

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/TERM_PROJECT_ID/locations/RELATED_LINKS_LOCATION_ID:lookupEntryLinks?entry=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&entry_link_types=projects/dataplex-types/locations/global/entryLinkTypes/related&page_size=10

Ganti kode berikut:

• TERM_PROJECT_ID: project ID istilah yang link terkaitnya Anda cari.
• TERM_PROJECT_NUMBER: nomor project dari istilah yang link terkaitnya Anda cari.
• RELATED_LINKS_LOCATION_ID: ID lokasi tempat Anda mencari link terkait.
• TERM_LOCATION_ID: ID lokasi istilah.
• TERM_GLOSSARY_ID: ID glosarium yang berisi istilah tersebut.
• TERM_ID: ID istilah.

Catatan: Untuk mengambil halaman berikutnya, tambahkan &page_token=PAGE_TOKEN ke permintaan. Ganti PAGE_TOKEN dengan nilai token halaman yang Anda terima dari respons lookupEntryLinks sebelumnya.

Menghapus link antara sinonim dan istilah terkait

Konsol

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

   Buka Glosarium

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

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

4. Untuk menghapus link di antara sinonim, klik Edit di samping Istilah sinonim. Hapus sinonim, lalu klik Close.

REST

1. Cari link entri untuk menemukan ID link entri dari link yang ingin Anda hapus. Untuk mengetahui informasi selengkapnya, lihat Mencari link sinonim untuk istilah atau Mencari link terkait untuk istilah.

2. Hapus link dengan mengirimkan permintaan DELETE berikut:

   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

Mengelola penautan antara istilah dan aset data

Anda dapat melampirkan istilah ke aset data atau kolom aset data. Misalnya, Anda dapat melampirkan istilah ke set data BigQuery dan tabel Iceberg REST Catalog.

Melampirkan istilah ke aset data

Konsol

1. Di konsol Google Cloud , buka halaman Search Knowledge 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 tindakan berikut:

   • Untuk menautkan istilah ke aset, di tab Details, di bagian Glossary terms, klik Add. Telusuri, lalu pilih persyaratan, lalu klik Close.
   • Jika aset memiliki skema, Anda dapat menautkan istilah ke kolom. Di tab Schema, pilih kolom untuk menautkan istilah, lalu klik Add business term. Telusuri, lalu pilih persyaratan, lalu klik Close.

Python

from google.cloud import dataplex_v1

def attach_term_to_asset(
    project_id: str,
    location: str,
    entry_group_id: str,
    entry_link_id: str,
    source_entry_name: str,
    target_term_name: str,
) -> dataplex_v1.EntryLink:
    """Creates an entry link attaching a glossary term to a data asset."""
    client = dataplex_v1.CatalogServiceClient()
    parent_group = (
        f"projects/{project_id}/locations/{location}/"
        f"entryGroups/{entry_group_id}"
    )

    entry_link = dataplex_v1.EntryLink(
        entry_link_type=(
            "projects/dataplex-types/locations/global/"
            "entryLinkTypes/definition"
        ),
        entry_references=[
            dataplex_v1.EntryLink.EntryReference(
                name=source_entry_name, type_="SOURCE"
            ),
            dataplex_v1.EntryLink.EntryReference(
                name=target_term_name, type_="TARGET"
            ),
        ],
    )

    return client.create_entry_link(
        parent=parent_group,
        entry_link_id=entry_link_id,
        entry_link=entry_link,
    )

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 Knowledge Catalog yang mewakili 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 Search Knowledge Catalog.

   Buka Penelusuran

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

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

   • Untuk menautkan istilah ke kolom di aset data, di tab Schema, pilih kolom yang ingin Anda lampirkan istilahnya.
   • Klik Add business term. Telusuri istilah yang ingin Anda lampirkan dan klik istilah tersebut untuk melampirkannya.

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",
     "path": "Schema.COLUMN_NAME",
     "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 Knowledge Catalog yang mewakili aset data
• TERM_PROJECT_NUMBER: nomor project untuk istilah yang ditautkan
• COLUMN_NAME: kolom tempat Anda ingin melampirkan istilah

Melampirkan istilah ke beberapa aset atau kolom data

Anda dapat melampirkan satu istilah glosarium ke beberapa aset atau kolom data secara bersamaan. Anda dapat memilih hingga 20 resource atau kolom dalam satu operasi.

Konsol

Untuk melampirkan istilah ke beberapa resource, ikuti langkah-langkah berikut:

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

   Buka Glosarium

2. Dalam daftar Glosarium, luaskan glosarium yang berisi istilah yang ingin Anda tautkan.

3. Klik istilah.

4. Di bagian Related entries, klik Add.

5. Pada dialog Attach related entries, selesaikan langkah-langkah berikut:

   1. Temukan resource atau kolom yang ingin Anda tautkan. Untuk mempersempit hasil penelusuran, gunakan Filter untuk menelusuri berdasarkan nama resource, jenis resource, atau nama kolom.

      Misalnya, untuk menemukan kolom bernama sample-column dalam tabel BigQuery bernama sample-table dalam project dengan ID sample-project, gunakan kueri berikut:

      project id:sample-project
      Resource Name:sample-table
      Column Name:sample-column
      

      Anda dapat memasukkan string parsial untuk menemukan aset yang cocok.

   2. Pilih aset dan kolom data yang ingin Anda lampirkan.

   3. Untuk meninjau pilihan Anda sebelum menambahkan, klik tombol Tampilkan resource yang dipilih.

   4. Klik Tambahkan.

6. Untuk memverifikasi resource dan kolom yang baru dilampirkan, buka bagian Related entries di halaman detail istilah.

Mencari aset data yang ditautkan ke istilah

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/TERM_PROJECT_ID/locations/DEFINITION_LINKS_LOCATION_ID:lookupEntryLinks?entry=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&entry_link_types=projects/dataplex-types/locations/global/entryLinkTypes/definition&entry_mode=TARGET&page_size=10

Ganti kode berikut:

• TERM_PROJECT_ID: project ID dari istilah yang link definisinya Anda cari.
• TERM_PROJECT_NUMBER: nomor project dari istilah yang link definisinya Anda cari.
• DEFINITION_LINKS_LOCATION_ID: ID lokasi tempat Anda mencari link definisi.
• TERM_LOCATION_ID: ID lokasi istilah.
• TERM_GLOSSARY_ID: ID glosarium yang berisi istilah tersebut.
• TERM_ID: ID istilah.

Catatan: Kolom yang ditautkan ke istilah ditampilkan di kolom path.

Untuk mengambil halaman berikutnya, tambahkan &page_token=PAGE_TOKEN ke permintaan. Ganti PAGE_TOKEN dengan nilai token halaman yang Anda terima dari respons lookupEntryLinks sebelumnya.

Mencari istilah yang ditautkan ke aset data

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/DEFINITION_LINKS_LOCATION_ID:lookupEntryLinks?entry=projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID&entry_link_types=projects/dataplex-types/locations/global/entryLinkTypes/definition&entry_mode=SOURCE&page_size=10

Ganti kode berikut:

• PROJECT_ID: project ID aset data yang link definisinya Anda cari.
• PROJECT_NUMBER: nomor project aset data yang link definisinya Anda cari.
• DEFINITION_LINKS_LOCATION_ID: ID lokasi tempat Anda mencari link definisi.
• ENTRY_LOCATION_ID: ID lokasi aset data.
• ENTRY_GROUP_ID: ID grup entri untuk aset data.
• ENTRY_ID: ID aset data.

Catatan: Kolom yang ditautkan ke istilah dalam aset data ditampilkan di kolom path.

Untuk mengambil halaman berikutnya, tambahkan &page_token=PAGE_TOKEN ke permintaan. Ganti PAGE_TOKEN dengan nilai token halaman yang Anda terima dari respons lookupEntryLinks sebelumnya.

Menghapus istilah dari aset data

Konsol

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

   Buka Penelusuran

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

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

   • Untuk menghapus istilah dari aset, di tab Details, di bagian Glossary terms, klik istilah tersebut. Kemudian, klik .
   • Untuk menghapus istilah dari kolom, di tab Schema, 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 Glossaries.

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

   Buka Glosarium

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

   • Name: menampilkan glosarium, kategori, dan istilah yang namanya berisi teks yang Anda berikan.
   • Parent: 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.
   • Synonym: 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 istilah yang mencantumkan data steward sebagai kontak. Misalnya, contact:[e-mail] menampilkan entri yang terhubung ke istilah dengan data steward yang cocok dengan [e-mail].

REST

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

Menelusuri aset data yang ditautkan ke istilah

Konsol

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

   Buka Glosarium

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

3. Klik istilah yang cocok.

4. Di halaman Term details, lihat istilah tertaut (sinonim dan istilah terkait) serta entri tertaut (aset data) ke istilah ini.

5. Jika Anda ingin melihat detail entri di Knowledge Catalog, klik entri tersebut.

REST

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

Mengimpor glosarium dan link antara istilah dan istilah atau aset data

Untuk mengimpor glosarium dan link dari alat katalog lain atau untuk memperbarui glosarium di Knowledge Catalog, 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 masing-masing kategori, istilah, dan link tersebut 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 antar-istilah

      {"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"}]}}
      

   • Contoh format 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 Dataplex API dengan 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. Impor link antara istilah dan aset atau kolom data.

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

   Catatan: Pastikan file impor di bucket Cloud Storage berisi file untuk link dalam satu grup entri. Untuk membuat link antara istilah dan entri untuk aset data di grup entri lain, sediakan file baru di bucket Cloud Storage.

   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 2025, glosarium bisnis Knowledge Catalog akan ditagih sama seperti harga penyimpanan metadata. Lihat Harga penyimpanan metadata Knowledge Catalog.

Langkah berikutnya

• Pelajari cara menetapkan konteks data dasar.