Mengelola resource AlloyDB menggunakan Dataplex Universal Catalog

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Anda dapat menelusuri dan mengelola resource AlloyDB untuk PostgreSQL menggunakan Katalog Universal Dataplex, yang merupakan platform untuk menyimpan, mengelola, dan mengakses metadata Anda. Anda dapat menggunakan Dataplex Universal Catalog untuk menemukan dan memahami metadata AlloyDB Anda. Gunakan Dataplex Universal Catalog untuk membantu Anda melakukan hal berikut:

• Analisis, termasuk dependensi dan kesesuaian untuk kasus penggunaan
• Manajemen perubahan
• Evolusi skema

Dataplex Universal Catalog secara otomatis mengambil metadata berikut dari AlloyDB:

Resource type	Metadata yang diambil
Cluster, database, dan instance	Nama Lokasi (wilayah)
Skema, kolom, tabel, tampilan	Nama Lokasi (wilayah) Deskripsi Skema

Catatan: Dataplex Universal Catalog merujuk pada resource di AlloyDB dan di layanan Google Cloud lain sebagai aset. Dalam dokumen ini, kami menyebut resource AlloyDB—instance, database, tabel, dan tampilan—sebagai aset AlloyDB. Kami juga menggunakan istilah aset untuk merujuk pada resource dan metadata Dataplex Universal Catalog untuk resource tersebut.

Jenis penemuan metadata

Penemuan metadata, dalam konteks Dataplex Universal Catalog, adalah proses otomatis saat Dataplex Universal Catalog memindai sumber data yang terhubung—seperti AlloyDB—untuk mengidentifikasi aset data (seperti tabel, tampilan, dan database) serta mengekstrak metadata teknisnya (seperti skema, deskripsi, dan lokasi) ke dalam katalognya.

Proses ini berjalan secara berkala untuk menjaga sinkronisasi katalog dengan sistem sumber. Untuk AlloyDB, metadata cluster dan instance ditemukan secara default, sedangkan metadata database, skema, tabel, dan tampilan hanya ditemukan jika Anda mengaktifkan integrasi di cluster.

Penelusuran kata kunci dan bahasa alami

Katalog Universal Dataplex mendukung penelusuran kata kunci dan bahasa alami.

• Penelusuran kata kunci memungkinkan Anda menemukan resource menggunakan kata kunci, filter, dan sintaksis yang ditentukan. Misalnya, Anda dapat memasukkan system=AlloyDB AND type=Database untuk melihat semua database AlloyDB.
• Penelusuran bahasa alami (Pratinjau) menggunakan AI untuk memahami kueri semantik. Fitur ini memungkinkan Anda menemukan referensi menggunakan bahasa sehari-hari, sehingga tidak memerlukan sintaksis yang rumit. Misalnya, Anda dapat memasukkan kueri seperti List all AlloyDB tables related to sales.

Untuk mengetahui informasi selengkapnya, lihat Sintaksis penelusuran untuk Dataplex Universal Catalog.

Contoh: Menemukan skema database AlloyDB

Untuk memahami proses penemuan metadata, pertimbangkan contoh cluster AlloyDB bernama user-data-cluster dengan integrasi Dataplex Universal Catalog diaktifkan. Di dalam instance utama cluster ini, Anda memiliki database bernama profiles yang berisi tabel customers (id, email, signup_date) dan tampilan active_users (id, email).

AlloyDB disinkronkan secara berkala ke Dataplex Universal Catalog, dan resource berikut tersedia:

• Cluster
• Kolom
• Database
• Instance
• Tabel
• Tampilan

Setelah penemuan selesai, Anda dapat menelusuri aset ini—customers tabel dan active_users—di halaman Dataplex Universal Catalog pada konsol Google Cloud atau menggunakan API, melihat skemanya, dan memperkaya aset tersebut dengan metadata bisnis atau operasional tambahan.

Memperkaya metadata menggunakan aspek

