Halaman ini menjelaskan cara membuat dan mengelola partisi instance Spanner.
Sebelum memulai
Untuk menggunakan partisi instance, Anda harus menetapkan opsi database opt_in_dataplacement_preview
di database kosong:
Konsol
Buka halaman Instances di konsol Google Cloud .
Pilih instance tempat Anda ingin menambahkan partisi instance.
Pilih database kosong tempat Anda ingin memartisi data.
Di menu navigasi, klik Spanner Studio.
Di halaman Spanner Studio, klik
Tab baru atau gunakan tab editor yang kosong.Masukkan pernyataan DDL
ALTER DATABASE
berikut.GoogleSQL
ALTER DATABASE DATABASE_ID SET OPTIONS (opt_in_dataplacement_preview = true);
Ganti DATABASE_ID dengan ID unik database Anda.
PostgreSQL
ALTER DATABASE DATABASE_ID SET "spanner.opt_in_dataplacement_preview" = TRUE;
Ganti DATABASE_ID dengan ID unik database Anda.
Klik Run.
gcloud
Untuk menetapkan opsi database opt_in_dataplacement_preview
, gunakan
gcloud spanner databases ddl update
.
GoogleSQL
gcloud spanner databases ddl update DATABASE_ID \
--instance=INSTANCE_ID \
--ddl="ALTER DATABASE DATABASE_ID SET OPTIONS (opt_in_dataplacement_preview = true);"
Ganti kode berikut:
DATABASE_ID
: ID permanen untuk database Spanner Anda.INSTANCE_ID
: ID permanen untuk instance Spanner Anda.
PostgreSQL
gcloud spanner databases ddl update DATABASE_ID \
--instance=INSTANCE_ID \
--ddl="ALTER DATABASE DATABASE_ID SET "spanner.opt_in_dataplacement_preview" = TRUE"
Ganti kode berikut:
DATABASE_ID
: ID permanen untuk database Spanner Anda.INSTANCE_ID
: ID permanen untuk instance Spanner Anda.
Membuat partisi instance
Konsol
Di Google Cloud console, buka halaman Spanner.
Pilih instance tempat Anda ingin menambahkan partisi instance.
Di menu navigasi, pilih Partisi instance.
Klik Create instance partition.
Masukkan ID Partisi untuk mengidentifikasi partisi instance Anda secara permanen. ID partisi instance juga harus unik dalam projectGoogle Cloud Anda. Anda tidak dapat mengubah ID partisi instance nanti.
Di bagian Pilih konfigurasi, pilih Regional atau Multi-region. Atau, jika Anda ingin membandingkan spesifikasi antar-region, klik Bandingkan konfigurasi region.
Pilih konfigurasi dari menu drop-down.
Di bagian Allocate compute capacity, di bagian Unit, klik salah satu opsi berikut:
- Unit pemrosesan untuk partisi instance kecil.
- Node untuk instance besar. Node adalah 1.000 unit pemrosesan.
Masukkan nilai untuk unit yang dipilih.
Partisi instance Anda harus memiliki setidaknya satu node atau 1.000 unit pemrosesan.
Klik Create untuk membuat partisi instance.
gcloud
Untuk membuat partisi instance, gunakan
gcloud beta spanner instance-partitions create
.
gcloud beta spanner instance-partitions create INSTANCE_PARTITION_ID \ --config=INSTANCE_PARTITION_CONFIG \ --description="INSTANCE_PARTITION_DESCRIPTION" \ --instance=INSTANCE_ID \ [--nodes=NODE_COUNT | --processing-units=PROCESSING_UNIT_COUNT]
Ganti kode berikut:
- INSTANCE_PARTITION_ID: ID partisi instance permanen yang unik dalam Google Cloud project Anda. Anda tidak dapat mengubah ID partisi instance nanti.
- INSTANCE_PARTITION_CONFIG: ID permanen konfigurasi partisi instance Anda, yang menentukan lokasi geografis partisi instance dan memengaruhi tempat data disimpan.
- INSTANCE_PARTITION_DESCRIPTION: nama yang akan ditampilkan untuk partisi instance di konsol Google Cloud . Nama partisi instance harus unik dalam project Google Cloud Anda.
- INSTANCE_ID: ID permanen untuk instance Spanner tempat partisi instance ini berada.
- NODE_COUNT: kapasitas komputasi partisi instance, dinyatakan sebagai jumlah node. Satu node sama dengan 1.000 unit pemrosesan.
- PROCESSING_UNIT_COUNT: kapasitas komputasi instance, yang dinyatakan sebagai jumlah unit pemrosesan. Partisi instance Anda harus memiliki minimal 1.000 unit pemrosesan. Masukkan jumlah dalam kelipatan 1.000 (1.000, 2.000, 3.000, dan seterusnya).
Misalnya, untuk membuat partisi instance europe-partition
di eur3
dengan 5 node, jalankan perintah berikut:
gcloud beta spanner instance-partitions create europe-partition --config=eur3 \
--description="europe-partition" --instance=test-instance --nodes=5
Library klien
C++
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
C#
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
PHP
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Mendeskripsikan partisi instance
gcloud
Untuk mendeskripsikan partisi instance, gunakan
gcloud beta spanner instance-partitions describe
.
gcloud beta spanner instance-partitions describe PARTITION_ID \ --instance=INSTANCE_ID
Ganti kode berikut:
- INSTANCE_PARTITION_ID: ID permanen untuk partisi instance.
- INSTANCE_ID: ID permanen untuk instance.
Misalnya, untuk mendeskripsikan partisi instance europe-partition
,
jalankan perintah berikut:
gcloud beta spanner instance-partitions describe europe-partition
--instance=test-instance
Mencantumkan partisi instance
Konsol
Di Google Cloud console, buka halaman Spanner.
Pilih instance dari daftar.
Di menu navigasi, pilih Partisi instance.
Daftar partisi instance yang terkait dengan instance tersebut akan ditampilkan.
gcloud
Untuk mencantumkan partisi instance Anda, gunakan
gcloud beta spanner instance-partitions list
.
gcloud beta spanner instance-partitions list --instance=INSTANCE_ID
gcloud CLI mencetak daftar partisi instance Spanner Anda, beserta ID, nama tampilan, konfigurasi, dan kapasitas komputasi setiap partisi instance.
Mengedit partisi instance
Bagian berikut menjelaskan cara mengubah kapasitas komputasi partisi instance Anda. Anda tidak dapat mengubah ID partisi, nama, atau konfigurasi instance.
Mengubah kapasitas komputasi
Anda harus menyediakan kapasitas komputasi yang cukup untuk menjaga pemanfaatan CPU dan pemanfaatan penyimpanan di bawah batas maksimum yang direkomendasikan. Untuk mengetahui informasi selengkapnya, lihat kuota dan batas untuk Spanner.
Jika Anda ingin meningkatkan kapasitas komputasi partisi instance,Google Cloud project Anda harus memiliki kuota yang memadai untuk menambahkan kapasitas komputasi. Waktu yang diperlukan untuk menyelesaikan permintaan penambahan bergantung pada ukuran permintaan. Biasanya, permintaan selesai dalam beberapa menit. Dalam kasus yang jarang terjadi, penskalaan mungkin memerlukan waktu hingga satu jam untuk selesai.
Konsol
Di Google Cloud console, buka halaman Spanner.
Pilih instance dari daftar.
Di menu navigasi, pilih Partisi instance.
Dalam daftar partisi instance, di kolom Tindakan, klik Tindakan Lainnya, lalu pilih Edit.
Ubah kapasitas komputasi dengan memilih satuan pengukuran (unit pemrosesan atau node), lalu masukkan jumlah. Saat menggunakan unit pemrosesan, masukkan jumlah dalam kelipatan 1000 (1000, 2000, 3000, dan seterusnya). Setiap node sama dengan 1.000 unit pemrosesan.
Partisi instance Anda harus memiliki setidaknya satu node (1.000 unit pemrosesan).
Klik Simpan.
Jika Anda melihat dialog yang menyatakan bahwa Anda tidak memiliki kuota yang cukup untuk menambahkan kapasitas komputasi , ikuti petunjuk untuk meminta kuota yang lebih tinggi.
gcloud
Untuk mengubah kapasitas komputasi partisi instance, gunakan
gcloud beta spanner instance-partitions update
.
Saat menggunakan perintah ini, tentukan kapasitas komputasi sebagai
jumlah node atau unit pemrosesan.
gcloud beta spanner instance-partitions update INSTANCE_PARTITION_ID \ --instance=INSTANCE_ID \ [--nodes=NODE_COUNT | --processing-units=PROCESSING_UNIT_COUNT] [--async]
Ganti kode berikut:
- INSTANCE_PARTITION_ID: ID permanen untuk partisi instance.
- INSTANCE_ID: ID permanen untuk instance.
- NODE_COUNT: kapasitas komputasi baru partisi instance, dinyatakan sebagai jumlah node. Satu node sama dengan 1.000 unit pemrosesan.
- PROCESSING_UNIT_COUNT: kapasitas komputasi baru partisi instance, yang dinyatakan sebagai jumlah unit pemrosesan. Partisi instance Anda harus memiliki minimal 1.000 unit pemrosesan. Masukkan jumlah dalam kelipatan 1000 (1000, 2000, 3000, dan seterusnya).
Flag opsional:
--async
: Gunakan tanda ini jika Anda ingin permintaan segera ditampilkan, tanpa menunggu operasi yang sedang berlangsung selesai.
Anda dapat memeriksa status permintaan dengan menjalankan
gcloud spanner operations describe
.
Menghapus partisi instance
Anda tidak dapat menghapus partisi instance saat partisi tersebut dikaitkan dengan penempatan atau data apa pun. Anda harus memindahkan data apa pun yang ada di partisi instance atau menghapus tabel penempatan yang menggunakan partisi instance sebelum Anda dapat menghapus partisi instance.
Konsol
Di Google Cloud console, buka halaman Spanner.
Pilih instance dari daftar.
Di menu navigasi, pilih Partisi instance.
Dalam daftar partisi instance, di kolom Tindakan, klik Tindakan Lainnya, lalu pilih Hapus.
Ikuti petunjuk untuk mengonfirmasi bahwa Anda ingin menghapus partisi Instance.
Klik Hapus.
gcloud
Gunakan perintah gcloud beta spanner instance-partitions delete
.
gcloud beta spanner instance-partitions delete INSTANCE_PARTITION_ID --instance=INSTANCE_ID
Langkah berikutnya
- Pelajari cara membuat dan mengelola tabel dan kunci penempatan.