Melihat informasi instance

MySQL | PostgreSQL | SQL Server

Halaman ini menjelaskan cara melihat informasi tentang instance Cloud SQL.

Menampilkan informasi ringkasan instance

Anda dapat melihat informasi ringkasan tentang instance Cloud SQL dengan menggunakan Konsol Google Cloud, gcloud CLI, atau API.

Konsol

Di konsol Google Cloud, buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL

Informasi berikut muncul tentang instance Cloud SQL yang telah mengaktifkan Private Service Connect:
- Metode koneksi internal: apakah Private Service Connect atau akses layanan pribadi digunakan untuk terhubung ke instance
- Alamat IP pribadi: Alamat IP endpoint Private Service Connect di jaringan VPC yang terhubung ke lampiran layanan instance
- Nama DNS: nama DNS instance
Untuk melihat status instance saat ini, arahkan kursor ke ikon status di samping nama instance.

Jika instance berada dalam status FAILED atau MAINTENANCE, Anda dapat membuat clone instance dengan memilih waktu dari masa lalu dan memulihkan instance ke waktu tersebut.
Untuk membuka halaman Ringkasan instance, klik nama instance.

Di kartu Hubungkan ke instance ini, informasi tambahan berikut akan muncul tentang instance Cloud SQL dengan Private Service Connect yang diaktifkan:
- Konektivitas IP pribadi: statusnya adalah Enabled karena instance harus memiliki alamat IP internal
- Project yang diizinkan: project ini mengizinkan koneksi dari endpoint Private Service Connect ke instance
- Lampiran layanan: lampiran layanan instance
- Konektivitas IP Publik: statusnya Dinonaktifkan karena koneksi IP eksternal tidak didukung
Untuk melihat informasi konektivitas tentang instance, termasuk apakah alamat IP internal atau eksternal ditambahkan ke instance, semua jaringan berizin yang terkait dengan instance tersebut, dan apakah layanan Google Cloud lainnya, seperti BigQuery, dapat mengakses data di Cloud SQL dan membuat kueri terhadap data ini melalui koneksi internal, klik tab Connections.

Untuk mengetahui informasi selengkapnya tentang tab ini, lihat Tentang opsi koneksi.
Klik tab Networking. Informasi berikut akan muncul tentang instance yang telah mengaktifkan Private Service Connect:
- Kotak centang Private IP sudah dicentang, tetapi dinonaktifkan. Instance harus memiliki alamat IP internal, dan setelan ini tidak dapat diubah.
- Project yang diizinkan untuk instance.
- Kotak centang Public IP dicentang, tetapi dinonaktifkan.
- Kolom Jaringan yang diizinkan dinonaktifkan karena instance menggunakan Private Service Connect, yang tidak mendukung fitur ini.

gcloud

Untuk mengetahui informasi tentang menginstal dan memulai gcloud CLI, lihat Menginstal gcloud CLI. Untuk mengetahui informasi tentang cara memulai Cloud Shell, lihat Menggunakan Cloud Shell.

Untuk melihat informasi ringkasan tentang suatu instance, gunakan perintah gcloud sql instances describe:
```
gcloud sql instances describe INSTANCE_NAME \
--project=PROJECT_ID
```
Lakukan penggantian berikut:
- INSTANCE_NAME: nama instance Cloud SQL. Jika instance ini telah mengaktifkan Private Service Connect, endpoint Private Service Connect di jaringan VPC dapat terhubung ke instance tersebut.
- PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance.
Berikut adalah contoh output untuk menjalankan perintah ini:
```
gcloud sql instances describe myinstance \
--project=12345

...
dnsName: mydnsname
...
pscServiceAttachmentLink: projects/myproject/regions/myregion/serviceAttachments/myserviceattachment
...
 settings:
  ...
  ipConfiguration:
  ipv4Enabled: false
  pscConfig:
    allowedConsumerProjects:
      - projects/23456
      - projects/34567
    pscEnabled: true
```
Untuk melihat informasi lebih mendetail tentang instance yang mengaktifkan Private Service Connect, tambahkan parameter berikut:

Setelan	Parameter	Notes
Nama DNS	`dnsName`	Nama DNS untuk instance. Sebaiknya buat data DNS dengan nama ini dan arahkan ke alamat IP endpoint Private Service Connect. Kami juga merekomendasikan agar Anda menggunakan nama ini untuk terhubung ke instance.
Lampiran layanan	`pscServiceAttachmentLink`	URI yang mengarah ke lampiran layanan instance. Gunakan URI ini untuk membuat endpoint Private Service Connect.
Project konsumen yang diizinkan	`allowedConsumerProjects`	Daftar project yang diizinkan untuk instance. Anda dapat membuat endpoint Private Service Connect dari jaringan VPC mana pun dalam project ini ke lampiran layanan instance.
Mengaktifkan Private Service Connect	`pscEnabled`	Apakah instance telah mengaktifkan Private Service Connect.

Terraform

Untuk membuat instance, gunakan resource Terraform.

