Mendiagnosis masalah

Halaman ini mengandung daftar masalah paling sering ditemukan saat menggunakan instance Cloud SQL dan langkah-langkah yang dapat dilakukan untuk mengatasi masalah tersebut. Lihat juga Masalah umum, Pemecahan masalah, dan Halaman pendukung.

Melihat log

Untuk melihat informasi tentang operasi terbaru, Anda dapat melihat Log operasi instance Cloud SQL atau Log error PostgreSQL.

Masalah koneksi

Lihat halamanMen-debug masalah koneksi atau bagian Konektivitas di halaman pemecahan masalah untuk menemukan bantuan terkait masalah koneksi.

Masalah instance

Cadangan

Untuk performa terbaik bagi pencadangan, pertahankan jumlah tabel yang wajar.

Untuk masalah pencadangan lainnya, lihat bagian Cadangan pada halaman pemecahan masalah.

Mengimpor dan mengekspor

Proses impor ke Cloud SQL dan ekspor dari Cloud SQL dapat memerlukan waktu lama, bergantung pada ukuran data yang diproses. Hal ini dapat menimbulkan dampak berikut:

  • Operasi instance Cloud SQL yang sudah berjalan lama tidak dapat dihentikan.
  • Satu operasi impor atau ekspor hanya dapat dijalankan dalam satu waktu untuk setiap instance, dan impor atau ekspor yang berjalan lama akan memblokir operasi lain seperti pencadangan otomatis harian. Ekspor serverless memungkinkan untuk menjalankan operasi lain, termasuk mengedit instance, mengimpor, failover, dan berhenti memblokir cadangan otomatis harian.

Durasi waktu yang diperlukan untuk menyelesaikan setiap operasi dapat dikurangi menggunakan fungsi impor atau ekspor Cloud SQL dengan batch data lebih kecil.

Ekspor dapat dilakukan dari replika baca atau menggunakan ekspor serverless untuk meminimalisir dampak terhadap performa database dan memungkinkan operasi lain berjalan pada instance saat ekspor berlangsung.

Untuk masalah impor dan ekspor lainnya, lihat bagian Mengimpor dan mengekspor di halaman pemecahan masalah.

Kapasitas disk

Jika instance Anda mencapai jumlah penyimpanan maksimum yang diizinkan, penulisan ke database akan gagal. Jika Anda menghapus data, misalnya, dengan melepaskan tabel, ruang tersebut akan dikosongkan, tetapi hal tersebut tidak tercermin dalam Penyimpanan Terpakai yang dilaporkan dari instance. Anda dapat menjalankan perintah VACUUM FULL untuk memulihkan ruang yang tidak digunakan; perhatikan bahwa operasi tulis diblokir saat perintah vacuum sedang berjalan. Pelajari lebih lanjut.

Status ditangguhkan

Terdapat berbagai alasan mengapa Cloud SQL dapat menangguhkan instance, seperti:

  • Masalah penagihan

    Contohnya jika kartu kredit untuk akun penagihan project telah lewat dari masa berlaku, instance dapat ditangguhkan. Anda dapat memeriksa informasi penagihan untuk project dengan membuka halaman penagihan konsol Google Cloud, memilih project dan melihat informasi akun penagihan yang digunakan untuk project tersebut. Setelah Anda menyelesaikan masalah penagihan, instance akan dapat kembali dijalankan dalam waktu beberapa jam.

  • Masalah utama terkait Cloud Key Management Service

    Misalnya, jika versi kunci Cloud KMS yang digunakan untuk mengenkripsi data pengguna di instance Cloud SQL tidak ada, akses ke kunci akan dicabut, atau jika kunci dinonaktifkan atau dihapus. Untuk informasi selengkapnya, lihat Menggunakan kunci enkripsi yang dikelola pelanggan (CMEK).

  • Masalah hukum

    Sebagai contoh, pelanggaran terhadap Kebijakan Penggunaan yang Dapat Diterima Google Cloud dapat mengakibatkan instance ditangguhkan. Untuk informasi lebih lanjut, lihat "Penangguhan dan Penghapusan" pada Persyaratan Layanan Google Cloud.

  • Masalah operasional

    Contohnya apabila instance terjebak dalam loop error (error saat dimulai atau tepat setelah dimulai), Cloud SQL dapat menangguhkan instance tersebut.

