Halaman ini menjelaskan cara mengupgrade versi utama database dengan mengupgrade instance Cloud SQL sebagai gantinya, bukan memigrasi data.
Pengantar
Penyedia software database secara berkala merilis versi utama baru yang berisi fitur, peningkatan performa, serta peningkatan keamanan yang baru. Cloud SQL menerima versi baru setelah versi baru tersebut dirilis. Setelah Cloud SQL menawarkan dukungan untuk versi utama yang baru, Anda dapat mengupgrade instance untuk menjaga database Anda terus terupdate.
Anda dapat mengupgrade versi database dari instance secara langsung atau dengan memigrasikan data. Upgrade secara langsung adalah cara yang lebih mudah untuk mengupgrade versi utama instance Anda. Anda tidak perlu memigrasikan data atau mengubah string koneksi aplikasi. Dengan upgrade secara langsung, Anda dapat mempertahankan nama, alamat IP, dan setelan lain dari instance saat ini setelah upgrade. Upgrade secara langsung tidak mengharuskan Anda memindahkan file data dan dapat diselesaikan lebih cepat. Dalam beberapa kasus, periode nonaktif lebih singkat daripada yang diperlukan untuk memigrasikan data Anda.
Operasi upgrade secara langsung Cloud SQL untuk SQL Server menggunakan utilitas siap pakai upgrade SQL Server.Merencanakan upgrade versi utama
Pilih versi utama target.
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 memeriksa versi database yang dapat Anda targetkan untuk upgrade langsung di instance, lakukan hal berikut:
- Jalankan perintah berikut.
- Di output perintah,
cari bagian yang berlabel
upgradableDatabaseVersions
. - Setiap subbagian menampilkan versi database yang tersedia untuk upgrade. Di setiap subbagian, tinjau kolom berikut.
majorVersion
: versi utama yang dapat Anda targetkan untuk upgrade di tempat.name
: string versi database yang menyertakan versi utama.displayName
: nama tampilan untuk versi database.
gcloud sql instances describe INSTANCE_NAME
Ganti INSTANCE_NAME dengan nama instance.
REST v1
Untuk memeriksa versi database target yang tersedia untuk upgrade versi utama secara langsung, gunakan metode
instances.get
Cloud SQL Admin API.Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- INSTANCE_NAME: Nama instance.
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 menerima respons JSON seperti berikut:
upgradableDatabaseVersions: { major_version: "SQLSERVER_2022_STANDARD" name: "SQLSERVER_2022_STANDARD" display_name: "SQL Server 2022 Standard" }
REST v1beta4
Untuk memeriksa versi database target yang tersedia untuk upgrade versi utama secara langsung pada instance, gunakan metode
instances.get
Cloud SQL Admin API.Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- INSTANCE_NAME: Nama instance.
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:
upgradableDatabaseVersions: { major_version: "SQLSERVER_2022_STANDARD" name: "SQLSERVER_2022_STANDARD" display_name: "SQL Server 2022 Standard" }
Untuk mengetahui daftar lengkap versi database yang didukung Cloud SQL, lihat Kebijakan versi dan versi database.
Pertimbangkan fitur yang ditawarkan di setiap versi utama database dan atasi ketidaksesuaian.
Lihat fitur yang dihentikan dan perubahan yang dapat menyebabkan gangguan di SQL Server.
Versi utama baru memperkenalkan perubahan yang tidak kompatibel yang mungkin mengharuskan Anda mengubah kode aplikasi, skema, atau setelan database. Sebelum mengupgrade instance database, tinjau kembali catatan rilis versi utama target Anda untuk menentukan inkompatibilitas yang harus Anda atasi.
Uji upgrade dengan uji coba.
Jalankan uji coba proses upgrade menyeluruh di lingkungan pengujian sebelum Anda mengupgrade database produksi. Anda dapat meng-clone instance untuk membuat salinan data identik yang akan digunakan untuk menguji proses upgrade.
Selain memvalidasi bahwa upgrade berhasil diselesaikan, jalankan pengujian untuk memastikan aplikasi berperilaku seperti yang diharapkan pada database yang telah diupgrade.
Tentukan waktu untuk mengupgrade.
Upgrade mengharuskan instance menjadi tidak tersedia selama beberapa waktu. Rencanakan untuk melakukan upgrade saat aktivitas database rendah.
Mengupgrade versi utama database secara langsung
Saat Anda memulai operasi upgrade, Cloud SQL akan memeriksa konfigurasi instance Anda terlebih dahulu untuk memastikan kompatibilitasnya dengan upgrade. Setelah memverifikasi konfigurasi Anda, Cloud SQL akan membuat instance Anda tidak tersedia, membuat cadangan pra-upgrade, melakukan upgrade, menyediakan instance dan membuat cadangan pasca-upgrade.
Konsol
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Untuk membuka halaman Ringkasan instance, klik nama instance.
- Klik Edit.
- Di bagian Info instance, klik tombol Upgrade dan konfirmasi bahwa Anda ingin membuka halaman upgrade.
- Di halaman Memilih versi database, klik daftar Versi database untuk upgrade dan pilih salah satu versi utama database yang tersedia.
- Klik Lanjutkan.
- Di kotak ID Instance, masukkan nama instance, lalu klik tombol Mulai upgrade.
Pastikan versi utama database yang telah diupgrade muncul di bawah nama instance pada halaman Ringkasan instance.
gcloud
Mulai upgrade.
Gunakan perintah
gcloud sql instances patch
dengan flag--database-version
.Sebelum menjalankan perintah, ganti variabel berikut:
- INSTANCE_NAME: nama instance
- DATABASE_VERSION: Enum untuk versi utama database, yang harus lebih baru dari versi saat ini. Tentukan versi database untuk versi utama yang tersedia sebagai target upgrade untuk instance. Anda bisa mendapatkan enum ini sebagai langkah pertama Merencanakan upgrade. Jika Anda memerlukan daftar lengkap enum versi database, lihat SqlDatabaseEnums.
gcloud sql instances patch INSTANCE_NAME \ --database-version=DATABASE_VERSION
Upgrade versi utama memerlukan waktu beberapa menit untuk diselesaikan. Anda mungkin melihat pesan yang menunjukkan bahwa operasi memerlukan waktu lebih lama dari yang diperkirakan. Anda dapat mengabaikan pesan ini atau menjalankan perintah
gcloud sql operations wait
untuk menutup pesan.Dapatkan nama operasi upgrade.
Gunakan perintah
gcloud sql operations list
dengan flag--instance
.Sebelum menjalankan perintah, ganti variabel INSTANCE_NAME dengan nama instance.
gcloud sql operations list --instance=INSTANCE_NAME
Pantau status upgrade.
Gunakan perintah
gcloud sql operations describe
.Sebelum menjalankan perintah, ganti variabel OPERATION dengan nama operasi upgrade yang diambil di langkah sebelumnya.
gcloud sql operations describe OPERATION
REST v1
Mulai upgrade secara langsung.
Gunakan permintaan PATCH dengan metode
instances:patch
.Sebelum menggunakan data permintaan apa pun, ganti variabel berikut:
- PROJECT_ID: ID project.
- INSTANCE_NAME: Nama instance.
Metode HTTP dan URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME
Meminta isi JSON:
{ "databaseVersion": DATABASE_VERSION }
Ganti DATABASE_VERSION dengan enum untuk versi utama database, yang harus lebih baru dari versi saat ini. Tentukan versi database untuk versi utama yang tersedia sebagai target upgrade untuk instance. Anda bisa mendapatkan enum ini sebagai langkah pertama Merencanakan upgrade. Jika Anda memerlukan daftar lengkap enum versi database, lihat SqlDatabaseVersion.
Dapatkan nama operasi upgrade.
Gunakan permintaan GET dengan metode
operations.list
setelah mengganti PROJECT_ID dengan ID project.Metode HTTP dan URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations
Pantau status upgrade.
Gunakan permintaan GET dengan metode
operations.get
setelah mengganti variabel berikut:- PROJECT_ID: ID project.
- OPERATION_NAME: Nama operasi upgrade yang diambil di langkah sebelumnya.
Metode HTTP dan URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operation/OPERATION_NAME
Terraform
Untuk memperbarui versi database, gunakan resource Terraform dan penyedia Terraform untuk Google Cloud, versi 4.34.0 atau yang lebih baru.
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 dengan menjalankan perintah berikut dan
memasukkan
yes
pada prompt:terraform apply
-
Hapus resource yang sebelumnya diterapkan dengan konfigurasi Terraform Anda dengan menjalankan perintah berikut dan memasukkan
yes
pada prompt:terraform destroy
Saat Anda mengajukan permintaan upgrade secara langsung, Cloud SQL akan melakukan pemeriksaan upgrade awal terlebih dahulu. Jika Cloud SQL menentukan bahwa instance Anda belum siap untuk diupgrade, permintaan upgrade Anda akan gagal dengan pesan yang menyarankan cara mengatasi masalah tersebut. Lihat juga Memecahkan masalah upgrade versi utama.
Cadangan upgrade otomatis
Saat Anda melakukan upgrade versi utama, Cloud SQL secara otomatis membuat dua pencadangan on-demand, yang disebut cadangan upgrade:
- Cadangan upgrade pertama adalah cadangan pra-upgrade, yang segera dibuat sebelum memulai upgrade. Anda dapat menggunakan cadangan ini untuk memulihkan instance database ke statusnya pada versi sebelumnya.
- Cadangan upgrade kedua adalah cadangan pasca-upgrade, yang segera dibuat setelah penulisan baru diizinkan ke instance database yang diupgrade.
Saat Anda melihat daftar
cadangan, cadangan
upgrade akan dicantumkan dengan jenis On-demand
. Cadangan upgrade diberi label agar
Anda dapat mengidentifikasinya dengan cepat.
Misalnya, jika Anda melakukan upgrade
dari SQL Server Enterprise 2017 ke SQL Server Enterprise 2019, cadangan pra-upgrade
Anda akan diberi label sebagai Pre-upgrade backup, SQLSERVER_2017_ENTERPRISE to SQLSERVER_2019_ENTERPRISE.
dan cadangan pasca-upgrade Anda diberi label sebagai
Post-upgrade backup, SQLSERVER_2019_ENTERPRISE from SQLSERVER_2017_ENTERPRISE.
Seperti pencadangan on demand lainnya, cadangan upgrade akan tetap ada hingga Anda menghapusnya atau menghapus instance.
Mengupgrade tingkat kompatibilitas database
Tingkat kompatibilitas database menentukan perilaku database dalam kaitannya dengan aplikasi yang dilayaninya. Setelan tingkat kompatibilitas database memastikan kompatibilitas mundur dengan versi SQL Server terdahulu dan berkaitan dengan perubahan Transact-SQL dan Pengoptimalan Query. Saat versi database instance SQL Server diupgrade, tingkat kompatibilitas database yang ada akan dipertahankan, sehingga aplikasi dapat terus beroperasi pada versi SQL Server yang lebih baru. Mengupgrade tingkat kompatibilitas akan membantu Anda mendapatkan manfaat dari fitur baru, peningkatan pemrosesan kueri, dan perubahan lainnya.
Setelah Anda mengupgrade versi mesin database instance, ketika aplikasi yang dilayani database sudah siap, upgrade tingkat kompatibilitas database untuk setiap database dalam instance tersebut. Jika tingkat kompatibilitas ditetapkan ke terbaru, database akan diupgrade dengan fitur terbaru dan peningkatan performa.
Untuk mengupgrade tingkat kompatibilitas database, lakukan langkah-langkah berikut:
Identifikasi tingkat kompatibilitas saat ini dari database Anda.
Misalnya, untuk SQL Server 2017, tingkat kompatibilitas default-nya adalah 140. Untuk memeriksa tingkat kompatibilitas saat ini untuk database Anda, jalankan perintah berikut di Transact-SQL, setelah mengganti
DATABASE_NAME
dengan nama database pada instance SQL Server Anda.
USE DATABASE_NAME GO SELECT compatibility_level FROM sys.databases WHERE name = 'DATABASE_NAME'
Tentukan tingkat kompatibilitas target.
Identifikasi penetapan tingkat kompatibilitas default untuk versi database Anda yang telah diupgrade guna menentukan tingkat kompatibilitas target untuk database Anda. Misalnya, untuk SQL Server 2022, tingkat kompatibilitas default-nya adalah 160. Lihat tabel yang memetakan SQL Server versi baru dengan tingkat kompatibilitas.
Nilai perbedaan antara tingkat kompatibilitas Anda saat ini dan tingkat kompatibilitas target.
Sebelum mengupgrade tingkat kompatibilitas, pelajari perbedaan perilaku sistem antara tingkat kompatibilitas Anda saat ini dan tingkat kompatibilitas target. Lihat daftar lengkap perbedaan antara tingkat kompatibilitas.
Kumpulkan dasar pengukuran data beban kerja.
Sebelum mengupgrade tingkat kompatibilitas, kumpulkan dasar pengukuran data beban kerja menggunakan SQL Server Query Store, sehingga Anda nantinya dapat mengidentifikasi dan menangani kueri yang mengalami regresi. Anda menggunakan Query Store untuk menangkap kueri dan rencana dalam siklus bisnis standar guna menetapkan dasar pengukuran performa. Untuk alur kerja terpandu, gunakan fitur Query Tuning Assistant di SQL Server Management Studio.
Upgrade tingkat kompatibilitas.
Untuk mengubah tingkat kompatibilitas database, jalankan perintah berikut di Transact-SQL, setelah mengganti
DATABASE_NAME
dengan nama database pada instance SQL Server Anda dan
TARGET_COMPATIBILITY_LEVEL
dengan tingkat kompatibilitas target.ALTER DATABASE DATABASE_NAME SET COMPATIBILITY_LEVEL = TARGET_COMPATIBILITY_LEVEL; GO
Kumpulkan data beban kerja yang diupgrade.
Kumpulkan data beban kerja yang diupgrade menggunakan Query Store untuk mendeteksi perbandingan dan regresi.
Mengatasi kueri yang mengalami regresi.
Sebagian besar perubahan Pengoptimal Kueri di tingkat kompatibilitas yang diupgrade akan meningkatkan performa. Namun, dari waktu ke waktu, kueri tertentu mungkin mengalami regresi performa. Fitur Kueri Regresi Query Store membantu Anda mengidentifikasi kueri yang telah mengalami regresi dan memungkinkan Anda memaksakan rencana kueri terakhir yang diketahui. SQL Server juga menawarkan koreksi rencana otomatis, yang dapat secara otomatis beralih ke paket baik yang terakhir diketahui jika terjadi regresi kueri.
Menyelesaikan upgrade versi utama
Setelah mengupgrade instance utama, lakukan pengujian penerimaan untuk memastikan bahwa sistem yang diupgrade berjalan seperti yang diharapkan.
Memecahkan masalah upgrade versi utama
Cloud SQL menampilkan pesan error jika Anda mencoba perintah upgrade yang tidak valid, misalnya, jika instance Anda berisi flag database tidak valid untuk versi baru.
Jika permintaan upgrade gagal, periksa sintaksis permintaan upgrade Anda. Jika permintaan memiliki struktur yang valid, coba lihat saran berikut.
Melihat log upgrade
Jika terjadi masalah dengan permintaan upgrade yang valid, Cloud SQL
akan menayangkan log error ke projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fsqlserver.err
. Setiap entri log berisi label dengan
ID instance untuk membantu Anda mengidentifikasi instance dengan error upgrade.
Cari error upgrade tersebut dan selesaikan error tersebut.
Untuk melihat log error, ikuti langkah-langkah berikut:
-
Di Konsol Google Cloud, buka halaman Instance Cloud SQL.
- Untuk membuka halaman Overview instance, klik nama instance.
Di panel Operations and logs di halaman Overview, klik link View SQL Server error logs.
Halaman Logs Explorer akan terbuka.
Lihat log sebagai berikut:
- Untuk mencantumkan semua log in error dalam sebuah project, pilih nama log dalam filter log Nama log.
Untuk informasi selengkapnya tentang filter kueri, lihat Kueri lanjutan
- Guna memfilter log error upgrade untuk satu instance, masukkan
kueri berikut di kotak Masukkan semua kolom, setelah mengganti
DATABASE_ID
dengan project ID yang diikuti dengan nama instance dalam format ini:
project_id:instance_name
.resource.type="cloudsql_database" resource.labels.database_id="DATABASE_ID" logName : "projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fsqlserver.err"
Misalnya, untuk memfilter log error upgrade berdasarkan instance bernama
shopping-db
yang berjalan di projectbuylots
, gunakan filter kueri berikut:resource.type="cloudsql_database" resource.labels.database_id="buylots:shopping-db" logName : "projects/buylots/logs/cloudsql.googleapis.com%2Fsqlserver.err"
Pulihkan ke versi utama sebelumnya
Jika sistem database yang telah diupgrade tidak berfungsi seperti yang diharapkan, Anda mungkin perlu memulihkan instance ke versi sebelumnya. Anda melakukannya dengan memulihkan cadangan pra-upgrade ke instance pemulihan Cloud SQL, yang merupakan instance baru yang menjalankan versi upgrade.
Untuk memulihkan ke versi sebelumnya, lakukan langkah-langkah berikut:
Identifikasi cadangan pra-upgrade Anda.
Lihat Cadangan upgrade otomatis.
Buat instance pemulihan.
Buat instance Cloud SQL baru menggunakan veri utama yang dijalankan Cloud SQL saat cadangan pra-upgrade dibuat. Tetapkan flag dansetelan instance yang sama dengan yang digunakan instance asli.
Pulihkan cadangan pra-upgrade Anda.
Pulihkan cadangan pra-upgrade Anda ke instance pemulihan. Mungkin memerlukan waktu beberapa menit untuk menyelesaikan proses.
Tambahkan replika baca Anda.
Jika Anda menggunakan replika baca, tambahkan satu per satu.
Hubungkan aplikasi Anda.
Setelah memulihkan sistem database Anda, perbarui aplikasi Anda dengan detail mengenai instance pemulihan dan replika bacanya. Anda dapat melanjutkan penyaluran traffic pada versi pra-upgrade database Anda.
Batasan
Bagian ini mencantumkan batasan untuk upgrade versi utama yang diterapkan.
- Anda tidak dapat melakukan upgrade versi utama di tempat pada replika eksternal.
FAQ
Pertanyaan berikut mungkin muncul saat mengupgrade versi utama database.
- Tentu saja. Instance Anda tetap tidak tersedia selama beberapa waktu saat Cloud SQL melakukan upgrade.
- Berapa lama waktu yang diperlukan untuk melakukan upgrade?
Proses upgrade satu instance biasanya memerlukan waktu kurang dari 10 menit. Jika konfigurasi instance Anda menggunakan sejumlah kecil vCPU atau memori, upgrade mungkin memerlukan waktu lebih lama.
Jika instance Anda menghosting terlalu banyak database atau tabel, atau database Anda berukuran sangat besar, upgrade mungkin memerlukan waktu berjam-jam atau bahkan waktu habis, karena waktu upgrade sesuai dengan jumlah objek dalam database Anda. Jika Anda memiliki beberapa instance yang perlu diupgrade, total waktu upgrade Anda akan meningkat secara proporsional.
- Dapatkah saya memantau setiap langkah dalam proses upgrade?
- Saat Cloud SQL mengizinkan Anda untuk memantau apakah operasi upgrade masih berlangsung, Anda tidak dapat melacak setiap langkah di setiap upgrade.
- Dapatkah saya membatalkan upgrade setelah memulainya?
- Tidak, Anda tidak dapat membatalkan upgrade setelah dimulai. Jika upgrade gagal, Cloud SQL akan otomatis memulihkan instance Anda di versi sebelumnya.
- Apa yang terjadi dengan setelan saya selama upgrade?
Saat Anda melakukan upgrade versi tama secara langsung, Cloud SQL menyimpan setelan database Anda, termasuk nama instance, alamat IP, nilai flag yang dikonfigurasi secara eksplisit, dan data pengguna. Namun, nilai default variabel sistem mungkin berubah.
Untuk mempelajari lebih lanjut, lihat Mengonfigurasi flag database. Jika flag atau nilai tertentu tidak lagi didukung dalam versi target Anda, Cloud SQL secara otomatis akan menghapus flag tersebut selama proses upgrade.
Langkah berikutnya
- Pelajari opsi untuk menghubungkan ke instance.
- Pelajari cara mengimpor dan mengekspor data.
- Pelajari lebih lanjut cara menetapkan tanda database.