Jenis aspek adalah resource yang dapat digunakan kembali yang dapat Anda gunakan sebagai template untuk aspek. Jenis aspek membantu Anda menghindari duplikasi pekerjaan dan aspek yang tidak lengkap. Anda dapat menggunakan Dataplex Universal Catalog untuk membuat jenis aspek yang Anda butuhkan.

Setelah membuat jenis aspek kustom, Anda dapat melampirkan aspek ke aset AlloyDB. Dengan melampirkan aspek ke aset AlloyDB, Anda dapat melakukan hal berikut:

• Menambahkan metadata bisnis ke aset
• Menelusuri aset berdasarkan metadata bisnis dan metadata kustom lainnya

Untuk mempelajari lebih lanjut cara membuat jenis aspek dan melampirkan aspek ke AlloyDB, lihat Mengelola aspek dan memperkaya metadata.

Alur kerja penemuan metadata

Secara default, resource cluster dan instance akan di-ingest dan dapat ditemukan. Anda hanya perlu mengaktifkan integrasi Dataplex Universal Catalog untuk cluster AlloyDB jika Anda ingin menyerap dan menemukan resource database, skema, tabel, dan tampilan.

1. Untuk menemukan resource database, skema, tabel, dan tampilan AlloyDB, Anda harus mengaktifkan integrasi Katalog Universal Dataplex untuk cluster AlloyDB menggunakan AlloyDB API saat membuat cluster baru atau saat memperbarui cluster yang ada. Untuk mengetahui informasi selengkapnya, lihat Membuat cluster dan instance utamanya.

2. Telusuri aset AlloyDB Anda menggunakan halaman penelusuran Dataplex Universal Catalog di konsol Google Cloud . Untuk mengetahui informasi selengkapnya, lihat bagian Menelusuri resource di Dataplex Universal Catalog.

3. Untuk menambahkan lebih banyak konteks ke aset AlloyDB, Anda dapat melampirkan aspek ke aset. Aspek adalah entri metadata kustom yang membantu tata kelola dan analisis data. Misalnya, Anda dapat menggunakan aspek untuk memberi label pada kolom yang berisi informasi identitas pribadi (PII). Untuk mengetahui informasi selengkapnya, lihat Mengelola aspek dan memperkaya metadata.

4. Anda kini dapat menjelajahi resource AlloyDB mengikuti hierarki ini: Cluster > Database > Skema > Tabel atau Tampilan > Kolom. Bagian ini memberikan tampilan mendetail tentang lanskap data Anda. Untuk mengetahui informasi selengkapnya, lihat Menelusuri resource di Dataplex Universal Catalog.

Sebelum memulai

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Aktifkan Dataplex API untuk project.

   Mengaktifkan Dataplex API

2. Periksa izin.

   Anda memerlukan peran dan izin Identity and Access Management (IAM) tertentu untuk menelusuri dan melampirkan entri ke aset AlloyDB. Untuk mengetahui detailnya, lihat Peran dan izin IAM yang diperlukan untuk Dataplex Universal Catalog.

Peran IAM yang diperlukan

Bagian ini menjelaskan peran dan izin yang diperlukan untuk menelusuri resource dan untuk mengakses hasil penelusuran.

Peran yang diperlukan untuk mengakses hasil penelusuran

Untuk menelusuri dan melihat metadata AlloyDB di Dataplex Universal Catalog, akun utama harus memiliki izin untuk melihat resource AlloyDB, termasuk izin dataplex.projects.search.

Untuk memberikan izin ini kepada akun utama—seperti pengguna, grup, atau akun layanan—tetapkan peran IAM AlloyDB Viewer (roles/alloydb.viewer) kepada mereka di project yang berisi resource AlloyDB.

Operasi Dataplex Universal Catalog	Resource AlloyDB	Peran atau izin yang diperlukan
Menelusuri resource AlloyDB	Cluster	alloydb.clusters.get
	Kolom	alloydb.databases.get
	Instance	alloydb.instances.get
	Database	alloydb.databases.get
	Tabel	alloydb.databases.get
	Tampilan	alloydb.databases.get

Perhatian: Jika Anda memberikan peran roles/alloydb.viewer di level project, prinsipal dengan peran ini dapat melihat metadata untuk semua instance AlloyDB dalam project.