Ketika instance ditangguhkan, Anda dapat terus melihat informasi instance tersebut atau menghapusnya jika masalah penagihan memicu penangguhan.

Pengguna Cloud SQL dengan paket dukungan Platinum, Gold, atau Silver dapat menghubungi tim dukungan kami secara langsung mengenai instance yang ditangguhkan. Semua pengguna dapat menggunakan panduan sebelumnya beserta dengan forum google-cloud-sql.

Performa

Ringkasan

Cloud SQL mendukung workload dengan performa intensif hingga 60.000 IOPS dan tanpa memerlukan biaya tambahan untuk I/O. IOPS dan performa throughput bergantung pada ukuran disk, jumlah instance vCPU, dan ukuran blok I/O serta faktor lainnya.

Performa instance juga bergantung pada pilihan jenis penyimpanan dan workload.

Pelajari lebih lanjut:

Memastikan jumlah nomor tabel database yang wajar

Tabel database menggunakan resource sistem. Jumlah yang besar dapat memengaruhi performa dan ketersediaan instance serta menyebabkan instance tersebut kehilangan cakupan SLA. Pelajari lebih lanjut.

Mengaktifkan kueri log

Anda dapat mencatat kueri lambat untuk Cloud SQL untuk PostgreSQL dengan menetapkan flag log_min_duration_statement Kueri yang berjalan setidaknya selama jangka waktu tertentu akan dicatat. Jika nilai ini ditentukan tanpa satuan, nilai tersebut akan dianggap sebagai milidetik. Buka Operations Logging untuk melihat log.

Tips performa umum

Pastikan bahwa instance Anda tidak dibatasi pada memori atau CPU. Untuk workload yang membutuhkan performa tinggi, pastikan instance Anda memiliki setidaknya 60 GB memori . Untuk penyisipan, update, atau penghapusan basis data yang lambat, periksa lokasi penulis dan basis data; mengirim data jarak jauh akan menimbulkan latensi.

Tingkatkan performa kueri menggunakan Query Insights.

Untuk pemilihan database yang lambat, pertimbangkan hal berikut:

  • Caching penting untuk performa pembacaan. Periksa berbagai blks_hit / (blks_hit + blks_read) rasio dari PostgreSQL Statistics Collector. Idealnya, rasionya di atas 99%. Jika tidak, pertimbangkan meningkatkan ukuran RAM instance Anda.
  • Jika workload Anda terdiri dari kueri yang membebani CPU (pengurutan, ekspresi reguler, fungsi kompleks lainnya), instance Anda mungkin akan mengalami throttle; tambahkan vCPUs.
  • Periksa lokasi pembaca dan database - latensi memengaruhi performa baca bahkan lebih dari performa tulis.
  • Selidiki peningkatan performa khusus non-Cloud SQL, seperti menambahkan pengindeksan yang sesuai, mengurangi data yang dipindai, dan menghindari tambahan perjalanan bolak-balik.

Jika Anda mengamati performa buruk saat mengeksekusi kueri, gunakan EXPLAIN untuk mengidentifikasi tempat untuk menambahkan indeks ke tabel guna meningkatkan performa kueri. Misalnya, pastikan setiap kolom yang Anda gunakan sebagai JOIN key memiliki indeks di kedua tabel.

Memecahkan masalah

Untuk mengetahui lebih lanjut terkait masalah Cloud SQL lainnya, lihat halaman pemecahan masalah.

Pesan error

Untuk pesan error API khusus, lihat halaman rujukan Pesan error.

Memecahkan masalah kunci enkripsi yang dikelola pelanggan (CMEK)

