Membuat dan membuat kueri database menggunakan Google Cloud CLI

Tujuan

Tutorial ini akan memandu Anda melalui langkah-langkah berikut menggunakan gcloud CLI:

• Membuat instance, database, dan skema Spanner
• Menulis data ke database dan menjalankan kueri SQL untuk data tersebut
• Membersihkan dengan menghapus database dan instance

Prosedur di halaman ini berlaku untuk database dialek GoogleSQL dan database dialek PostgreSQL.

Untuk referensi gcloud Spanner lengkap, lihat gcloud.

Catatan: Untuk menjelajahi Spanner menggunakan instance uji coba gratis selama 90 hari, lihat Membuat instance uji coba gratis Spanner.

Harga

Tutorial ini menggunakan Spanner, yang merupakan komponenGoogle Cloudyang dapat ditagih. Untuk mengetahui informasi tentang biaya penggunaan Spanner, lihat Harga.

Sebelum memulai

Selesaikan langkah-langkah yang dijelaskan di Menginstal gcloud CLI dan menyiapkan Cloud Spanner API, yang mencakup pembuatan dan penetapan project Google Cloud default, mengaktifkan penagihan, mengaktifkan Cloud Spanner API, dan menyiapkan OAuth 2.0 untuk mendapatkan kredensial autentikasi guna menggunakan Cloud Spanner API.

Secara khusus, pastikan Anda menjalankan gcloud auth application-default login untuk menyiapkan lingkungan pengembangan lokal dengan kredensial autentikasi.

Menetapkan project default

Jika Anda belum melakukannya, tetapkan project ID Google Cloud sebagai project default untuk Google Cloud CLI:

gcloud config set project PROJECT_ID

Jika tidak menetapkan project default, Anda harus meneruskan --project PROJECT_ID ke setiap perintah di bawah sebagai argumen pertama ke gcloud. Contoh:

gcloud --project=PROJECT_ID instance-configs list

Instance

Saat pertama kali menggunakan Spanner, Anda harus membuat instance, yang merupakan alokasi resource yang digunakan oleh database Spanner. Saat membuat instance, Anda memilih tempat data disimpan dan jumlah kapasitas komputasi yang dimiliki instance.

Instance dan konfigurasi instance

Untuk membuat instance, Anda harus memilih konfigurasi instance, yang seperti blueprint untuk instance yang menentukan penempatan geografis dan replikasi data Spanner Anda.

Membuat daftar konfigurasi instance

Saat membuat instance, Anda menentukan konfigurasi instance, yang menentukan penempatan geografis dan replikasi database Anda dalam instance tersebut. Anda dapat memilih konfigurasi regional, yang menyimpan data di satu region, dual-region, yang menyimpan data di dua region di negara yang sama, atau konfigurasi multi-region, yang mendistribusikan data di beberapa region. Untuk mengetahui informasi selengkapnya, lihat Ringkasan instance.

Untuk melihat kumpulan konfigurasi instance yang tersedia untuk project Anda:

gcloud instance-configs list

Anda akan melihat daftar konfigurasi regional, dual-region, dan multi-region.

Membuat instance

Untuk membuat instance bernama test-instance dengan nama tampilan My Instance menggunakan konfigurasi instance regional regional-us-central1 dengan 1 node:

gcloud instances create test-instance --config=regional-us-central1 \
    --description="My Instance" --nodes=1

Pada perintah di atas, nama instance ditetapkan ke test-instance dan --description menetapkan nama tampilan instance. Kedua nilai ini harus unik dalam project Google Cloud Platform.

Catatan: Gunakan ID instance, bukan nama tampilan, saat merujuk ke instance dalam perintah gcloud.

Menetapkan instance default

Anda dapat menetapkan instance default yang digunakan Spanner jika belum menentukan instance dalam perintah. Untuk menetapkan instance default:

gcloud config set spanner/instance test-instance

Buat database

Buat database bernama example-db. Dialek database secara default adalah GoogleSQL.

GoogleSQL

gcloud databases create example-db

PostgreSQL

gcloud databases create example-db --database-dialect=POSTGRESQL

Memperbarui skema

Gunakan Data Definition Language (DDL) Spanner untuk membuat, mengubah, atau menghapus tabel, serta membuat atau menghapus indeks.

Mari kita buat dua tabel:

GoogleSQL

gcloud databases ddl update example-db \
--ddl='CREATE TABLE Singers ( SingerId INT64 NOT NULL, FirstName STRING(1024), LastName STRING(1024), SingerInfo BYTES(MAX) ) PRIMARY KEY (SingerId)'

gcloud databases ddl update example-db \
--ddl='CREATE TABLE Albums ( SingerId INT64 NOT NULL, AlbumId INT64 NOT NULL, AlbumTitle STRING(MAX)) PRIMARY KEY (SingerId, AlbumId), INTERLEAVE IN PARENT Singers ON DELETE CASCADE'

PostgreSQL

gcloud databases ddl update example-db \
--ddl='CREATE TABLE Singers ( SingerId bigint NOT NULL, FirstName varchar(1024), LastName varchar(1024), SingerInfo bytea, PRIMARY KEY (SingerId) )'