resource "google_sql_database_instance" "postgres_pvp_instance_name" {
  name             = "postgres-pvp-instance-name"
  region           = "asia-northeast1"
  database_version = "POSTGRES_14"
  root_password    = "abcABC123!"
  settings {
    tier = "db-custom-2-7680"
    password_validation_policy {
      min_length                  = 6
      reuse_interval              = 2
      complexity                  = "COMPLEXITY_DEFAULT"
      disallow_username_substring = true
      password_change_interval    = "30s"
      enable_password_policy      = true
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

Menerapkan perubahan

Untuk menerapkan konfigurasi Terraform di project Google Cloud, selesaikan langkah-langkah di bagian berikut.

Menyiapkan Cloud Shell

Luncurkan Cloud Shell.
Tetapkan project Google Cloud default tempat Anda ingin menerapkan konfigurasi Terraform.

Anda hanya perlu menjalankan perintah ini sekali per project, dan dapat dijalankan di direktori mana pun.
```
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
```
Variabel lingkungan akan diganti jika Anda menetapkan nilai eksplisit dalam file konfigurasi Terraform.

Menyiapkan direktori

Setiap file konfigurasi Terraform harus memiliki direktorinya sendiri (juga disebut modul root).

Di Cloud Shell, buat direktori dan file baru di dalam direktori tersebut. Nama file harus memiliki ekstensi .tf—misalnya main.tf. Dalam tutorial ini, file ini disebut sebagai main.tf.
```
mkdir DIRECTORY && cd DIRECTORY && touch main.tf
```
Jika mengikuti tutorial, Anda dapat menyalin kode contoh di setiap bagian atau langkah.

Salin kode contoh ke dalam main.tf yang baru dibuat.

Atau, salin kode dari GitHub. Tindakan ini direkomendasikan jika cuplikan Terraform adalah bagian dari solusi menyeluruh.
Tinjau dan ubah contoh parameter untuk diterapkan pada lingkungan Anda.
Simpan perubahan Anda.
Lakukan inisialisasi Terraform. Anda hanya perlu melakukan ini sekali per direktori.
```
terraform init
```
Secara opsional, untuk menggunakan versi penyedia Google terbaru, sertakan opsi -upgrade:
```
terraform init -upgrade
```

Menerapkan perubahan

Tinjau konfigurasi dan pastikan resource yang akan dibuat atau diupdate oleh Terraform sesuai yang Anda inginkan:
```
terraform plan
```
Koreksi konfigurasi jika diperlukan.
Terapkan konfigurasi Terraform dengan menjalankan perintah berikut dan memasukkan yes pada prompt:
```
terraform apply
```
Tunggu hingga Terraform menampilkan pesan "Apply complete!".
Buka project Google Cloud Anda untuk melihat hasilnya. Di Konsol Google Cloud, buka resource Anda di UI untuk memastikan bahwa Terraform telah membuat atau mengupdatenya.

Menghapus perubahan

Untuk menghapus perubahan Anda, lakukan langkah-langkah berikut:

Untuk menonaktifkan perlindungan penghapusan, di file konfigurasi Terraform Anda, tetapkan argumen deletion_protection ke false.
```
deletion_protection =  "false"
```
Terapkan konfigurasi Terraform terbaru dengan menjalankan perintah berikut dan memasukkan yes pada perintah:
```
terraform apply
```

Hapus resource yang sebelumnya diterapkan dengan konfigurasi Terraform Anda dengan menjalankan perintah berikut dan memasukkan yes pada prompt:
```
terraform destroy
```

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance.
INSTANCE_NAME: nama instance Cloud SQL. Jika instance ini telah mengaktifkan Private Service Connect, endpoint Private Service Connect di jaringan VPC dapat terhubung ke instance tersebut.

Metode HTTP dan URL:

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

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

Jalankan perintah berikut:

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

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -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#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "db-custom-2-7680",
    "kind": "sql#settings",
    "availabilityType": "REGIONAL",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "pscConfig": {
        "allowedConsumerProjects": [
          "ALLOWED_PROJECTS"
        ],
        "pscEnabled": true
      },
      "ipv4Enabled": false
    },
  ...
  "createTime": "2023-06-14T18:48:34.975Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE",
  "pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID",
  "dnsName": "DNS_NAME"
}

Kolom berikut tersedia untuk instance yang telah mengaktifkan Private Service Connect:

allowedConsumerProjects: daftar project yang diizinkan untuk instance. Anda dapat membuat endpoint Private Service Connect dari jaringan VPC mana pun dalam project ini ke lampiran layanan instance.
pscEnabled: apakah instance memiliki Private Service Connect yang diaktifkan untuknya.
pscServiceAttachmentLink: URI yang mengarah ke lampiran layanan instance. Gunakan URI ini untuk membuat endpoint Private Service Connect.
dnsName: nama DNS untuk instance. Sebaiknya buat data DNS dengan nama ini dan arahkan ke alamat IP endpoint Private Service Connect. Kami juga merekomendasikan agar Anda menggunakan nama ini untuk terhubung ke instance.

Untuk melihat cara membuat permintaan REST API yang mendasarinya untuk tugas ini, lihat halaman instances:get.

REST v1beta4

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance.
INSTANCE_NAME: nama instance Cloud SQL. Jika instance ini telah mengaktifkan Private Service Connect, endpoint Private Service Connect di jaringan VPC dapat terhubung ke instance tersebut.

Metode HTTP dan URL:

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

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_NAME"

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_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "db-custom-2-7680",
    "kind": "sql#settings",
    "availabilityType": "REGIONAL",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "pscConfig": {
        "allowedConsumerProjects": [
          "ALLOWED_PROJECTS"
        ],
        "pscEnabled": true
      },
      "ipv4Enabled": false
    },
  ...
  "createTime": "2023-06-14T18:48:34.975Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE",
  "pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID",
  "dnsName": "DNS_NAME"
}