Operasi administrator Cloud SQL, seperti membuat, mengkloning, atau memperbarui, bisa saja gagal karena error Cloud KMS dan peran atau izin yang hilang. Penyebab kegagalan umum meliputi hilangnya versi kunci Cloud KMS, versi kunci Cloud KMS dinonaktifkan atau dihancurkan, izin IAM tidak memadai untuk mengakses versi kunci Cloud KMS, atau versi kunci Cloud KMS berada dalam region yang berbeda dengan instance Cloud SQL. Gunakan tabel pemecahan masalah berikut untuk mendiagnosis dan menyelesaikan masalah umum.

Tabel pemecahan masalah kunci enkripsi yang dikelola pelanggan

Untuk error ini... Masalahnya mungkin adalah... Coba langkah ini...
Akun layanan per-project, per-produk tidak ditemukan Nama akun layanan tersebut tidak tepat. Pastikan Anda membuat akun layanan untuk project pengguna yang tepat.

BUKA HALAMAN AKUN LAYANAN.

Tidak dapat memberikan akses ke akun layanan. Akun pengguna tidak memiliki izin untuk memberikan akses ke akun layanan ini. Tambahkan peran Organization Administrator ke akun pengguna atau layanan Anda.

BUKA HALAMAN AKUN IAM

Versi kunci Cloud KMS dihancurkan Versi kunci tersebut sudah dihancurkan. Jika versi kunci tersebut dihancurkan, Anda tidak dapat menggunakannya untuk mengenkripsi atau mendekripsi data.
Versi kunci Cloud KMS dinonaktifkan Versi kunci tersebut dinonaktifkan. Aktifkan kembali versi kunci Cloud KMS.

BUKA HALAMAN KUNCI KRIPTO

Izin tidak memadai untuk menggunakan kunci Cloud KMS Peran cloudkms.cryptoKeyEncrypterDecrypter hilang pada akun pengguna atau layanan yang Anda gunakan untuk menjalankan operasi pada instance Cloud SQL, atau versi kunci Cloud KMS tidak ada. Di project Google Cloud yang menghosting kunci, tambahkan peran cloudkms.cryptoKeyEncrypterDecrypter ke akun pengguna atau layanan Anda.

BUKA HALAMAN AKUN IAM


Jika peran tersebut sudah diberikan ke akun Anda, lihat Membuat kunci untuk mempelajari cara membuat versi kunci baru. Lihat catatan.
Kunci Cloud KMS tidak ditemukan. Versi kunci tersebut tidak ada. Buat versi kunci baru. Lihat Membuat kunci. Lihat catatan.
Instance Cloud SQL dan versi kunci Cloud KMS berada di region yang berbeda. Instance Cloud SQL dan versi kunci Cloud KMS harus berada dalam region yang sama. Tindakan ini tidak dapat dilakukan jika versi kunci Cloud KMS berada di region global atau multi-region. Buat versi kunci pada region yang sama di mana Anda membuat instance. Lihat Membuat kunci. Lihat catatan.
Versi kunci Cloud KMS dipulihkan, tetapi instance masih ditangguhkan Versi kunci dinonaktifkan atau tidak memberikan izin yang memadai. Aktifkan kembali versi kunci, dan berikan peran cloudkms.cryptoKeyEncrypterDecrypter kepada pengguna atau akun layanan Anda di project Google Cloud yang menghosting kunci.

Tabel pemecahan masalah enkripsi ulang

Untuk error ini... Masalahnya mungkin adalah... Coba langkah ini...
Enkripsi ulang resource CMEK gagal karena kunci Cloud KMS tidak dapat diakses. Pastikan versi kunci utama diaktifkan dan izin tersebut diberikan dengan tepat. Versi kunci dinonaktifkan atau tidak memberikan izin yang memadai.

Mengaktifkan kembali versi kunci Cloud KMS:

BUKA HALAMAN KUNCI KRIPTO

Di project Google Cloud yang menghosting kunci, pastikan peran cloudkms.cryptoKeyEncrypterDecrypter diberikan ke akun pengguna atau layanan Anda:

BUKA HALAMAN AKUN IAM
Enkripsi resource CMEK gagal karena terjadi error pada server internal Silakan coba kembali nanti Terjadi error server internal. Coba enkripsi ulang kembali. Untuk informasi lebih lanjut, lihat Mengenkripsi ulang instance atau replika masih ada dan diaktifkan oleh CMEK