Halaman ini menjelaskan cara menampilkan daftar, membuat, memperbarui, menghapus, dan menampilkan detail konfigurasi instance Spanner. Beberapa fungsionalitas konfigurasi instance kustom tidak tersedia di UI Google Cloud Console. Dalam kasus tersebut, gunakan perintah Google Cloud CLI (gcloud) yang disediakan.
Membuat daftar konfigurasi instance
Anda dapat menampilkan daftar semua konfigurasi instance Spanner yang tersedia dengan Google Cloud CLI dan library klien. Untuk menemukan daftar semua konfigurasi instance Spanner, lihat Konfigurasi regional dan multi-region.
gcloud
Jalankan perintah gcloud spanner instance-configs list
:
gcloud spanner instance-configs list
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.
Ruby
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Tampilkan detail konfigurasi instance
Anda dapat menampilkan detail konfigurasi instance apa pun dengan Google Cloud CLI dan library klien. Saat membuat konfigurasi instance kustom baru, Anda dapat menambahkan lokasi mana pun yang tercantum di optionalReplicas
sebagai replika opsional.
Jika tidak melihat lokasi replika hanya baca yang diinginkan, Anda dapat meminta region replika hanya baca opsional baru.
Untuk mengetahui informasi selengkapnya, lihat Membuat konfigurasi instance kustom.
gcloud
Jalankan perintah gcloud spanner instance-configs describe
:
gcloud spanner instance-configs describe INSTANCE-CONFIG
Berikan nilai berikut:
INSTANCE-CONFIG
- Konfigurasi instance, yang menentukan lokasi geografis instance dan memengaruhi cara data direplikasi. Misalnya,
eur6
atauus-central1
.
Untuk menampilkan detail konfigurasi dasar eur6
, jalankan:
gcloud spanner instance-configs describe eur6
Berikut adalah contoh output untuk konfigurasi dasar eur6
:
configType: GOOGLE_MANAGED
displayName: Europe (Netherlands, Frankfurt)
freeInstanceAvailability: UNSUPPORTED
leaderOptions:
- europe-west3
- europe-west4
name: projects/cloud-spanner-demo/instanceConfigs/eur6
optionalReplicas:
- displayName: South Carolina
labels:
cloud.googleapis.com/country: US
cloud.googleapis.com/location: us-east1
cloud.googleapis.com/region: us-east1
location: us-east1
type: READ_ONLY
- displayName: South Carolina
labels:
cloud.googleapis.com/country: US
cloud.googleapis.com/location: us-east1
cloud.googleapis.com/region: us-east1
location: us-east1
type: READ_ONLY
replicas:
- defaultLeaderLocation: true
location: europe-west4
type: READ_WRITE
- location: europe-west4
type: READ_WRITE
- location: europe-west3
type: READ_WRITE
- location: europe-west3
type: READ_WRITE
- location: europe-west6
type: WITNESS
Catatan penggunaan tambahan:
baseConfig
(hanya untuk konfigurasi kustom) mengarah ke konfigurasi instance dasar. Lihat konfigurasi regional yang tersedia dan konfigurasi multi-region yang tersedia untuk mengetahui daftar konfigurasi instance dasar yang dapat digunakan untuk membuat konfigurasi instance kustom.configType
menunjukkan apakah konfigurasi instance ini adalah konfigurasi instance dasar atau konfigurasi instance kustom.etag
(hanya untuk konfigurasi kustom) adalah representasi string berenkode base64 dari konfigurasi. Ini digunakan untuk kontrol konkurensi optimis.
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.
Ruby
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Membuat konfigurasi instance kustom
Anda dapat membuat konfigurasi instance kustom dan menambahkan replika hanya baca opsional untuk menskalakan pembacaan dan mendukung pembacaan yang tidak berlaku lagi dengan latensi rendah. Lihat konfigurasi regional yang tersedia dan konfigurasi multi-region yang tersedia untuk mengetahui daftar konfigurasi instance dasar yang dapat digunakan untuk membuat konfigurasi instance kustom. Untuk mengetahui informasi selengkapnya tentang jenis replika dan replika Spanner, lihat Replikasi.
Untuk membuat konfigurasi instance kustom, Anda harus memiliki izin spanner.instanceConfigs.create
. Secara default, peran yang memiliki izin spanner.instances.create
juga akan memiliki izin spanner.instanceConfigs.create
.
Konsol
Anda tidak dapat membuat konfigurasi instance kustom mandiri menggunakan Konsol Google Cloud. Untuk membuat instance dengan replika hanya baca, lihat petunjuk yang diberikan di bagian Membuat instance dengan konfigurasi instance kustom.
Anda dapat menggunakan Google Cloud CLI dan library klien untuk membuat konfigurasi instance kustom mandiri.
gcloud
Gunakan perintah gcloud spanner instance-configs create
:
gcloud spanner instance-configs create CUSTOM-INSTANCE-CONFIG-ID \
--display-name=DISPLAY-NAME \
--base-config=BASE-CONFIG \
--labels=KEY=VALUE,[...] \
--replicas=location=LOCATION, type=TYPE[:...]
Anda dapat menggunakan tanda --clone-config
sebagai cara yang mudah untuk meng-clone konfigurasi
dasar atau instance kustom lain sekaligus mendeklarasikan lokasi dan
jenis replika kustom tertentu.
gcloud spanner instance-configs create CUSTOM-INSTANCE-CONFIG-ID \
--display-name=DISPLAY-NAME \
--clone-config=INSTANCE-CONFIG \
--labels=KEY=VALUE,[...] \
--add-replicas=location=LOCATION, type=TYPE[:...] \
--skip-replicas=location=LOCATION, type=TYPE[:...]
Berikan nilai berikut:
CUSTOM-INSTANCE-CONFIG-ID
- ID permanen yang unik dalam project Google Cloud Anda. Anda
tidak dapat mengubah ID konfigurasi instance nanti. Awalan
custom-
diperlukan untuk menghindari konflik nama dengan konfigurasi instance dasar. DISPLAY-NAME
- Nama yang akan ditampilkan untuk konfigurasi instance kustom di Konsol Google Cloud. Jika Anda memilih untuk menggunakan flag `--base-config` dan `--replicas`, berikan nilai berikut:
BASE-CONFIG
- Nama region dari konfigurasi instance dasar tempat konfigurasi instance kustom Anda berada. Misalnya,
eur6
atauregional-us-central1
. LOCATION
- Nama region resource penayangan (replikas), misalnya,
us-east1
. Untuk mengetahui nama lokasi yang diterima, jalankangcloud spanner instance-configs describe INSTANCE-CONFIG
dan lihat daftarreplicas
danoptionalReplicas
. TYPE
- Jenis replika. Untuk mengetahui lokasi terkait dan jenis replika yang diterima, jalankan
gcloud spanner instance-configs describe INSTANCE-CONFIG
dan lihat daftarreplicas
danoptionalReplicas
. Jenisnya adalah salah satu dari berikut ini:- READ_ONLY
- READ_WRITE
- KEBUGARAN
- Item dalam daftar dipisahkan dengan ":".
- Kecuali jika tanda
--[clone-config]
digunakan, semua replikaLOCATION
danTYPE
harus ditentukan saat membuat konfigurasi instance kustom, termasuk yang telah ditentukan sebelumnya dalam konfigurasi dasar. Untuk mengetahui informasi selengkapnya, lihat gcloud instance-configs explain help-text.
Jika Anda memilih untuk menggunakan tanda --clone-config
dan --add-replicas
(hanya
gunakan --skip-replicas
jika ada replika yang ingin Anda lewati agar tidak
di-clone), berikan nilai berikut:
--clone-config=INSTANCE-CONFIG
Gunakan tanda ini sebagai cara yang mudah untuk meng-clone konfigurasi dasar atau instance kustom lainnya sekaligus mendeklarasikan lokasi dan jenis replika kustom tertentu. Kemudian, gunakan
--add-replicas=location=LOCATION,type=TYPE
untuk menentukan tempat Anda ingin menambahkan replika opsional.Misalnya, untuk membuat konfigurasi instance kustom dengan dua replika hanya baca di
us-east1
sambil menyalin semua lokasi replika lainnya dari konfigurasi instance dasareur6
, jalankan:gcloud spanner instance-configs create custom-eur6 --clone-config=eur6 \ --add-replicas=location=us-east1,type=READ_ONLY:location=us-east1,type=READ_ONLY
--skip-replicas=location=LOCATION,type=TYPE
Gunakan tanda ini untuk melewati replika apa pun agar tidak di-clone.
Misalnya, untuk membuat konfigurasi instance kustom dengan satu replika hanya baca di
us-east4
sekaligus menyalin semua lokasi replika lainnya dari konfigurasi instance dasarnam3
kecuali replika hanya baca dius-central1
, jalankan:gcloud spanner instance-configs create custom-nam3 --clone-config=nam3 \ --add-replicas=location=us-east4,type=READ_ONLY \ --skip-replicas=location=us-central1,type=READ_ONLY
Tanda dan nilai berikut bersifat opsional:
--labels=KEY=VALUE,[...]
KEY
danVALUE
: Daftar pasangan kunci dan nilai yang akan ditambahkan ke konfigurasi instance kustom Anda.Kunci harus diawali dengan karakter huruf kecil dan hanya berisi tanda hubung (-), garis bawah (_), huruf kecil, dan angka. Nilai hanya boleh berisi tanda hubung (-), garis bawah (_), huruf kecil, dan angka.
--validate-only
Gunakan tanda ini untuk memvalidasi bahwa permintaan akan berhasil sebelum dieksekusi.
Misalnya, untuk membuat konfigurasi instance kustom dengan konfigurasi dasar eur6
dengan satu replika hanya baca tambahan di us-east1
, jalankan:
gcloud spanner instance-configs create custom-eur6 \
--display-name="Custom eur6" --clone-config=eur6 \
--add-replicas=location=us-east1,type=READ_ONLY \
Anda juga dapat membuat konfigurasi instance kustom tanpa flag --clone-config
:
gcloud spanner instance-configs create custom-eur6 \
--display-name="Custom eur6" --base-config=eur6 \
--replicas=location=europe-west4,type=READ_WRITE:location=europe-west3,type=READ_WRITE:location=europe-west4,type=READ_WRITE:location=europe-west3,type=READ_WRITE:location=europe-west6,type=WITNESS:location=us-east1,type=READ_ONLY
Anda akan melihat output berikut:
Creating instance-config...done.
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.
Ruby
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Membuat instance dengan konfigurasi instance kustom
Anda dapat membuat instance dengan konfigurasi instance kustom.
Konsol
Untuk membuat instance dengan konfigurasi instance kustom, ikuti petunjuk yang diberikan di Membuat instance.
Perhatikan bahwa Anda tidak perlu membuat konfigurasi instance kustom mandiri di Google Cloud Console. Konfigurasi instance dibuat secara otomatis saat Anda membuat instance.
gcloud
Setelah Anda membuat konfigurasi instance kustom, ikuti petunjuk yang diberikan di artikel Membuat instance.
C++
Setelah Anda membuat konfigurasi instance kustom, ikuti petunjuk yang diberikan di artikel Membuat instance.
C#
Setelah Anda membuat konfigurasi instance kustom, ikuti petunjuk yang diberikan di artikel Membuat instance.
Go
Setelah Anda membuat konfigurasi instance kustom, ikuti petunjuk yang diberikan di artikel Membuat instance.
Java
Setelah Anda membuat konfigurasi instance kustom, ikuti petunjuk yang diberikan di artikel Membuat instance.
Node.js
Setelah Anda membuat konfigurasi instance kustom, ikuti petunjuk yang diberikan di artikel Membuat instance.
PHP
Setelah Anda membuat konfigurasi instance kustom, ikuti petunjuk yang diberikan di artikel Membuat instance.
Python
Setelah Anda membuat konfigurasi instance kustom, ikuti petunjuk yang diberikan di artikel Membuat instance.
Ruby
Setelah Anda membuat konfigurasi instance kustom, ikuti petunjuk yang diberikan di artikel Membuat instance.
Mengupdate konfigurasi instance kustom
Anda dapat mengubah nama tampilan dan label konfigurasi instance kustom. Anda tidak dapat mengubah atau mengupdate replika konfigurasi instance kustom.
gcloud
Gunakan perintah gcloud spanner instance-configs update
:
gcloud spanner instance-configs update CUSTOM-INSTANCE-CONFIG-ID \
--display-name=NEW-DISPLAY-NAME \
--update-labels=KEY=VALUE,[...], \
--etag=ETAG
Berikan nilai berikut:
CUSTOM-INSTANCE-CONFIG-ID
- ID permanen konfigurasi instance kustom Anda.
Ini akan dimulai dengan
custom-
. NEW-DISPLAY-NAME
- Nama baru yang akan ditampilkan untuk konfigurasi instance di Konsol Google Cloud.
KEY
danVALUE
- Daftar key-value pair yang akan diperbarui.
- Kunci harus dimulai dengan karakter huruf kecil dan hanya berisi tanda hubung (-), garis bawah (_), huruf kecil, dan angka. Nilai hanya boleh berisi tanda hubung (-), garis bawah (_), huruf kecil, dan angka.
Tanda dan nilai berikut bersifat opsional:
--etag=ETAG
: ArgumenETAG
dapat digunakan untuk memilih dan melewati update simultan dalam skenario baca-modifikasi-tulis.--validate-only
: Gunakan tanda ini untuk memvalidasi bahwa permintaan akan berhasil sebelum menjalankannya.
Contoh:
gcloud spanner instance-configs update custom-eur6 \
--display-name="Customer managed europe replicas"
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.
Ruby
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Menghapus konfigurasi instance kustom
Untuk menghapus konfigurasi instance kustom, hapus instance apa pun dalam konfigurasi instance terlebih dahulu.
gcloud
Gunakan perintah gcloud spanner instance-configs delete
, dan ganti CUSTOM-INSTANCE-CONFIG-ID
dengan ID konfigurasi instance kustom:
gcloud spanner instance-configs delete CUSTOM-INSTANCE-CONFIG-ID
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.
Ruby
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Langkah selanjutnya
- Pelajari cara menyisipkan, memperbarui, dan menghapus data dengan Bahasa Manipulasi Data (DML) atau gcloud CLI.
- Memberikan peran IAM untuk instance dan database-nya.
- Pahami cara mendesain skema Spanner.
- Kuota dan batas Spanner.