Jika tidak ingin menggunakan peran AlloyDB Viewer yang telah ditetapkan, Anda dapat menetapkan peran kustom yang mencakup izin alloydb.clusters.get, alloydb.instances.get, dan alloydb.databases.get.

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses. Untuk mengetahui informasi selengkapnya tentang peran IAM AlloyDB, lihat Peran dan izin IAM untuk AlloyDB.

Peran yang diperlukan untuk menelusuri entri

Untuk menelusuri entri, Anda memerlukan setidaknya salah satu peran IAM berikut di project yang digunakan untuk penelusuran:

• Admin Katalog Dataplex (roles/dataplex.catalogAdmin)
• Dataplex Catalog Editor (roles/dataplex.catalogEditor)
• Dataplex Catalog Viewer (roles/dataplex.catalogViewer)

Izin pada hasil penelusuran diperiksa secara terpisah dari project yang dipilih. Untuk mengetahui informasi selengkapnya, lihat bagian Menelusuri aset data dengan Dataplex Universal Catalog.

Aktifkan integrasi Dataplex Universal Catalog di cluster AlloyDB Anda

Secara default, resource cluster dan instance akan di-ingest dan dapat ditemukan. Anda hanya perlu mengaktifkan integrasi Dataplex Universal Catalog untuk cluster AlloyDB jika Anda ingin menyerap dan menemukan resource database, skema, tabel, dan tampilan.

Untuk menyerap dan membuat resource database, skema, tabel, dan tampilan Anda dapat ditemukan, buat atau perbarui cluster menggunakan AlloyDB API. Mengaktifkan integrasi ini memungkinkan sinkronisasi metadata bidang data database, skema, tabel, dan resource tampilan.

Untuk berintegrasi dengan Dataplex Universal Catalog, Anda menggunakan flag dataplexConfig tingkat cluster. Untuk melihat data cluster sekunder, Anda harus mengaktifkan tanda ini secara terpisah. Untuk mengaktifkan ekspor metadata AlloyDB—seperti database, skema, dan tabel—ke bucket Cloud Storage, tetapkan enabled ke true. Data ini kemudian tersedia untuk digunakan oleh Dataplex Universal Catalog. Fitur ini hanya berlaku untuk instance utama.

Catatan: Metadata tingkat resource, seperti metadata cluster dan instance, selalu diaktifkan dan tidak dapat dinonaktifkan.

Mengaktifkan integrasi Dataplex Universal Catalog saat Anda membuat cluster

Untuk membuat cluster AlloyDB dengan integrasi Dataplex Universal Catalog diaktifkan, gunakan metode POST dan URL berikut. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat Metode: projects.locations.clusters.create. Untuk mengetahui informasi tentang setelan cluster, lihat Melihat setelan cluster dan instance.

Jangan menyertakan informasi sensitif atau informasi identitas pribadi di ID cluster Anda karena dapat terlihat secara eksternal. Anda tidak perlu menyertakan ID project dalam nama cluster. Hal ini dilakukan secara otomatis jika sesuai, misalnya, di file log.

Catatan: Penambahan label ke resource AlloyDB hanya didukung dengan Terraform dan REST API. Anda tidak dapat menggunakan konsol Google Cloud atau Google Cloud CLI untuk mengelola label.

Untuk mengirim permintaan, simpan isi permintaan dalam file bernama cluster_request.json:

{
  "databaseVersion": "DATABASE_VERSION",
  "initialUser": {
    "user": "INITIAL_USERNAME",
    "password": "INITIAL_USER_PASSWORD"
  },
  "labels": {
    "test": "alloydb-cluster-full"
  },
  "dataplexConfig" : {
    "enabled" : true
  }
}

Lakukan penggantian berikut:

• DATABASE_VERSION: string enum versi database—misalnya, POSTGRES_16.
• INITIAL_USERNAME: nama pengguna yang Anda gunakan untuk pengguna postgres default.
• INITIAL_USER_PASSWORD: sandi yang Anda gunakan untuk pengguna postgres default.