gcloud databases ddl update example-db \
--ddl='CREATE TABLE Albums ( SingerId bigint NOT NULL, AlbumId bigint NOT NULL, AlbumTitle varchar, PRIMARY KEY (SingerId, AlbumId) ) INTERLEAVE IN PARENT Singers ON DELETE CASCADE'

Untuk memeriksa progres operasi, gunakan gcloud operations describe. Perintah ini memerlukan ID operasi.

Mendapatkan ID operasi:

gcloud operations list --instance="test-instance" \
--database=DATABASE-NAME --type=DATABASE_UPDATE_DDL

Ganti DATABASE-NAME dengan nama database.

Jalankan gcloud operations describe:

gcloud operations describe \
  --instance="test-instance" \
  --database="example-db" \
  projects/PROJECT-NAME/instances/test-instance/databases/example-db/operations/OPERATION-ID

Ganti kode berikut:

• PROJECT-NAME: Nama project.
• OPERATION-ID: ID operasi dari operasi yang ingin Anda periksa.

Outputnya terlihat mirip dengan yang berikut ini:

done: true
metadata:
...
progress:
- endTime: '2022-03-01T00:28:06.691403Z'
  progressPercent: 100
  startTime: '2022-03-01T00:28:04.221401Z'
- endTime: '2022-03-01T00:28:17.624588Z'
  startTime: '2022-03-01T00:28:06.691403Z'
  progressPercent: 100
...

Menulis data

Mari kita tambahkan beberapa contoh data ke database

GoogleSQL

gcloud rows insert --database=example-db \
  --table=Singers \
  --data=SingerId=1,FirstName=Marc,LastName=Richards

gcloud rows insert --database=example-db \
  --table=Singers \
  --data=SingerId=2,FirstName=Catalina,LastName=Smith

gcloud rows insert --database=example-db \
  --table=Singers \
  --data=SingerId=3,FirstName=Alice,LastName=Trentor

gcloud rows insert --database=example-db \
  --table=Albums \
  --data=SingerId=1,AlbumId=1,AlbumTitle="Total Junk"

gcloud rows insert --database=example-db \
  --table=Albums \
  --data=SingerId=2,AlbumId=1,AlbumTitle="Green"

gcloud rows insert --database=example-db \
  --table=Albums \
  --data=^:^SingerId=2:AlbumId=2:AlbumTitle="Go, Go, Go"

Secara default, koma digunakan untuk memisahkan item dalam daftar. Dalam perintah penyisipan terakhir, kita menentukan titik dua (^:^) sebagai pemisah sehingga kita dapat menggunakan koma dalam judul album.

PostgreSQL

Catatan: Ada masalah umum saat gcloud CLI tidak dapat mencari nama tabel saat menggunakan mutasi untuk menulis data ke database PostgreSQL. Oleh karena itu, Anda harus menggunakan DML untuk menyisipkan data.

gcloud databases execute-sql example-db \
  --sql="INSERT INTO Singers (SingerId, FirstName, LastName) VALUES (1, 'Marc', 'Richards')"

gcloud databases execute-sql example-db \
  --sql="INSERT INTO Singers (SingerId, FirstName, LastName) VALUES (2, 'Catalina', 'Smith')"

gcloud databases execute-sql example-db   \
  --sql="INSERT INTO Singers (SingerId, FirstName, LastName) VALUES (3, 'Alice', 'Trentor')"

gcloud databases execute-sql example-db   \
  --sql="INSERT INTO Albums (SingerId, AlbumId, AlbumTitle) VALUES (1, 1, 'Total Junk')"

gcloud databases execute-sql example-db   \
  --sql="INSERT INTO Albums (SingerId, AlbumId, AlbumTitle) VALUES (2, 1, 'Green')"

gcloud databases execute-sql example-db   \
  --sql="INSERT INTO Albums (SingerId, AlbumId, AlbumTitle) VALUES (2, 2, 'Go, Go, Go')"

Membuat kueri data menggunakan SQL

Jalankan kueri di command line:

gcloud databases execute-sql example-db \
    --sql='SELECT SingerId, AlbumId, AlbumTitle FROM Albums'

Untuk referensi SQL Spanner, lihat Sintaksis kueri untuk GoogleSQL atau Sintaksis kueri untuk PostgreSQL.

Untuk melihat daftar flag yang dapat Anda gunakan dengan perintah execute-sql, lihat gcloud databases execute-sql.

Pembersihan

Agar tidak menimbulkan biaya tambahan pada akun Google Cloud Anda untuk resource yang digunakan dalam tutorial ini, hapus database dan hapus instance yang Anda buat.

Menghapus database

Untuk menghapus instance yang ada:

gcloud databases delete example-db

Menghapus instance

Untuk menghapus instance yang ada:

gcloud instances delete test-instance

Perhatikan bahwa menghapus instance juga akan menghapus semua database dalam instance tersebut. Penghapusan instance tidak dapat dibatalkan.