Halaman ini menjelaskan cara membuat dan mengelola penempatan data di Spanner.
Untuk mengetahui informasi selengkapnya tentang cara kerja partisi geografis, lihat Ringkasan partisi geografis.
Mengelola metadata pemilihan rute
Saat aplikasi Anda perlu membaca atau menulis data, Spanner menggunakan metadata pemilihan rute untuk menemukan server mana yang menyimpan baris tertentu yang diperlukan.
Pemilihan tempat metadata pemilihan rute berada bergantung pada apakah sebagian besar permintaan klien ditujukan untuk data dalam region yang sama atau di luar region, dan apakah Anda menggunakan konfigurasi multi-region. Setelan metadata pemilihan rute memengaruhi latensi dan tidak dapat diubah setelah Anda membuat penempatan.
Opsi per_placement_routing_metadata menentukan tempat metadata pemilihan rute berada sesuai dengan setelan berikut:
TRUE: Jika ditetapkan keTRUE, metadata pemilihan rute akan berada di partisi instance yang sama dengan data. Metadata pemilihan rute di-sharding menurut region. Hal ini mengurangi latensi untuk permintaan data dalam region (yaitu, klien dan data pengguna yang diminta berada di region yang sama) sehingga Spanner tidak perlu melakukan panggilan di luar region untuk merutekan metadata. Namun, setelan ini mungkin meningkatkan latensi untuk permintaan di luar region, untuk pencarian negatif di mana baris penempatan tidak ada, dan untuk kueri yang memerlukan indeks global.Sebaiknya gunakan setelan ini jika Anda memperkirakan sebagian besar permintaan akan dibuat untuk data pengguna dalam region yang sama dengan klien, dan partisi default Anda tidak memiliki region baca-tulis atau hanya baca yang ditempatkan bersama dengan semua partisi instance Anda.
FALSE: Metadata pemilihan rute dipusatkan di partisi default.Sebaiknya gunakan setelan ini jika Anda memperkirakan klien akan sering mencari data di luar region; misalnya, klien di region Uni Eropa mencari data untuk pengguna di Amerika Serikat.
Pertimbangkan juga setelan ini jika partisi instance default Anda menggunakan konfigurasi multi-region yang menyediakan region baca-tulis atau hanya baca yang ditempatkan bersama semua partisi instance Anda. Dengan setelan ini, replika metadata perutean lengkap disimpan dengan setiap replika partisi instance default. Oleh karena itu, semua region dengan partisi instance memiliki replika metadata pemilihan rute. Hal ini memungkinkan permintaan dalam region dan luar region mencari metadata pemilihan rute secara lokal.
Tetapkan opsi per_placement_routing_metadata
Opsi per_placement_routing_metadata menerima nilai boolean. Jika opsi ini adalah TRUE, metadata pemilihan rute berada di partisi instance yang sama dengan data. Jika FALSE, metadata pemilihan rute berada di partisi instance default.
Untuk menetapkan opsi per_placement_routing_metadata, perbarui skema database Anda.
Untuk mengetahui informasi tentang cara lain untuk mengupdate skema, seperti library klien atau REST API dan RPC API, lihat Membuat update skema.
Pilih salah satu opsi berikut:
Konsol
Di konsol Google Cloud , buka halaman Instances.
Pilih instance dengan partisi instance yang dibuat pengguna.
Pilih database tempat Anda ingin menetapkan metadata pemilihan rute.
Di menu navigasi, klik Spanner Studio.
Di halaman Spanner Studio, klik New tab atau gunakan tab editor kosong.
Masukkan pernyataan DDL
ALTER DATABASE(GoogleSQL, PostgreSQL):GoogleSQL
ALTER DATABASE `DATABASE_NAME` SET OPTIONS (per_placement_routing_metadata = METADATA_BOOLEAN);Ganti kode berikut:
DATABASE_NAME: nama database Anda.METADATA_BOOLEAN: nilaiper_placement_routing_metadata. JikaTRUE, metadata pemilihan rute akan berada di partisi instance yang sama dengan data. JikaFALSE, metadata pemilihan rute berada di partisi instance default.
PostgreSQL
ALTER DATABASE "DATABASE_NAME" SET spanner.per_placement_routing_metadata = METADATA_BOOLEAN;Ganti kode berikut:
DATABASE_NAME: nama database Anda.METADATA_BOOLEAN: nilaiper_placement_routing_metadata. JikaTRUE, metadata pemilihan rute akan berada di partisi instance yang sama dengan data. JikaFALSE, metadata pemilihan rute berada di partisi instance default.
Klik Run.
gcloud
Untuk menetapkan opsi per_placement_routing_metadata dengan Google Cloud CLI, gunakan gcloud spanner databases ddl update:
GoogleSQL
gcloud spanner databases ddl update DATABASE_NAME \
--instance=INSTANCE_ID \
--ddl='ALTER DATABASE `DATABASE_NAME`
SET OPTIONS (per_placement_routing_metadata = METADATA_BOOLEAN)'
Ganti kode berikut:
DATABASE_NAME: nama database Anda.INSTANCE_ID: ID instance Spanner Anda.METADATA_BOOLEAN: nilaiper_placement_routing_metadata. JikaTRUE, metadata pemilihan rute akan berada di partisi instance yang sama dengan data. JikaFALSE, metadata pemilihan rute berada di partisi instance default.
PostgreSQL
gcloud spanner databases ddl update DATABASE_NAME \
--instance=INSTANCE_ID \
--ddl='ALTER DATABASE "DATABASE_NAME"
SET spanner.per_placement_routing_metadata = METADATA_BOOLEAN'
Ganti kode berikut:
DATABASE_NAME: nama database Anda.INSTANCE_ID: ID instance Spanner Anda.METADATA_BOOLEAN: nilaiper_placement_routing_metadata. JikaTRUE, metadata pemilihan rute akan berada di partisi instance yang sama dengan data. JikaFALSE, metadata pemilihan rute berada di partisi instance default.
Membuat penempatan data
Setelah Anda membuat partisi instance Spanner dan database serta menetapkan opsi per_placement_routing_metadata, buat penempatan Anda.
Konsol
Buka halaman Instances di konsol Google Cloud .
Pilih instance dengan partisi instance yang dibuat pengguna.
Pilih database yang ingin Anda partisi datanya.
Di menu navigasi, klik Spanner Studio.
Di halaman Spanner Studio, klik New tab atau gunakan tab editor kosong.
Masukkan pernyataan DDL
CREATE PLACEMENT(GoogleSQL, PostgreSQL).Misalnya, Anda dapat menjalankan perintah berikut untuk membuat tabel penempatan
europeplacementdi partisi instanceeurope-partition:GoogleSQL
CREATE PLACEMENT europeplacement OPTIONS (instance_partition="europe-partition");PostgreSQL
CREATE PLACEMENT europeplacement WITH (instance_partition='europe-partition');Opsional: Anda juga dapat menggunakan panel Object Explorer untuk melihat, menelusuri, dan berinteraksi dengan objek Penempatan Anda. Untuk mengetahui informasi selengkapnya, lihat Mempelajari data Anda.
Klik Run.
gcloud
Untuk membuat penempatan dengan perintah gcloud CLI, gunakan
gcloud spanner databases ddl update.
Misalnya, buat penempatan di partisi instance europe-partition:
GoogleSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE PLACEMENT europeplacement OPTIONS (instance_partition='europe-partition')"
PostgreSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE PLACEMENT europeplacement WITH (instance_partition='europe-partition')"
Menetapkan pemimpin default untuk penempatan
Anda dapat menetapkan region leader default penempatan jika lokasinya berada di multi-region. Region leader baru harus merupakan salah satu dari dua region baca-tulis dalam lokasi penempatan multi-region. Untuk mengetahui informasi selengkapnya, lihat tabel Konfigurasi multi-region yang tersedia.
Jika Anda tidak menetapkan region leader, penempatan Anda akan menggunakan region leader default
seperti yang ditentukan oleh lokasinya. Untuk mengetahui daftar region pemimpin untuk setiap lokasi multi-region, lihat tabel Konfigurasi yang tersedia di multi-region. Region leader default ditandai dengan L. Misalnya, region leader default nam8 berada di Los Angeles(us-west2). Petunjuk berikut menjelaskan cara menyetelnya ke Oregon(us-west1).
Konsol
Buka halaman Instances di konsol Google Cloud .
Pilih instance dengan partisi instance yang dibuat pengguna.
Pilih database yang ingin Anda partisi datanya.
Di menu navigasi, klik Spanner Studio.
Di halaman Spanner Studio, klik New tab atau gunakan tab editor kosong.
Masukkan pernyataan DDL
CREATE PLACEMENT(GoogleSQL, PostgreSQL).Misalnya, Anda dapat menjalankan perintah berikut untuk membuat tabel penempatan
nam8placementdi partisi instancenam8-partitiondengan lokasi leader default yang ditetapkan sebagaius-west1:GoogleSQL
CREATE PLACEMENT `nam8placement` OPTIONS (instance_partition="nam8-partition", default_leader="us-west1");PostgreSQL
CREATE PLACEMENT nam8placement WITH (instance_partition='nam8-partition', default_leader='us-west1');Opsional: Anda juga dapat menggunakan panel Object Explorer untuk melihat, menelusuri, dan berinteraksi dengan objek Penempatan Anda. Untuk mengetahui informasi selengkapnya, lihat Mempelajari data Anda.
Klik Run.
gcloud
Untuk membuat penempatan dengan perintah gcloud CLI, gunakan
gcloud spanner databases ddl update.
Misalnya, buat tabel penempatan nam8placement di partisi instance nam8-partition dengan lokasi leader default yang ditetapkan sebagai us-west1:
GoogleSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE PLACEMENT nam8placement \
OPTIONS (instance_partition='nam8-partition', default_leader='us-west1')"
PostgreSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE PLACEMENT nam8placement WITH (instance_partition='nam8-partition', default_leader='us-west1')"
Menghapus penempatan data
Sebelum menghapus penempatan, Anda harus menghapus semua data baris dari penempatan. Setelah melakukannya, Anda dapat menggunakan konsol Google Cloud atau gcloud CLI untuk menghapus penempatan.
Konsol
- Di menu navigasi, klik Spanner Studio.
- Di halaman Spanner Studio, klik New tab atau gunakan tab editor kosong.
Masukkan pernyataan DDL
DROP PLACEMENT(GoogleSQL, PostgreSQL).Misalnya, Anda dapat menjalankan perintah berikut untuk menghapus tabel penempatan
europeplacement:GoogleSQL
DROP PLACEMENT europeplacement;PostgreSQL
DROP PLACEMENT europeplacement;
gcloud
Untuk menghapus penempatan dengan perintah gcloud CLI, gunakan
gcloud spanner databases ddl update.
Misalnya, hapus penempatan europeplacement:
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="DROP PLACEMENT europeplacement"
Error penempatan pelepasan
Jika penempatan sedang digunakan, operasi DROP PLACEMENT akan gagal dengan
pesan error seperti: "Pernyataan gagal: Penempatan
PLACEMENT_NAME tidak dapat dihapus karena sedang digunakan oleh
tabel penempatan PLACEMENT_TABLE_NAME.". Jika Anda mengalami
error ini, selesaikan langkah-langkah berikut:
- Ubah aplikasi Anda untuk berhenti menyisipkan atau memperbarui baris dengan penempatan yang ingin Anda hapus.
Pilih antara:
Pindahkan baris penempatan yang ada yang menggunakan penempatan yang ingin Anda hapus ke penempatan lain dengan pernyataan DML yang dipartisi seperti berikut:
UPDATE PLACEMENT_TABLE_NAME SET LOCATION = NEW_PLACEMENT_NAME WHERE LOCATION = ORIGINAL_PLACEMENT_NAME;Hapus baris penempatan dengan pernyataan DML yang dipartisi seperti berikut:
DELETE FROM PLACEMENT_TABLE_NAME WHERE LOCATION = ORIGINAL_PLACEMENT_NAME;Pernyataan DML khusus penempatan sebelumnya hanya berfungsi dengan DML yang dipartisi. Pernyataan tersebut akan gagal sebagai pernyataan DML reguler. Untuk mengetahui informasi selengkapnya, lihat Batasan. Anda juga dapat menggunakan mutation API untuk memindahkan atau menghapus baris penempatan.
Membatalkan operasi DROP PLACEMENT
Anda dapat membatalkan operasi DROP PLACEMENT kapan saja sebelum operasi yang berjalan lama
menghapus penempatan sepenuhnya dari skema database. Untuk mengetahui detail
tentang cara mendapatkan ID operasi yang berjalan lama untuk memeriksa status, atau untuk membatalkan
operasi, lihat Mengelola dan mengamati operasi yang berjalan lama.
Membuat tabel dengan kunci penempatan
Konsol
- Di menu navigasi, klik Spanner Studio.
- Di halaman Spanner Studio, klik New tab atau gunakan tab editor kosong.
Masukkan pernyataan DDL
CREATE TABLE(GoogleSQL, PostgreSQL).Misalnya, Anda dapat membuat tabel
Singersyang menggunakan kunci penempatan untuk mempartisi data penyanyi:GoogleSQL
CREATE TABLE Singers ( SingerId INT64 NOT NULL, SingerName STRING(MAX) NOT NULL, ... Location STRING(MAX) NOT NULL PLACEMENT KEY ) PRIMARY KEY (SingerId);PostgreSQL
CREATE TABLE Singers ( SingerId bigint PRIMARY KEY, SingerName varchar(1024), ... Location varchar(1024) NOT NULL PLACEMENT KEY );
gcloud
Untuk membuat tabel, gunakan
gcloud spanner databases ddl update.
Misalnya, Anda dapat membuat tabel Singers yang menggunakan
kunci penempatan untuk mempartisi data penyanyi:
GoogleSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE TABLE Singers ( SingerId INT64 NOT NULL, SingerName STRING(MAX) NOT NULL, Location STRING(MAX) NOT NULL PLACEMENT KEY ) PRIMARY KEY (SingerId);"
PostgreSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE TABLE Singers ( SingerId bigint PRIMARY KEY, SingerName varchar(1024), Location varchar(1024) NOT NULL PLACEMENT KEY );"
Mengedit tabel dengan kunci penempatan
Anda tidak dapat menghapus kunci penempatan dari tabel. Anda juga tidak dapat menambahkan kunci penempatan ke tabel setelah tabel dibuat. Namun, Anda dapat menggunakan pernyataan DDL ALTER TABLE (GoogleSQL, PostgreSQL) untuk mengubah kolom lain dalam tabel, misalnya, dengan menambahkan dan menghapus kolom kunci non-penempatan.
Menghapus tabel dengan kunci penempatan
Sebelum menghapus tabel dengan kunci penempatan, Anda harus:
- Hapus semua baris dalam tabel penempatan.
- Tunggu hingga
version_retention_perioduntuk database selesai. Untuk informasi selengkapnya, lihat Pemulihan point-in-time. Kemudian, ikuti langkah-langkah berikut:
Konsol
- Di menu navigasi, klik Spanner Studio.
- Di halaman Spanner Studio, klik New tab atau gunakan tab editor kosong.
Masukkan pernyataan DDL
DROP TABLE(GoogleSQL, PostgreSQL).Misalnya, hapus tabel
Singers:DROP TABLE Singers;
gcloud
Untuk menghapus tabel, gunakan
gcloud spanner databases ddl update.
Misalnya, hapus tabel Singers:
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="DROP TABLE Singers"
Menyisipkan baris dalam tabel penempatan
Konsol
- Di menu navigasi, klik Spanner Studio.
- Di halaman Spanner Studio, klik New tab atau gunakan tab editor kosong.
Masukkan pernyataan DDL
INSERT INTO(GoogleSQL, PostgreSQL).Misalnya, tambahkan penyanyi, Marc Richards, ke tabel
Singersdan partisi dieuropeplacement:INSERT INTO Singers(SingerId, SingerName, Location) VALUES (1, 'Marc Richards', 'europeplacement')
gcloud
Untuk menulis data ke tabel, gunakan
gcloud spanner rows insert.
Misalnya, tambahkan penyanyi, Marc Richards, ke tabel Singers dan
partisi di europeplacement:
gcloud spanner rows insert --table=Singers --database=example-db \
--instance=test-instance --data=SingerId=1,SingerName='Marc Richards',Location='europeplacement'
Memperbarui baris dalam tabel penempatan
Konsol
- Di menu navigasi, klik Spanner Studio.
- Di halaman Spanner Studio, klik New tab atau gunakan tab editor kosong.
Gunakan DML atau mutasi untuk memperbarui data dalam tabel penempatan.
Misalnya, perbarui nama
singerid=1dalam tabelSingersmenjadiCatalina Smith:UPDATE Singers s SET s.name='Catalina Smith' WHERE s.id=1;
gcloud
Untuk memperbarui data dalam tabel penempatan,
gunakan gcloud spanner rows update.
Misalnya, perbarui nama singerid=1 dalam tabel Singers menjadi
Catalina Smith:
gcloud spanner rows update --table=Singers --database=example-db \
--instance=test-instance --data=SingerId=1,SingerName='Catalina Smith'
Memindahkan baris dalam tabel penempatan
Konsol
- Buat partisi dan penempatan instance baru jika Anda belum melakukannya.
- Di menu navigasi, klik Spanner Studio.
- Di halaman Spanner Studio, klik New tab atau gunakan tab editor kosong.
Gunakan DML atau mutasi untuk memindahkan data ke partisi instance baru.
Misalnya, pindahkan
singerid=1di tabelSingerskeasiaplacement:UPDATE Singers s SET s.location='asiaplacement' WHERE s.id=1;
gcloud
Setelah membuat partisi instance dan penempatan tempat Anda ingin memindahkan
data, gunakan gcloud spanner rows update.
Misalnya, pindahkan singerid=1 di tabel Singers ke asiaplacement:
gcloud spanner rows update --table=Singers --database=example-db \
--instance=test-instance --data=SingerId=1,Location='asiaplacement'
Menghapus baris dalam tabel penempatan
Konsol
gcloud
Untuk menghapus data, gunakan gcloud spanner rows delete.
Misalnya, hapus singerid=1 di tabel Singers:
gcloud spanner rows delete --table=Singers --database=example-db \
--instance=test-instance --keys=1
Membuat kueri data dalam tabel penempatan
Konsol
- Di menu navigasi, klik Spanner Studio.
- Di halaman Spanner Studio, klik New tab atau gunakan tab editor kosong.
Jalankan kueri Anda.
Misalnya, buat kueri tabel
Singers:SELECT * FROM Singers s WHERE s.SingerId=1;
gcloud
Untuk mengkueri data, gunakan gcloud spanner databases execute-sql.
Misalnya, buat kueri tabel Singers:
gcloud spanner databases execute-sql example-db \
--instance=test-instance \
--sql='SELECT * FROM Singers s WHERE s.SingerId=1'
Langkah berikutnya
Pelajari lebih lanjut partisi geografis.
Pelajari cara membuat dan mengelola partisi instance.