Halaman ini menjelaskan cara membuat, mencantumkan, mengedit, dan menghapus instance Spanner.
Membuat instance
Anda dapat membuat instance dengan Konsol Google Cloud, Google Cloud CLI, atau library klien. Anda juga dapat membuat instance menggunakan konfigurasi instance kustom dengan menambahkan replika hanya baca opsional.
Konsol
Buka halaman Create an instance di Konsol Google Cloud.
Masukkan Instance name untuk ditampilkan di Konsol Google Cloud. Nama instance harus unik dalam project Google Cloud Anda.
Masukkan ID Instance untuk mengidentifikasi instance Anda secara permanen. ID instance juga harus unik dalam project Google Cloud Anda. Anda tidak dapat mengubah ID instance nanti.
Di bagian Choose a configuration, klik Regional atau Multi-region. Atau, jika Anda ingin membandingkan spesifikasi antara dua wilayah, klik Bandingkan konfigurasi wilayah.
Pilih konfigurasi dari menu drop-down.
Opsional: Menambahkan replika hanya baca untuk menskalakan pembacaan dan mendukung pembacaan yang sudah tidak berlaku dengan latensi rendah. Saat Anda membuat dan menambahkan replika hanya baca ke konfigurasi instance menggunakan Google Cloud Console, konfigurasi instance kustom akan dibuat secara otomatis. Untuk menambahkan replika hanya baca, lakukan hal berikut:
Luaskan Mengonfigurasi replika hanya baca.
Klik Tambahkan replika hanya baca.
Pilih wilayah dan nomor.
Di bagian Configure compute capacity, pada Select unit, klik salah satu opsi berikut:
- Unit pemrosesan untuk instance kecil.
- Node untuk instance besar. Node adalah 1.000 unit pemrosesan.
Untuk informasi selengkapnya, lihat Kapasitas komputasi, node, dan unit pemrosesan.
Di bagian Pilih mode penskalaan, klik salah satu opsi berikut:
Alokasi manual jika Anda ingin menetapkan kapasitas komputasi secara manual untuk resource dan biaya komputasi tetap.
- Jumlah menunjukkan jumlah unit pemrosesan atau node yang akan digunakan untuk instance ini.
Penskalaan otomatis (Pratinjau), untuk memungkinkan Spanner menambahkan dan menghapus kapasitas komputasi secara otomatis. Untuk informasi selengkapnya tentang penskalaan otomatis terkelola, lihat Penskalaan otomatis terkelola untuk Spanner. Konfigurasikan opsi penskala otomatis terkelola berikut:
- Minimum menunjukkan batas minimum skala untuk memperkecil skala, bergantung pada unit pengukuran yang Anda pilih untuk kapasitas Compute. Untuk informasi selengkapnya, lihat Menentukan batas minimum.
- Maksimum menunjukkan batas maksimum peningkatan skala, bergantung pada unit pengukuran yang Anda pilih untuk kapasitas Compute. Untuk informasi selengkapnya, lihat Menentukan batas maksimum.
- Target penggunaan CPU prioritas tinggi menunjukkan persentase target CPU prioritas tinggi yang akan digunakan. Untuk mengetahui informasi selengkapnya, lihat Menentukan target penggunaan CPU.
- Storage utilization target menunjukkan persentase target penyimpanan yang akan digunakan. Untuk informasi selengkapnya, lihat Menentukan Target Penggunaan Penyimpanan.
Klik Create untuk membuat instance.
gcloud
Gunakan perintah gcloud spanner instances create
untuk membuat instance. Tentukan kapasitas komputasi sebagai jumlah node atau unit pemrosesan yang Anda inginkan pada instance.
gcloud spanner instances create INSTANCE-ID \ --config=INSTANCE-CONFIG \ --description=INSTANCE-DESCRIPTION \ --nodes=NODE-COUNT
atau
gcloud spanner instances create INSTANCE-ID \ --config=INSTANCE-CONFIG \ --description=INSTANCE-DESCRIPTION \ --processing-units=PROCESSING-UNIT-COUNT
Ganti kode berikut:
- INSTANCE-ID: ID permanen yang unik dalam project Google Cloud Anda. Anda tidak dapat mengubah ID instance nanti.
- INSTANCE-CONFIG: ID permanen konfigurasi instance Anda, yang menentukan lokasi geografis instance dan memengaruhi cara data direplikasi. Untuk konfigurasi instance kustom, instance
diawali dengan
custom-
. Untuk mengetahui informasi selengkapnya, lihat konfigurasi instance. - INSTANCE-DESCRIPTION: nama yang akan ditampilkan untuk instance di Konsol Google Cloud. Nama instance harus unik dalam project Google Cloud Anda.
NODE-COUNT: kapasitas komputasi instance, yang dinyatakan sebagai jumlah node. Setiap node sama dengan 1.000 unit pemrosesan.
PROCESSING-UNIT-COUNT: kapasitas komputasi instance, dinyatakan sebagai jumlah unit pemrosesan. Masukkan jumlah hingga 1.000 dalam kelipatan 100 (100, 200, 300, dan seterusnya) dan masukkan jumlah yang lebih besar dalam kelipatan 1000 (1000, 2000, 3000, dan seterusnya). Catatan: Jangan gunakan parameter ini jika Anda membuat instance yang ingin Anda aktifkan dengan penskalaan otomatis yang dikelola nanti.
Tambahkan penskalaan otomatis terkelola (Pratinjau)
Anda juga dapat mengonfigurasi instance baru untuk menggunakan penskalaan otomatis terkelola dengan
perintah
gcloud beta spanner instances create
. Untuk informasi selengkapnya, lihat
Penskalaan otomatis terkelola untuk Spanner.
Gunakan perintah berikut untuk membuat instance dengan penghitung skala otomatis terkelola.
gcloud beta spanner instances create INSTANCE-ID \ --config=INSTANCE-CONFIG \ --description=INSTANCE-DESCRIPTION \ --autoscaling-min-processing-units=MINIMUM_PROCESSING_UNITS \ --autoscaling-max-processing-units=MAXIMUM_PROCESSING_UNITS \ --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \ --autoscaling-storage-target=STORAGE_PERCENTAGE
atau
gcloud beta spanner instances create INSTANCE-ID \ --config=INSTANCE-CONFIG \ --description=INSTANCE-DESCRIPTION \ --autoscaling-min-nodes=MINIMUM_NODES \ --autoscaling-max-nodes=MAXIMUM_NODES \ --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \ --autoscaling-storage-target=STORAGE_PERCENTAGE
Ganti kode berikut:
- INSTANCE-ID: ID permanen yang unik dalam project Google Cloud Anda. Anda tidak dapat mengubah ID instance nanti.
- INSTANCE-CONFIG: ID permanen konfigurasi instance Anda, yang menentukan lokasi geografis instance dan memengaruhi cara data direplikasi. Untuk konfigurasi instance kustom, instance
diawali dengan
custom-
. Untuk mengetahui informasi selengkapnya, lihat konfigurasi instance. - INSTANCE-DESCRIPTION: nama yang akan ditampilkan untuk instance di Konsol Google Cloud. Nama instance harus unik dalam project Google Cloud Anda.
- MINIMUM_PROCESSING_UNITS, MINIMUM_NODES: jumlah minimum unit pemrosesan atau node saat memperkecil skala. Untuk mengetahui informasi selengkapnya, lihat Menentukan batas minimum.
- MAXIMUM_PROCESSING_UNITS, MAXIMUM_NODES: jumlah maksimum unit pemrosesan atau node saat meningkatkan skala. Untuk mengetahui informasi selengkapnya, lihat Menentukan batas maksimum.
- CPU_PERCENTAGE: persentase target CPU prioritas tinggi yang akan digunakan, dari 10 hingga 90%. Jika Anda mengoptimalkan biaya, gunakan persentase yang lebih tinggi. Untuk mengetahui informasi selengkapnya, lihat Menentukan target penggunaan CPU.
- STORAGE_PERCENTAGE: persentase target penyimpanan yang akan digunakan, dari 10 hingga 99%. Untuk mengetahui informasi selengkapnya, lihat Menentukan target penggunaan penyimpanan.
Contoh penggunaan konfigurasi kustom
Untuk membuat instance test-instance
dalam konfigurasi instance regional dasar us-central1
, jalankan:
gcloud spanner instances create test-instance --config=regional-us-central1 \
--description="Test Instance" --nodes=1
Untuk membuat instance custom-eur6-instance
dalam konfigurasi instance multi-region kustom custom-eur6
, buat konfigurasi instance kustom terlebih dahulu.
Kemudian, jalankan:
gcloud spanner instances create custom-eur6-instance --config=custom-eur6 \
--description="Instance with custom read-only" --nodes=1
Anda akan melihat pesan yang mirip dengan contoh berikut setelah menjalankan salah satu perintah di atas:
Creating instance...done.
C++
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk mengautentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
C#
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk mengautentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk mengautentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Membuat instance dengan penskalaan otomatis yang dikelola menggunakan Go (Pratinjau)
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk mengautentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Membuat instance dengan penskalaan otomatis terkelola menggunakan Java (Pratinjau)
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk mengautentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk mengautentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk mengautentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk mengautentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Mencantumkan instance
Anda dapat menampilkan daftar instance Spanner.
Konsol
Buka halaman Spanner Instances di konsol Google Cloud.
Konsol Google Cloud menampilkan daftar instance Spanner Anda, beserta ID tiap instance, nama tampilan, konfigurasi, dan kapasitas komputasi yang dinyatakan dalam unit pemrosesan dan dalam node.
gcloud
Gunakan perintah
gcloud spanner instances list
:
gcloud spanner instances list
Gcloud CLI mencetak daftar instance Spanner Anda, beserta ID, nama tampilan, konfigurasi, dan kapasitas komputasi dari setiap instance.
Mengedit instance
Bagian berikut menjelaskan cara mengubah nama tampilan instance dan kapasitas komputasi. Anda tidak dapat mengubah ID instance atau konfigurasi instance.
Mengubah nama tampilan
Konsol
Buka halaman Spanner Instances di konsol Google Cloud.
Klik nama instance yang ingin diganti namanya.
Klik Edit instance.
Masukkan nama instance baru. Nama ini harus unik dalam project Google Cloud.
Klik Save.
gcloud
Gunakan perintah
gcloud spanner instances update
:
gcloud spanner instances update INSTANCE-ID --description=INSTANCE-NAME
Ganti kode berikut:
- INSTANCE-ID: ID permanen untuk instance.
- INSTANCE-NAME: nama yang akan ditampilkan untuk instance di Konsol Google Cloud. Nama instance harus unik dalam project Google Cloud Anda.
Mengubah kapasitas komputasi
Anda harus menyediakan kapasitas komputasi yang cukup agar penggunaan CPU dan penggunaan penyimpanan tidak melebihi batas maksimum yang direkomendasikan. Untuk mengetahui informasi selengkapnya, lihat kuota dan batas untuk Spanner.
Ada beberapa kasus yang membuat Anda tidak dapat mengurangi kapasitas komputasi instance yang ada:
- Jika kapasitas komputasi dihapus, instance Anda harus menyimpan lebih dari 4 TB data per 1.000 unit pemrosesan (1 node).
- Berdasarkan pola penggunaan historis Anda, Spanner telah membuat banyak pemisahan untuk data instance, dan dalam beberapa kasus yang jarang terjadi, Spanner tidak akan dapat mengelola pemisahan setelah menghapus kapasitas komputasi.
Dalam kasus terakhir, Anda dapat mencoba mengurangi kapasitas komputasi dengan jumlah yang lebih kecil secara bertahap sampai Anda menemukan kapasitas minimum yang diperlukan Spanner untuk mengelola semua bagian instance. Jika instance tidak lagi memerlukan begitu banyak pemisahan karena perubahan pola penggunaan, Spanner mungkin pada akhirnya akan menggabungkan beberapa pemisahan dan memungkinkan Anda untuk mencoba mengurangi kapasitas komputasi instance lebih lanjut setelah satu atau dua minggu.
Saat menghapus kapasitas komputasi, pantau pemakaian CPU dan latensi permintaan di Cloud Monitoring untuk memastikan pemakaian CPU tetap di bawah 65% untuk instance regional dan 45% untuk setiap region di instance multi-region. Anda mungkin mengalami peningkatan latensi permintaan untuk sementara waktu sekaligus menghapus kapasitas komputasi.
Jika ingin meningkatkan kapasitas komputasi instance, project Google Cloud Anda harus memiliki kuota yang cukup untuk menambahkan kapasitas komputasi.
Konsol
Buka halaman Spanner Instances di konsol Google Cloud.
Klik nama instance yang ingin Anda ubah.
Klik Edit Instance.
Ubah kapasitas komputasi dengan memilih unit pengukuran (unit pemrosesan atau node), lalu memasukkan jumlahnya. Saat menggunakan unit pemrosesan, masukkan jumlah hingga 1.000 dalam kelipatan 100 (100, 200, 300, dan seterusnya) dan masukkan jumlah yang lebih besar dalam kelipatan 1.000 (1000, 2000, 3000, dan seterusnya). Setiap node sama dengan 1.000 unit pemrosesan.
Klik Save.
Jika Anda melihat dialog yang menyatakan bahwa Anda tidak memiliki kuota yang cukup untuk menambahkan kapasitas komputasi di lokasi ini, ikuti petunjuk untuk meminta kuota yang lebih tinggi.
gcloud
Gunakan perintah
gcloud spanner instances update
. Saat menggunakan perintah ini, tentukan kapasitas komputasi sebagai jumlah node atau unit pemrosesan.
gcloud spanner instances update INSTANCE-ID --nodes=NODE-COUNT
atau
gcloud spanner instances update INSTANCE-ID --processing-units=PROCESSING-UNIT-COUNT
Ganti kode berikut:
- INSTANCE-ID: ID permanen untuk instance.
- NODE-COUNT: kapasitas komputasi instance, yang dinyatakan sebagai jumlah node. Setiap node sama dengan 1.000 unit pemrosesan.
- PROCESSING-UNIT-COUNT: kapasitas komputasi instance, dinyatakan sebagai jumlah unit pemrosesan. Masukkan jumlah hingga 1.000 dalam kelipatan 100 (100, 200, 300, dan seterusnya) dan masukkan jumlah yang lebih besar dalam kelipatan 1000 (1000, 2000, 3000, dan seterusnya).
Mengaktifkan atau mengubah penghitung skala otomatis yang dikelola pada instance
Batasan berikut berlaku saat Anda menambahkan atau mengubah fitur penskalaan otomatis terkelola pada instance yang ada:
- Anda tidak dapat mengaktifkan penskala otomatis yang dikelola pada instance yang Anda pindahkan.
Anda tidak dapat memindahkan instance saat penskala otomatis terkelola diaktifkan.
Konsol
Buka halaman Spanner Instances di konsol Google Cloud.
Klik nama instance tempat Anda ingin mengaktifkan autoscaler terkelola.
Klik Edit instance.
Di bagian Configure compute capacity, klik Autoscaling.
Untuk Minimum, pilih batas minimum yang akan digunakan saat memperkecil skala. Untuk informasi selengkapnya, lihat Menentukan batas minimum.
Untuk Maksimum, pilih batas maksimum yang akan digunakan saat meningkatkan skala. Untuk mengetahui informasi selengkapnya, lihat Menentukan batas maksimum.
Untuk Highpriority CPU utilization target, pilih persentase CPU prioritas tinggi yang akan digunakan. Untuk mengetahui informasi selengkapnya, lihat Menentukan target penggunaan CPU.
Untuk Storage utilization target, pilih persentase penyimpanan yang akan digunakan. Untuk mengetahui informasi selengkapnya, lihat Menentukan target penggunaan penyimpanan.
Klik Save.
gcloud
Gunakan
perintah gcloud beta spanner instances update
untuk menambahkan penskala otomatis terkelola ke instance. Untuk informasi dan
batasan selengkapnya, lihat tanda dan batasan Google Cloud CLI
.
Anda dapat menambahkan penskala otomatis terkelola dengan perintah berikut:
gcloud beta spanner instances update \ --autoscaling-min-processing-units=MINIMUM_PROCESSING_UNITS \ --autoscaling-max-processing-units=MAXIMUM_PROCESSING_UNITS \ --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \ --autoscaling-storage-target=STORAGE_PERCENTAGE
atau
gcloud beta spanner instances update \ --autoscaling-min-processing-units=MINIMUM_NODES \ --autoscaling-max-processing-units=MAXIMUM_NODES \ --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \ --autoscaling-storage-target=STORAGE_PERCENTAGE
Ganti kode berikut:
- MINIMUM_PROCESSING_UNITS, MINIMUM_NODES: jumlah minimum unit pemrosesan atau node yang akan digunakan saat memperkecil skala. Untuk informasi selengkapnya, lihat Menentukan batas minimum.
- MAXIMUM_PROCESSING_UNITS, MAXIMUM_NODES: jumlah maksimum unit pemrosesan atau node yang akan digunakan saat meningkatkan skala. Untuk mengetahui informasi selengkapnya, lihat Menentukan batas maksimum.
- CPU_PERCENTAGE: persentase target CPU prioritas tinggi yang akan digunakan, dari 10% hingga 90%. Jika Anda mengoptimalkan biaya dan tidak memerlukan latensi rendah pada semua permintaan, gunakan persentase yang lebih tinggi. Untuk mengetahui informasi selengkapnya, lihat Menentukan target penggunaan CPU.
- STORAGE_PERCENTAGE: persentase target penyimpanan yang akan digunakan, dari 10% hingga 99%. Untuk informasi selengkapnya, lihat Menentukan Target Penggunaan Penyimpanan.
Setelah menambahkan penskala otomatis terkelola ke instance, Anda juga dapat mengubah setelan penghitung skala otomatis yang dikelola. Misalnya, jika Anda ingin meningkatkan jumlah maksimum unit pemrosesan menjadi 10.000, jalankan perintah berikut:
gcloud beta spanner instances update \
--autoscaling-max-processing-units=10000
Mengubah instance dari menggunakan penskalaan otomatis terkelola menjadi penskalaan manual
Konsol
Buka halaman Spanner Instances di konsol Google Cloud.
Klik nama instance yang ingin Anda nonaktifkan autoscaler terkelola.
Di bagian Pilih mode penskalaan, klik Alokasi manual.
Klik Save.
gcloud
Gunakan perintah gcloud beta spanner instances update
untuk mengupdate instance.
Gunakan perintah berikut untuk mengubah instance dari menggunakan autoscaler terkelola ke penskalaan manual:
gcloud beta spanner instances update \ --processing-units=PROCESSING-UNITS-COUNT
atau
gcloud beta spanner instances update \ --nodes=NODE-COUNT
Ganti PROCESSING-UNIT-COUNT atau NODE-COUNT dengan jumlah unit pemrosesan atau node yang ingin Anda gunakan pada instance.
Memberi label pada instance
Label membantu mengatur resource Anda.
Konsol
Buka halaman Spanner Instances di konsol Google Cloud.
Pilih kotak centang untuk instance tersebut. Panel info akan muncul di sisi kanan halaman.
Klik tab Label di Panel info. Kemudian, Anda dapat menambahkan, menghapus, atau memperbarui label untuk instance Spanner.
Memindahkan instance
Untuk mengetahui petunjuk tentang cara memindahkan instance dari konfigurasi instance apa pun ke konfigurasi instance lainnya, termasuk antara konfigurasi regional dan multi-regional, lihat Memindahkan instance.
Menghapus instance
Anda dapat menghapus instance dengan Google Cloud Console atau Google Cloud CLI.
Jika ingin menghapus instance yang memiliki satu atau beberapa database dengan perlindungan penghapusan diaktifkan, Anda harus menonaktifkan perlindungan penghapusan terlebih dahulu pada semua database dalam instance tersebut sebelum dapat menghapus instance.
Konsol
Buka halaman Spanner Instances di konsol Google Cloud.
Klik nama instance yang ingin Anda hapus.
Klik Hapus instance.
Ikuti petunjuk untuk mengonfirmasi bahwa Anda ingin menghapus instance.
Klik Delete.
gcloud
Gunakan perintah gcloud spanner instances delete
, yang menggantikan INSTANCE-ID dengan ID instance:
gcloud spanner instances delete INSTANCE-ID
Menghentikan atau memulai ulang instance
Spanner adalah layanan database terkelola sepenuhnya yang mengawasi tugas dan resource dasarnya sendiri, termasuk memantau dan memulai ulang proses jika diperlukan tanpa periode nonaktif. Karena instance tertentu tidak perlu dihentikan atau dimulai ulang secara manual, Spanner tidak menawarkan cara untuk melakukannya.
Langkah selanjutnya
- Pelajari cara menyisipkan, memperbarui, dan menghapus data dengan Data Manipulation Language (DML) atau gcloud CLI.
- Berikan peran Identity and Access Management untuk instance dan database-nya.
- Pahami cara mendesain skema Spanner.