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.
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.
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, 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.
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
—misalnyamain.tf
. Dalam tutorial ini, file ini disebut sebagaimain.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
kefalse
.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:
Anda akan melihat respons JSON seperti berikut:
{ "kind": "sql#instance", "state": "RUNNABLE", "databaseVersion": "SQLSERVER_2019_STANDARD", "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:
Anda akan melihat respons JSON seperti berikut:
{ "kind": "sql#instance", "state": "RUNNABLE", "databaseVersion": "SQLSERVER_2019_STANDARD", "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 logging, klik Lihat Log Error SQL Server.
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.