Halaman ini diterjemahkan oleh Cloud Translation API.

Mengelola resource Cloud SQL menggunakan Katalog Universal Dataplex

MySQL | PostgreSQL | SQL Server

Halaman ini menjelaskan cara Anda dapat menelusuri dan mengelola resource Cloud SQL menggunakan Dataplex Universal Catalog.

Dataplex Universal Catalog adalah platform untuk menyimpan, mengelola, dan mengakses metadata Anda. Katalog Universal Dataplex mengambil metadata berikut dari instance, database, tabel, kolom, dan tampilan Cloud SQL secara otomatis:

Nama
Lokasi (wilayah)
Tanggal pembuatan dan tanggal terakhir diubah
Skema (untuk tabel dan tampilan)
Deskripsi

Katalog Universal Dataplex dapat menyerap metadata di tingkat instance Cloud SQL meskipun Anda tidak mengaktifkan integrasi. Namun, Dataplex Universal Catalog mengambil metadata dari resource yang termasuk dalam instance, seperti database, tabel, kolom, dan tampilannya, hanya setelah Anda mengaktifkan integrasi.

Dataplex Universal Catalog hanya mengambil metadata dari instance utama Cloud SQL, bukan dari replika baca.

Anda dapat menggunakan Dataplex Universal Catalog untuk menemukan dan memahami metadata Cloud SQL Anda. Gunakan Dataplex Universal Catalog untuk membantu aktivitas berikut:

Analisis, termasuk dependensi dan kesesuaian untuk kasus penggunaan
Manajemen perubahan
Perpindahan data (pipeline)
Evolusi skema

Dengan Katalog Universal Dataplex, Anda dapat mengelola metadata dengan melampirkan aspek ke entri metadata Cloud SQL. Setiap aspek dapat memiliki beberapa kolom metadata dan dapat didasarkan pada jenis aspek standar atau kustom.

Misalnya, Anda dapat melampirkan aspek berikut ke kolom yang berisi nomor Jaminan Sosial, yang merupakan informasi identitas pribadi (PII):

  pii:true
  pii_type:SSN

Untuk mengetahui informasi selengkapnya tentang Dataplex Universal Catalog, lihat Tentang pengelolaan katalog data 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.

Go to project selector

Make sure 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.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Aktifkan Dataplex API untuk project.

Mengaktifkan Dataplex API
Periksa izin.

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

Peran dan izin IAM yang diperlukan untuk Dataplex Universal Catalog

Cloud SQL menggunakan izin cloudsql.schemas.view untuk memberikan akses ke metadata di Dataplex Universal Catalog.

Untuk memberikan izin ini, buat peran khusus yang menyertakan izin ini, atau gunakan salah satu peran bawaan yang memiliki izin ini.

Untuk mengetahui informasi selengkapnya, lihat Peran IAM Cloud SQL bawaan.

Mengaktifkan integrasi Dataplex Universal Catalog pada instance Cloud SQL Anda

Untuk mengaktifkan integrasi Dataplex Universal Catalog di instance Cloud SQL Anda, gunakan salah satu prosedur berikut.

gcloud

Buat instance

Untuk membuat instance Cloud SQL, gunakan perintah gcloud sql instances create.

gcloud sql instances create INSTANCE_NAME \
  --database-version=DATABASE_VERSION \
  --tier=MACHINE_TYPE \
  --region=REGION_NAME \
  --enable-dataplex-integration

Lakukan penggantian berikut:

INSTANCE_NAME: nama instance
DATABASE_VERSION: versi database untuk instance (misalnya, POSTGRES_13); untuk daftar lengkap string yang tersedia, lihat SqlDatabaseVersion
MACHINE_TYPE: jenis mesin untuk instance
REGION_NAME: nama region untuk instance

Memperbarui instance

Untuk mengaktifkan integrasi untuk instance yang ada, gunakan perintah gcloud sql instances patch.

gcloud sql instances patch INSTANCE_NAME \
  --enable-dataplex-integration

Jika perlu mengaktifkan dan memperbarui semua instance Cloud SQL di project Anda, Anda dapat menjalankan skrip yang mirip dengan berikut ini:

gcloud sql instances list --format="(NAME)" \
| tail -n +2 | xargs -t -I %
gcloud sql instances patch % --enable-dataplex-integration

Contoh ini berbasis Linux.

REST v1

Buat instance

