Melihat informasi instance

Halaman ini menjelaskan cara melihat informasi tentang instance Cloud SQL.

Menampilkan informasi ringkasan instance

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

Konsol

  1. 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:

  2. 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 memulihkan instance dengan memilih waktu dari masa lalu dan memulihkan instance ke statusnya pada waktu tersebut.

  3. 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 Aktif 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 Nonaktif karena koneksi IP eksternal tidak didukung

  4. Untuk melihat informasi konektivitas tentang instance, termasuk apakah alamat IP internal atau eksternal ditambahkan ke instance, jaringan resmi apa pun yang terkait dengan instance, 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 Koneksi.

    Untuk mengetahui informasi selengkapnya tentang tab ini, lihat Tentang opsi koneksi.

  5. Klik tab Networking. Informasi berikut muncul tentang instance yang telah mengaktifkan Private Service Connect:

    • Kotak centang Private IP 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 Authorized networks 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.

  1. Untuk melihat informasi ringkasan tentang instance, gunakan perintah gcloud sql instances describe:

    gcloud sql instances describe INSTANCE_NAME \
--project=PROJECT_ID

    Lakukan penggantian berikut:

    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
  2. Untuk melihat informasi yang lebih mendetail tentang instance yang mengaktifkan Private Service Connect, tambahkan parameter berikut:
    3. Setelan Parameter Catatan
    Nama DNS dnsName Nama DNS untuk instance. Sebaiknya buat data DNS dengan nama ini dan arahkan ke alamat IP endpoint Private Service Connect. Sebaiknya gunakan 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

  1. Luncurkan Cloud Shell.

  2. 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).

  1. 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

  2. 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.

  3. Tinjau dan ubah contoh parameter untuk diterapkan pada lingkungan Anda.
  4. Simpan perubahan Anda.
  5. 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

  1. Tinjau konfigurasi dan pastikan resource yang akan dibuat atau diupdate oleh Terraform sesuai yang Anda inginkan: 
    terraform plan

    Koreksi konfigurasi jika diperlukan.

  2. Terapkan konfigurasi Terraform dengan menjalankan perintah berikut dan memasukkan yes pada prompt: 
    terraform apply

    Tunggu hingga Terraform menampilkan pesan "Apply complete!".

  3. 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:

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

  1. 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:

Metode HTTP dan URL: 

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

Untuk mengirim permintaan, perluas salah satu opsi berikut:

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 telah mengaktifkan Private Service Connect.
  • 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. Sebaiknya gunakan 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:

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:

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 telah mengaktifkan Private Service Connect.
  • 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. Sebaiknya gunakan nama ini untuk terhubung ke instance.

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

Melihat endpoint tulis

Endpoint operasi tulis adalah nama layanan nama domain (DNS) global yang secara otomatis me-resolve ke alamat IP instance utama saat ini. Endpoint ini mengalihkan koneksi masuk ke instance utama baru secara otomatis jika terjadi operasi failover atau pengalihan replika. Anda dapat menggunakan endpoint tulis dalam string koneksi SQL, bukan alamat IP. Dengan menggunakan endpoint tulis, Anda dapat menghindari perlunya melakukan perubahan koneksi aplikasi saat terjadi pemadaman layanan regional.

Cloud SQL akan otomatis membuat endpoint tulis untuk instance edisi Cloud SQL Enterprise Plus jika Anda melakukan hal berikut:

  1. Aktifkan Cloud DNS API untuk project Google Cloud Anda.

  2. Buat instance.

  3. Pilih Enterprise Plus sebagai edisi Cloud SQL untuk instance Anda.
  4. Tambahkan alamat IP pribadi ke instance.
  5. Tentukan jaringan terkait untuk instance.
  6. Secara opsional, tentukan rentang IP yang dialokasikan untuk instance.

Jika Anda sudah memiliki instance edisi Cloud SQL Enterprise Plus dan ingin Cloud SQL membuat endpoint tulis secara otomatis, buat replika yang diaktifkan untuk pemulihan dari bencana lanjutan.

Untuk mengetahui informasi selengkapnya tentang cara mengambil endpoint tulis dan menggunakannya untuk terhubung ke instance, lihat Menghubungkan menggunakan endpoint tulis.

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