Masalah umum

Halaman ini berisi daftar masalah umum pada Cloud SQL untuk PostgreSQL, beserta cara menghindari atau memulihkan dari masalah ini.

Jika mengalami masalah dengan instance, pastikan Anda juga meninjau informasi dalam Mendiagnosis Masalah.

Masalah koneksi instance

  • Masa berlaku sertifikat SSL/TLS telah habis

    Jika instance Anda dikonfigurasi untuk menggunakan SSL, buka halaman Instance Cloud SQL di Konsol Google Cloud dan buka instance tersebut. Buka halaman Koneksi, pilih tab Keamanan dan pastikan sertifikat server Anda valid. Jika telah berakhir masa berlakunya, Anda harus menambahkan sertifikat baru dan melakukan rotasi ke sertifikat tersebut.

  • Versi Proxy Auth Cloud SQL

    Jika terhubung menggunakan Proxy Auth Cloud SQL, pastikan Anda menggunakan versi terbaru. Untuk mengetahui informasi selengkapnya, baca artikel Memastikan Proxy Auth Cloud SQL selalu terbaru.

  • Tidak diizinkan terhubung

    Jika Anda mencoba terhubung ke instance yang tidak ada dalam project tersebut, pesan error hanya mengatakan bahwa Anda tidak diizinkan untuk mengakses instance tersebut.

  • Tidak dapat membuat instance Cloud SQL

    Jika Anda melihat pesan error Failed to create subnetwork. Router status is temporarily unavailable. Please try again later. Help Token: [token-ID], coba buat instance Cloud SQL lagi.

  • Parameter berikut hanya berfungsi dengan pengguna default ('postgres'): gcloud sql connect --user

    Jika Anda mencoba terhubung menggunakan perintah ini dengan pengguna lain, pesan error akan bertuliskan FATAL: database 'user' does not exist. Solusinya adalah terhubung menggunakan pengguna default ('postgres'), lalu gunakan perintah psql "\c" untuk terhubung kembali sebagai pengguna yang berbeda.

  • Koneksi PostgreSQL mengalami hang saat autentikasi proxy db IAM diaktifkan.

    Saat Proxy Auth Cloud SQL dimulai menggunakan soket TCP dan dengan flag -enable_iam_login, klien PostgreSQL akan hang selama koneksi TCP. Salah satu solusinya adalah menggunakan sslmode=disable dalam string koneksi PostgreSQL. Contoh:

    psql "host=127.0.0.1 dbname=postgres user=me@google.com sslmode=disable"

    Solusi lainnya adalah memulai Proxy Auth Cloud SQL menggunakan soket Unix. Tindakan ini akan menonaktifkan enkripsi SSL PostgreSQL dan memungkinkan Proxy Auth Cloud SQL melakukan enkripsi SSL.

Masalah administratif

  • Hanya satu operasi impor atau ekspor Cloud SQL yang berjalan lama yang dapat berjalan pada satu waktu pada sebuah instance. Saat memulai operasi, pastikan Anda tidak perlu melakukan operasi lain pada instance. Selain itu, saat memulai operasi, Anda dapat membatalkan operasi tersebut.

    PostgreSQL mengimpor data dalam satu transaksi. Oleh karena itu, jika Anda membatalkan operasi impor, Cloud SQL tidak akan mempertahankan data dari impor.

    Masalah terkait impor dan ekspor data

    • Jika instance Cloud SQL Anda menggunakan PostgreSQL 17, tetapi database Anda menggunakan PostgreSQL 16 dan yang lebih lama, Anda tidak dapat menggunakan Cloud SQL untuk mengimpor database ini ke dalam instance. Untuk melakukannya, gunakan Database Migration Service.

    • Jika Anda menggunakan Database Migration Service untuk mengimpor database PostgreSQL 17 ke Cloud SQL, database tersebut akan diimpor sebagai database PostgreSQL 16.

    • Untuk PostgreSQL versi 15 dan yang lebih baru, jika database target dibuat dari template0, pengimporan data mungkin gagal dan Anda mungkin melihat pesan error permission denied for schema public. Untuk mengatasi masalah ini, berikan hak istimewa skema publik kepada pengguna cloudsqlsuperuser dengan menjalankan perintah SQL GRANT ALL ON SCHEMA public TO cloudsqlsuperuser.

    • Mengekspor banyak objek besar menyebabkan instance menjadi tidak responsif

      Jika database Anda berisi banyak objek besar (blob), mengekspor database dapat memakai banyak memori sehingga instance menjadi tidak responsif. Hal ini dapat terjadi meskipun blob kosong.

    • Cloud SQL tidak mendukung tablespace yang disesuaikan, tetapi mendukung migrasi data dari tablespace yang disesuaikan ke tablespace default, pg_default, dalam instance tujuan. Misalnya, jika Anda memiliki tablespace bernama dbspace yang terletak di /home/data, setelah migrasi, semua data di dalam dbspace akan dimigrasikan ke pg_default. Namun, Cloud SQL tidak akan membuat tablespace bernama "dbspace" di disk-nya.

    • Jika Anda mencoba mengimpor dan mengekspor data dari database yang besar (misalnya, database yang memiliki data sebesar 500 GB atau lebih), operasi impor dan ekspor mungkin memerlukan waktu yang lama untuk selesai. Selain itu, operasi lain (misalnya, operasi pencadangan) tidak dapat Anda lakukan saat impor atau ekspor berlangsung. Opsi potensial untuk meningkatkan performa proses impor dan ekspor adalah dengan memulihkan cadangan sebelumnya menggunakan gcloud atau API.

    • Cloud Storage mendukung ukuran maksimum objek tunggal hingga lima terabyte. Jika Anda memiliki database yang lebih besar dari 5 TB, operasi ekspor ke Cloud Storage akan gagal. Dalam kasus ini, Anda perlu memecah file ekspor menjadi segmen yang lebih kecil.

    Log transaksi dan pertumbuhan disk

    Log dihapus permanen sekali sehari, bukan terus-menerus. Jika jumlah hari retensi log dikonfigurasi agar sama dengan jumlah cadangan, satu hari pencatatan log mungkin hilang, bergantung pada waktu pencadangan dilakukan. Misalnya, menetapkan retensi log ke tujuh hari dan retensi cadangan ke tujuh cadangan, berarti antara enam dan tujuh hari log akan disimpan.

    Sebaiknya tetapkan jumlah cadangan ke setidaknya satu lebih banyak daripada jumlah hari retensi log untuk menjamin retensi log minimum pada hari tertentu.

    Instance dengan nama region berikut ditampilkan secara tidak benar dalam konteks tertentu, seperti berikut:

    • us-central1 ditampilkan sebagai us-central
    • europe-west1 ditampilkan sebagai europe
    • asia-east1 ditampilkan sebagai asia

    Masalah ini terjadi dalam konteks berikut:

    • Pemberitahuan di Cloud Monitoring
    • Metrics Explorer
    • Cloud Logging

    Anda dapat memitigasi masalah Pemberitahuan di Cloud Monitoring, dan untuk Metrics Explorer, dengan menggunakan Label metadata resource. Menggunakan label metadata sistem region bukan database_cloudsql label resource yang dimonitor region singkat ini.