Kolom berikut tersedia untuk instance yang telah mengaktifkan Private Service Connect:

allowedConsumerProjects: daftar project yang diizinkan untuk instance. Anda dapat membuat endpoint Private Service Connect dari jaringan VPC mana pun dalam project ini ke lampiran layanan instance.
pscEnabled: apakah instance memiliki Private Service Connect yang diaktifkan untuknya.
pscServiceAttachmentLink: URI yang mengarah ke lampiran layanan instance. Gunakan URI ini untuk membuat endpoint Private Service Connect.
dnsName: nama DNS untuk instance. Sebaiknya buat data DNS dengan nama ini dan arahkan ke alamat IP endpoint Private Service Connect. Kami juga merekomendasikan agar Anda menggunakan nama ini untuk terhubung ke instance.

Untuk melihat cara membuat permintaan REST API yang mendasarinya untuk tugas ini, lihat halaman instances:get.

Anda mungkin melihat beberapa banner di bagian atas yang menyarankan tindakan yang mungkin ingin Anda lakukan.

Metrik

Bagian ini menyediakan diagram penggunaan metrik instance utama yang dapat Anda gunakan untuk memantau instance Anda. Saat bekerja dengan data metrik, ingatlah fakta berikut:

Titik data untuk metrik adalah gabungan dari semua database yang dihosting oleh instance.
Data dilaporkan dalam waktu setempat.
Diagram yang dirender tidak diperbarui secara otomatis; untuk melihat data baru, maka Anda harus memuat ulang halaman.
Ada penundaan beberapa menit antara saat data metrik dicatat dan waktu ditampilkan dalam diagram penggunaan.

Untuk mengetahui informasi selengkapnya tentang metrik yang ditampilkan dalam diagram, lihat Pemantauan instance Cloud SQL.

Untuk mengetahui daftar lengkap metrik Cloud SQL yang disediakan oleh Cloud Monitoring, lihat Daftar metrik Cloud SQL.

Untuk mengetahui informasi selengkapnya tentang cara menggunakan Cloud Monitoring dengan Google Cloud, lihat dokumentasi Cloud Monitoring.

Hubungkan ke instance ini

Di bagian Hubungkan ke instance ini, Anda dapat menemukan alamat IP, jaringan VPC, dan nama koneksi instance Anda.

Untuk membuka terminal dan terhubung ke instance, klik Hubungkan ke Cloud Shell.

Untuk membuka tutorial terkait di panel kanan, klik Hubungkan dari VM Compute Engine instance.

Untuk membuka Opsi koneksi, klik Lihat semua metode koneksi.

Untuk mengetahui informasi selengkapnya tentang cara menghubungkan ke instance, lihat Ringkasan cara menghubungkan.

Akun layanan

Bagian ini menampilkan alamat email akun layanan instance.

Untuk mengetahui informasi selengkapnya, lihat dokumentasi akun layanan IAM.

Konfigurasi

Bagian ini menunjukkan setelan konfigurasi saat ini dari instance.

Untuk mengubah setelan konfigurasi, klik Edit konfigurasi.

Untuk mengetahui informasi selengkapnya tentang mengedit konfigurasi instance, lihat mengedit instance.

Operasi dan log

Bagian ini mencantumkan operasi instance terbaru, seperti membuat cadangan.

Untuk melihat operasi terbaru, klik Lihat semua operasi.

Untuk melihat informasi log, klik Lihat Log Error PostgreSQL.

Untuk informasi lebih lanjut tentang halaman Operasi dan Logs Explorer, lihat Logging Cloud SQL.

Untuk mengetahui informasi umum tentang logging, lihat Melihat log dan Mengekspor log.

Pemeliharaan

Bagian ini menampilkan setelan dan jadwal pembaruan pemeliharaan saat ini.

Untuk mengubah preferensi, klik Edit preferensi pemeliharaan.

Untuk mengubah setelan notifikasi, klik Edit preferensi notifikasi.

Untuk mengetahui informasi selengkapnya tentang pemeliharaan di Cloud SQL, lihat Ringkasan pemeliharaan.

Langkah selanjutnya

Pelajari lebih lanjut metrik Cloud Monitoring untuk Cloud SQL.
Pelajari lebih lanjut setelan instance.
Pelajari lebih lanjut cara mengedit instance.