Gunakan contoh ini untuk membuat instance dengan integrasi yang diaktifkan. Untuk mengetahui daftar lengkap parameter yang tersedia untuk panggilan ini, lihat halaman instances.insert.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID atau nomor project dari project Google Cloud yang berisi instance
INSTANCE_NAME: nama instance
REGION_NAME: nama region untuk instance
DATABASE_VERSION: string enum versi database (misalnya, POSTGRES_13). Untuk daftar lengkap string yang tersedia, lihat SqlDatabaseVersion.
PASSWORD: sandi untuk pengguna root
MACHINE_TYPE: string enum jenis (tingkat) mesin, seperti: db-custom-[CPUS]-[MEMORY_MBS]
EDITION_TYPE: edisi Cloud SQL Anda

Metode HTTP dan URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

Meminta isi JSON:

{
  "name": "INSTANCE_NAME",
  "region": "REGION_NAME",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "enableDataplexIntegration": true
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan 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 yang saat ini 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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini 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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-09-25T22:19:33.735Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Memperbarui instance

Gunakan contoh ini untuk memperbarui instance yang ada. Untuk mengetahui daftar lengkap parameter yang tersedia untuk panggilan ini, lihat halaman instances.patch.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID atau nomor project dari project Google Cloud yang berisi instance
INSTANCE_NAME: nama instance

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Meminta isi JSON:

{
  "settings":
  {
    "enableDataplexIntegration": true
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Buat instance

Gunakan contoh ini untuk membuat instance dengan integrasi yang diaktifkan. Untuk mengetahui daftar lengkap parameter yang tersedia untuk panggilan ini, lihat halaman instances.insert.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID atau nomor project dari project Google Cloud yang berisi instance
INSTANCE_NAME: nama instance
REGION_NAME: nama region untuk instance
DATABASE_VERSION: string enum versi database (misalnya, POSTGRES_13). Untuk daftar lengkap string yang tersedia, lihat SqlDatabaseVersion.
PASSWORD: sandi untuk pengguna root
MACHINE_TYPE: string enum jenis (tingkat) mesin, seperti: db-custom-[CPUS]-[MEMORY_MBS]
EDITION_TYPE: edisi Cloud SQL Anda

Metode HTTP dan URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances

Meminta isi JSON:

{
  "name": "INSTANCE_NAME",
  "region": "REGION_NAME",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "enableDataplexIntegration": true
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances"

PowerShell (Windows)

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-09-25T22:19:33.735Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Memperbarui instance

Gunakan contoh ini untuk memperbarui instance yang ada. Untuk mengetahui daftar lengkap parameter yang tersedia untuk panggilan ini, lihat halaman instances.patch.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID atau nomor project dari project Google Cloud yang berisi instance
INSTANCE_NAME: nama instance

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Meminta isi JSON:

{
  "settings":
  {
    "enableDataplexIntegration": true
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Memverifikasi integrasi Dataplex Universal Catalog di instance Cloud SQL Anda

Untuk memverifikasi bahwa integrasi Dataplex Universal Catalog diaktifkan di instance Anda, gunakan salah satu prosedur berikut.

gcloud

Untuk memverifikasi bahwa integrasi Katalog Universal Dataplex diaktifkan di instance yang ada, gunakan perintah gcloud sql instances describe.

gcloud sql instances describe INSTANCE_NAME

Ganti INSTANCE_NAME dengan nama instance. Di output, cari setelan konfigurasi enableDataplexIntegration yang ditetapkan ke true.

REST v1

Sebelum menggunakan salah satu data permintaan, buatlah pengganti berikut:

PROJECT_ID: project ID
INSTANCE_ID: ID instance

Metode HTTP dan URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Jalankan perintah berikut:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Anda akan menerima respons JSON seperti berikut:

{
"settings":
  {
  "enableDataplexIntegration": true
  }
}

REST v1beta4

Sebelum menggunakan salah satu data permintaan, buatlah pengganti berikut:

PROJECT_ID: project ID
INSTANCE_ID: ID instance

Metode HTTP dan URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Jalankan perintah berikut:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
"settings":
  {
  "enableDataplexIntegration": true
  }
}

Menonaktifkan integrasi Dataplex Universal Catalog di instance Cloud SQL Anda

Untuk menonaktifkan integrasi Dataplex Universal Catalog di instance Cloud SQL Anda, gunakan salah satu prosedur berikut.

gcloud

Untuk menonaktifkan integrasi untuk instance yang ada, gunakan perintah gcloud sql instances patch.

gcloud sql instances patch INSTANCE_NAME \
  --no-enable-dataplex-integration

Jika Anda perlu menonaktifkan integrasi dan memperbarui semua instance Cloud SQL di project Anda, Anda dapat menjalankan skrip yang mirip dengan berikut ini:

gcloud sql instances list --format="(NAME)" \
| tail -n +2 | xargs -t -I %
gcloud sql instances patch % --no-enable-dataplex-integration

Contoh ini berbasis Linux.

REST v1

Gunakan contoh ini untuk menonaktifkan integrasi.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID atau nomor project dari project Google Cloud yang berisi instance
INSTANCE_NAME: nama instance

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Meminta isi JSON:

{
  "settings":
  {
    "enableDataplexIntegration": false
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Gunakan contoh ini untuk menonaktifkan integrasi.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID atau nomor project dari project Google Cloud yang berisi instance
INSTANCE_NAME: nama instance

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Meminta isi JSON:

{
  "settings":
  {
    "enableDataplexIntegration": false
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Memperkaya aset Cloud SQL dengan 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 Cloud SQL. Dengan melampirkan aspek ke aset Cloud SQL, 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 Cloud SQL, lihat Mengelola aspek dan memperkaya metadata.

Menelusuri aset Cloud SQL

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

Buka halaman Penelusuran Dataplex Universal Catalog.

Buka Penelusuran
Di Choose search platform, pilih Dataplex Catalog.
Di panel Filter, klik Sistem, lalu pilih Cloud SQL.
Opsional. Di Alias jenis, Anda dapat memfilter hasil penelusuran ke jenis aset Cloud SQL tertentu dengan memilih satu atau beberapa alias jenis berikut:
- Database
- Skema database
- Layanan
- Tabel
- Lihat
Catatan: Service adalah alias jenis untuk instance Cloud SQL.

Menggunakan kueri untuk melakukan penelusuran

Anda juga dapat menggunakan kolom penelusuran di Katalog Universal Dataplex untuk menjalankan kueri penelusuran. Untuk melihat semua aset Cloud SQL, masukkan system=Cloud_SQL.

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

system=Cloud_SQL AND type=Database

Untuk melihat semua tabel Cloud SQL, masukkan kueri berikut:

system=Cloud_SQL 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 Katalog Universal Dataplex.

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

type="projects/PROJECT_ID/locations/global/entryTypes/QUERY_STRING"

Ganti kode berikut:

PROJECT_ID: ID project Anda

QUERY_STRING: gunakan tabel berikut untuk mengidentifikasi string kueri berdasarkan mesin Cloud SQL dan jenis aset yang ingin Anda kueri

Mesin Cloud SQL	String kueri
Cloud SQL untuk MySQL	`cloudsql-mysql-database` `cloudsql-mysql-instance` `cloudsql-mysql-table` `cloudsql-mysql-view` Catatan: Skema tidak didukung untuk MySQL.
Cloud SQL untuk PostgreSQL	`cloudsql-postgresql-database` `cloudsql-postgresql-instance` `cloudsql-postgresql-table` `cloudsql-postgresql-schema` `cloudsql-postgresql-view`
Cloud SQL untuk SQL Server	`cloudsql-sqlserver-database` `cloudsql-sqlserver-instance` `cloudsql-sqlserver-table` `cloudsql-sqlserver-schema` `cloudsql-sqlserver-view`

Contoh kueri mungkin terlihat seperti berikut:

type="projects/1234567890/locations/global/entryTypes/cloudsql-postgresql-instance"

Memfilter aset Cloud SQL menurut dialek Cloud SQL

Secara default, Katalog Universal Dataplex menampilkan semua aset Cloud SQL. Untuk memfilter aset hanya untuk Cloud SQL untuk MySQL, Cloud SQL untuk PostgreSQL, atau SQL Server, lakukan langkah-langkah berikut.

Di panel Aspek, klik menu Tambahkan jenis aspek lainnya.
Pilih Akses SQL.
Klik Oke.
Klik tombol edit aspek playlist_add . Di halaman Akses SQL, lakukan hal berikut:
- Di kolom Dialek, pilih PostgreSQL untuk memfilter aset Cloud SQL untuk PostgreSQL.
Opsional. Pilih kolom Versi, lalu masukkan versi tertentu Cloud SQL untuk PostgreSQL.
Klik Terapkan. Katalog Universal Dataplex hanya menampilkan aset Cloud SQL untuk PostgreSQL.

Menelusuri menurut jenis aspek

Katalog Universal Dataplex mencakup beberapa jenis aspek bawaan yang dapat Anda gunakan untuk melakukan penelusuran.

Di panel Aspek, klik menu Tambahkan jenis aspek lainnya.
Opsional. Pilih Akses SQL untuk memfilter hasil menurut dialek Cloud SQL. Untuk mengetahui informasi selengkapnya, lihat prosedur sebelumnya, Memfilter aset Cloud SQL menurut dialek Cloud SQL.
Pilih satu atau beberapa jenis aspek berikut untuk membatasi hasil penelusuran ke jenis tersebut.
- Database Cloud SQL
- Instance Cloud SQL
- Tampilan Cloud SQL
- Skema Cloud SQL
- Tabel Cloud SQL
Klik Oke.
Di tabel hasil, klik nama aset untuk melihat metadata aset tersebut.
Opsional: Tingkatkan kualitas atau lihat aset Anda. Anda dapat melakukan salah satu tindakan berikut:
- Di Ringkasan, klik Tambahkan untuk menambahkan deskripsi teks kaya aset.
- Di Aspects, klik Add untuk melampirkan aspek ke aset.
- Misalnya, untuk melihat database anggota, klik tab Daftar Entri, lalu klik Tampilkan semua entri turunan dalam penelusuran. Jika tab Entry List tidak muncul, berarti instance tidak memiliki database.
- Di Detail entri, lihat detail lengkap aset. Klik nama entri untuk melihat entri tambahan.

Contoh alur kerja - Melihat perincian dari instance ke kolom

Dalam alur kerja contoh ini, Anda mulai dengan menelusuri instance Cloud SQL, lalu melihat database anggota, lalu melihat tabel dalam database tersebut, dan kemudian melihat kolom dalam tabel.

Buka halaman Penelusuran Dataplex Universal Catalog.

Buka Penelusuran
Untuk opsi Pilih platform penelusuran, pilih Dataplex Catalog.
Di panel Filter, pilih Sistem, lalu Cloud SQL. Atau, masukkan system=Cloud_SQL di kolom penelusuran.
Pilih nama instance.
Di halaman Detail Cloud SQL, klik tab Daftar entri, lalu klik Tampilkan semua entri turunan dalam penelusuran. Dataplex Universal Catalog menampilkan database di instance.

Catatan: Jika tidak ada tab Daftar entri, kembali ke halaman Penelusuran dan pilih instance lain.
Di halaman Detail database Cloud SQL, klik tab Daftar entri, lalu klik Lihat entri turunan dalam penelusuran. Dataplex Universal Catalog menampilkan tabel dalam database.
Pilih nama tabel, lalu di halaman Detail tabel Cloud SQL, klik Skema untuk melihat kolom tabel.
Opsional: Untuk menambahkan jenis aspek ke kolom, klik tombol Tambahkan aspek.

Alur kerja ini menunjukkan cara melihat perincian dari instance ke tabel. Anda dapat langsung membuka daftar tabel dengan memasukkan system=Cloud_SQL AND type=Table di kolom penelusuran.

Harga

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

Penggunaan resource

Katalog Universal Dataplex mengekstrak data dari instance Anda secara berkala. Proses ekstraksi memerlukan penggunaan CPU dalam jumlah tertentu. Instance dengan jenis mesin yang lebih kecil—misalnya, mesin yang memiliki inti bersama dan skema yang lebih besar (10.000 tabel atau lebih), dapat menggunakan hingga 40% CPU-nya selama proses ekstraksi.

Batasan

Bagian ini mencantumkan batasan penggunaan Cloud SQL dan Dataplex Universal Catalog.

Integrasi Dataplex Universal Catalog dengan Cloud SQL dinonaktifkan untuk instance apa pun yang membatasi akses ke resource karena pendaftaran resource di Assured Workloads.
Setelah Anda mengaktifkan Dataplex Universal Catalog di sebuah instance, diperlukan waktu antara 2 hingga 48 jam agar resource Cloud SQL Anda muncul di Dataplex Universal Catalog sebagai aset, bergantung pada ukuran mesin, versi, dan jenis mesin Cloud SQL yang Anda gunakan.

Tidak ada batasan yang diketahui dengan Cloud SQL untuk PostgreSQL dan Katalog Universal Dataplex.

Mengelola resource Cloud SQL menggunakan Katalog Universal Dataplex Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Sebelum memulai

Peran dan izin IAM yang diperlukan untuk Dataplex Universal Catalog

Mengaktifkan integrasi Dataplex Universal Catalog pada instance Cloud SQL Anda

gcloud

Buat instance

Memperbarui instance

REST v1

Buat instance

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Memperbarui instance

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

REST v1beta4

Buat instance

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Memperbarui instance

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Memverifikasi integrasi Dataplex Universal Catalog di instance Cloud SQL Anda

gcloud

REST v1

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Menonaktifkan integrasi Dataplex Universal Catalog di instance Cloud SQL Anda

gcloud

REST v1

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Memperkaya aset Cloud SQL dengan aspek

Menelusuri aset Cloud SQL

Menggunakan kueri untuk melakukan penelusuran

Memfilter aset Cloud SQL menurut dialek Cloud SQL

Menelusuri menurut jenis aspek

Contoh alur kerja - Melihat perincian dari instance ke kolom

Harga

Penggunaan resource

Batasan

Langkah berikutnya

Mengelola resource Cloud SQL menggunakan Katalog Universal Dataplex