Gunakan metode HTTP dan URL berikut:

POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID

Lakukan penggantian berikut:

• PROJECT_ID: ID atau nomor project dari Google Cloud project yang berisi cluster.
• LOCATION_ID: ID region cluster.
• CLUSTER_ID: ID cluster yang Anda buat. ID cluster harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.

Untuk mengirim permintaan Anda, gunakan salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Perintah berikut mengasumsikan bahwa Anda telah login ke Google Cloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json dan jalankan perintah berikut:

    curl -X POST \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
        "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID"
      

PowerShell (Windows)

Perintah berikut mengasumsikan bahwa Anda telah login ke Google Cloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID"| Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan berikut ini:

Respons

{
  "kind": "alloydb#operation",
  "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2024-09-25T22:19:33.735Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Mengaktifkan integrasi Dataplex Universal Catalog untuk cluster AlloyDB Anda

Untuk memperbarui kolom tertentu dari cluster yang ada, gunakan metode PATCH di projects.locations.clusters resource.

Gunakan metode HTTP dan URL berikut:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID

Lakukan penggantian berikut:

• PROJECT_ID: ID atau nomor project dari Google Cloud project yang berisi cluster.
• CLUSTER_ID: nama cluster.

Meminta isi JSON:

{
  "dataplexConfig": {
    "enabled": true
  }
}

Untuk mengirim permintaan Anda, gunakan salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Perintah berikut mengasumsikan bahwa Anda telah login ke Google Cloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json dan jalankan perintah berikut:

    curl -X PATCH \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
        "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"
      

PowerShell (Windows)

Perintah berikut mengasumsikan bahwa Anda telah login ke Google Cloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan berikut ini:

Respons

{
  "kind": "alloydb#operation",
  "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2024-09-25T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Memverifikasi integrasi Dataplex Universal Catalog di cluster AlloyDB Anda

Untuk memverifikasi bahwa integrasi Dataplex Universal Catalog diaktifkan di cluster yang ada, gunakan metode GET.

Gunakan metode HTTP dan URL berikut:

GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID

Lakukan penggantian berikut:

• PROJECT_ID: ID atau nomor project dari Google Cloud project yang berisi cluster.
• CLUSTER_ID: ID cluster.

Untuk mengirim permintaan Anda, gunakan salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Perintah berikut mengasumsikan bahwa Anda telah login ke Google Cloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json dan jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"
      

PowerShell (Windows)

Perintah berikut mengasumsikan bahwa Anda telah login ke Google Cloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

Anda akan menerima respons JSON untuk seluruh proto Cluster. Cari pesan dataplexConfig di dalam proto:

{
"dataplexConfig":
  {
  "enabled": true
  }
}

Menonaktifkan integrasi Dataplex Universal Catalog di cluster AlloyDB

Gunakan contoh berikut untuk menonaktifkan integrasi. Jika Anda menonaktifkan fitur ini, hanya metadata cluster dan instance yang tersedia.

Gunakan metode HTTP dan URL berikut:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID

Lakukan penggantian berikut:

• PROJECT_ID: ID atau nomor project dari Google Cloud project yang berisi cluster.
• CLUSTER_ID: ID cluster.

Meminta isi JSON:

{
  "dataplexConfig": {
    "enabled": false
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Perintah berikut mengasumsikan bahwa Anda telah login ke Google Cloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json dan jalankan perintah berikut:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"
      

PowerShell (Windows)

Perintah berikut mengasumsikan bahwa Anda telah login ke Google Cloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan berikut ini:

Respons

{
  "kind": "alloydb#operation",
  "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Memperkaya aset AlloyDB dengan aspek

Jenis aspek adalah resource yang dapat digunakan kembali dan dapat Anda gunakan sebagai template untuk aspek. Jenis aspek membantu Anda menghindari duplikasi pekerjaan dan aspek yang tidak lengkap. Anda dapat menggunakan Dataplex Universal Catalog untuk membuat jenis aspek yang Anda butuhkan.

Setelah membuat jenis aspek kustom, Anda dapat melampirkan aspek ke aset AlloyDB. Dengan melampirkan aspek ke aset AlloyDB, Anda dapat melakukan hal berikut:

• Menambahkan metadata bisnis ke aset
• Menelusuri aset berdasarkan metadata bisnis dan metadata kustom lainnya

Untuk mempelajari lebih lanjut cara membuat jenis aspek dan melampirkan aspek ke AlloyDB, lihat Mengelola aspek dan memperkaya metadata.

Menelusuri aset AlloyDB

Gunakan halaman penelusuran Dataplex Universal Catalog di Google Cloud konsol untuk menelusuri aset AlloyDB.

1. Buka halaman Search Dataplex Universal Catalog.

   Buka Penelusuran

2. Di Choose search platform, pilih Dataplex Universal Catalog.

3. Di panel Filter, klik Sistem, lalu pilih AlloyDB.

4. Opsional. Di Type aliases, Anda dapat memfilter hasil penelusuran ke jenis aset AlloyDB tertentu dengan memilih satu atau beberapa alias jenis berikut:

   • Database
   • Skema database
   • Cluster
   • Instance
   • Layanan
   • Tabel
   • Lihat
   Catatan: Service adalah alias jenis untuk instance AlloyDB.

Menggunakan kueri untuk melakukan penelusuran kata kunci

Anda dapat menggunakan kolom penelusuran di Dataplex Universal Catalog untuk melakukan kueri penelusuran kata kunci. Misalnya, Anda dapat memasukkan system=AlloyDB AND type=Database untuk melihat semua database AlloyDB.

Untuk mengetahui informasi selengkapnya, lihat Sintaksis penelusuran untuk Dataplex Universal Catalog.

Untuk melihat semua aset AlloyDB, masukkan system=AlloyDB.

Kemudian, Anda dapat memasukkan kata kunci tertentu. Misalnya, untuk melihat semua database AlloyDB:

system=AlloyDB AND type=Database

Untuk melihat semua tabel AlloyDB, masukkan kueri berikut:

system=AlloyDB AND type=Table

Anda juga dapat menggunakan tanda kurung dan operator logika AND dan OR untuk ekspresi yang kompleks. Untuk mempelajari lebih lanjut ekspresi yang dapat Anda gunakan di kolom penelusuran, lihat Sintaksis penelusuran untuk Dataplex Universal Catalog.

Anda dapat langsung memasukkan kueri penelusuran untuk aset AlloyDB tertentu ke dalam kolom penelusuran. Format string kueri adalah sebagai berikut:

type="projects/dataplex-types/locations/global/entryTypes/QUERY_STRING"

Ganti kode berikut:

• QUERY_STRING: gunakan daftar berikut untuk mengidentifikasi string kueri berdasarkan jenis aset AlloyDB yang ingin Anda kueri:

  • alloydb-database
  • alloydb-cluster
  • alloydb-instance
  • alloydb-table
  • alloydb-schema
  • alloydb-view

Contoh kueri mungkin terlihat seperti berikut:

type="projects/1234567890/locations/global/entryTypes/alloydb-cluster"

Menelusuri menurut jenis aspek

Dataplex Universal Catalog menyertakan beberapa jenis aspek bawaan yang dapat Anda gunakan untuk melakukan penelusuran.

Untuk menelusuri menurut jenis aspek, ikuti langkah-langkah berikut:

1. Di panel Aspek, klik menu Tambahkan jenis aspek lainnya.
2. Opsional. Pilih Akses AlloyDB untuk memfilter hasil menurut dialek AlloyDB.
3. Pilih satu atau beberapa jenis aspek berikut untuk membatasi hasil penelusuran ke jenis tersebut.
   • Database AlloyDB
   • Cluster AlloyDB
   • Instance AlloyDB
   • Tampilan AlloyDB
   • Skema AlloyDB
   • Tabel AlloyDB
4. Klik Oke.
5. Di tabel hasil, klik nama aset untuk melihat metadata aset tersebut.
6. Opsional: Tingkatkan atau lihat aset Anda. Anda dapat melakukan salah satu tindakan berikut:
   • Untuk menambahkan deskripsi teks kaya aset, di Ringkasan, klik Tambahkan .
   • Untuk melampirkan aspek ke aset, di Aspects, klik Add .
   • Untuk melihat database anggota untuk instance, klik tab Daftar Entri, lalu klik Tampilkan semua entri turunan dalam penelusuran. Jika tab Daftar Entri tidak muncul, berarti cluster tidak memiliki database.
   • Di Detail entri, lihat detail lengkap aset. Klik nama entri untuk melihat entri tambahan.

Penelusuran Bahasa Alami di AlloyDB

Penelusuran natural language (Pratinjau) menggunakan AI untuk memahami kueri semantik. Fitur ini memungkinkan Anda menemukan resource menggunakan bahasa sehari-hari, sehingga tidak memerlukan sintaks yang rumit. Misalnya, Anda dapat memasukkan kueri seperti List all AlloyDB tables related to sales.

Untuk mengetahui informasi selengkapnya, lihat Sintaksis penelusuran untuk Dataplex Universal Catalog.

Penelusuran sintaksis di AlloyDB

Penelusuran kata kunci memungkinkan Anda menemukan resource menggunakan kata kunci, filter, dan sintaksis yang ditentukan. Misalnya, Anda dapat memasukkan system=AlloyDB AND type=Database untuk melihat semua database AlloyDB.

Untuk mengetahui informasi selengkapnya, lihat Sintaksis penelusuran untuk Dataplex Universal Catalog.

Contoh alur kerja - Melihat perincian dari cluster ke kolom

Untuk melihat perincian dari cluster ke kolom, ikuti langkah-langkah berikut:

1. Buka halaman Search Dataplex Universal Catalog.

   Buka Penelusuran

2. Untuk opsi Choose search platform, pilih Dataplex Universal Catalog.

3. Di panel Filter, pilih Sistem, lalu AlloyDB. Atau, masukkan system=AlloyDB di kolom penelusuran.

4. Pilih nama cluster.

5. Di halaman AlloyDB details, klik tab Entry list, lalu klik Show all children entries in search. Dataplex Universal Catalog menampilkan database dalam cluster.

   Catatan: Jika tidak ada tab Daftar entri, kembali ke halaman Penelusuran dan pilih cluster lain.

6. Di halaman AlloyDB database details, klik tab Entry list, lalu klik View child entries in search. Dataplex Universal Catalog menampilkan tabel dalam cluster.

7. Pilih nama tabel, lalu di halaman AlloyDB table details, klik Schema untuk melihat kolom tabel.

8. Opsional: Untuk menambahkan jenis aspek ke kolom, klik tombol Tambahkan aspek.

Harga

Tidak ada biaya untuk menyimpan metadata teknis AlloyDB di Dataplex Universal Catalog. Harga Katalog Universal Dataplex standar berlaku untuk panggilan API dan penambahan metadata bisnis. Untuk mengetahui informasi selengkapnya, lihat halaman harga Dataplex Universal Catalog.

Penggunaan resource

Dataplex Universal Catalog secara berkala mengekstrak data dari cluster Anda. Proses ekstraksi memerlukan penggunaan CPU dalam jumlah tertentu. Kluster dengan jenis mesin yang lebih kecil—misalnya, mesin yang berbagi skema yang lebih besar (10.000 tabel atau lebih)—dapat menggunakan sedikit CPU selama proses ekstraksi.

Batasan

• Maksimum satu juta tabel per database diizinkan.
• Perubahan pada database Anda dapat memerlukan waktu hingga 48 jam untuk ditampilkan di Dataplex Universal Catalog.
• Proses ekstraksi biasanya memerlukan waktu beberapa menit, tetapi waktu hingga selesai bergantung pada ukuran CPU dan jumlah tabel.
• Jika instance tidak ada atau tidak berjalan, penghapusan metadata dapat memerlukan waktu 7 hari.

Langkah berikutnya

• Tentang pengelolaan katalog data di Dataplex Universal Catalog
• Peran Identity and Access Management Katalog Universal Dataplex