Buat dan lakukan kueri database menggunakan konsol Google Cloud

Panduan memulai ini menunjukkan cara menjalankan operasi dasar di Spanner menggunakan Konsol Google Cloud. Di panduan memulai, Anda akan:

• Membuat instance Spanner.
• Membuat database.
• Buat skema.
• Menyisipkan dan mengubah data.
• Jalankan kueri.

Untuk mengetahui informasi tentang biaya penggunaan Spanner, lihat Harga.

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

Sebelum memulai

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Make sure that billing is enabled for your Google Cloud project.

4. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

5. Make sure that billing is enabled for your Google Cloud project.

6. Opsional: Spanner API harus diaktifkan secara otomatis. Jika tidak, aktifkan secara manual:
   Mengaktifkan Spanner API

4. Untuk mendapatkan izin yang diperlukan untuk membuat instance dan database, minta administrator untuk memberi Anda peran IAM Admin Cloud Spanner (`roles/spanner.admin`) di project Anda.

Membuat instance

Saat pertama kali menggunakan Spanner, Anda harus membuat instance, yang merupakan alokasi resource yang digunakan oleh database Spanner di instance tersebut.

1. Di konsol Google Cloud, buka halaman Spanner.

   Buka Spanner

2. Pilih atau buat project Google Cloud jika Anda belum melakukannya.

3. Di halaman Spanner, klik Buat instance yang disediakan.

   Jika pernah menggunakan Spanner sebelumnya, Anda akan melihat halaman Instances Spanner, bukan halaman produk. Klik Create instance.

4. Di halaman Name your instance, masukkan nama instance, seperti Test Instance.

5. ID instance dimasukkan secara otomatis berdasarkan nama instance, misalnya, sebagai test-instance. Ubah, jika perlu. Klik Continue.

6. Di halaman Configure your instance, pertahankan opsi default Regional dan pilih konfigurasi dari menu drop-down.

   Konfigurasi instance Anda menentukan lokasi geografis tempat instance disimpan dan direplikasi.

7. Klik Lanjutkan.

8. Di halaman Alokasikan kapasitas komputasi, pilih Pemrosesan unit (PUs), dan pertahankan nilai default 1.000 unit pemrosesan.

9. Klik Create.

   Konsol Google Cloud akan menampilkan halaman Overview untuk instance yang Anda buat.

Buat database

1. Di konsol Google Cloud, buka halaman Spanner Instances.

   Buka instance Spanner

2. Klik instance yang dibuat, misalnya Test Instance.

3. Di halaman Ringkasan instance yang terbuka, klik Buat database.

4. Untuk nama database, masukkan nama, misalnya example-db.

5. Pilih dialek database.

   Untuk mengetahui informasi tentang dukungan PostgreSQL dan panduan memilih dialek, lihat Antarmuka PostgreSQL. Jika memilih GoogleSQL, Anda akan menentukan skema di kolom teks Tentukan skema Anda di bagian selanjutnya dalam panduan memulai ini.

   Halaman pembuatan database Anda sekarang terlihat seperti ini:

   

6. Klik Create.

   Konsol Google Cloud akan menampilkan halaman Overview untuk database yang Anda buat.

Membuat skema untuk database Anda

Catatan: Spanner Studio (sebelumnya berlabel Kueri di Konsol Google Cloud) mendukung operasi SQL, DML, dan DDL dalam satu editor. Untuk mengetahui informasi selengkapnya, lihat Mengelola data Anda menggunakan Konsol Google Cloud.

1. Di menu navigasi, klik Spanner Studio.

2. Di halaman Spanner Studio, klik Tab baru atau gunakan tab editor yang kosong.

3. Enter:

   GoogleSQL

   CREATE TABLE Singers (
     SingerId   INT64 NOT NULL,
     FirstName  STRING(1024),
     LastName   STRING(1024),
     SingerInfo BYTES(MAX),
     BirthDate  DATE
   ) PRIMARY KEY(SingerId);
   

   PostgreSQL

   CREATE TABLE Singers (
     BirthDate  TIMESTAMPTZ,
     SingerId   BIGINT PRIMARY KEY,
     FirstName  VARCHAR(1024),
     LastName   VARCHAR(1024),
     SingerInfo BYTEA
   );
   

4. Klik Run.

   Konsol Google Cloud kembali ke halaman Overview database dan menunjukkan bahwa Pembaruan skema sedang berlangsung. Setelah pembaruan selesai, halamannya akan terlihat seperti ini:

   GoogleSQL

   

   PostgreSQL

   

   Perhatikan bahwa PostgreSQL mengubah nama tabel menjadi huruf kecil.

Menyisipkan dan mengubah data

Konsol Google Cloud menyediakan antarmuka untuk menyisipkan, mengedit, dan menghapus data.

Masukkan data

1. Dalam daftar tabel di halaman Overview database, klik tabel Penyanyi.

   Konsol Google Cloud akan menampilkan halaman Schema pada tabel Singers.

2. Di menu navigasi, klik Data untuk menampilkan halaman Data pada tabel Penyanyi.

3. Klik Sisipkan.

   Konsol Google Cloud menampilkan halaman Spanner Studio pada tabel Singers dengan tab kueri baru yang berisi pernyataan INSERT dan SELECT yang Anda edit untuk menyisipkan baris dalam tabel Singers dan melihat hasil penyisipan tersebut:

   GoogleSQL

     -- Add new values in the VALUES clause in order of the column list.
     -- Each value must be type compatible with its associated column.
   INSERT INTO
     Singers (SingerId,
       BirthDate,
       FirstName,
       LastName,
       SingerInfo)
   VALUES
     (<SingerId>, -- type: INT64
       <BirthDate>, -- type: DATE
       <FirstName>, -- type: STRING(1024)
       <LastName>, -- type: STRING(1024)
       <SingerInfo> -- type: BYTES(MAX)
       );
     -- Change values in the WHERE condition to match the inserted row.
   SELECT
     *
   FROM
     Singers
   WHERE
     SingerId=<SingerId>;
   

   PostgreSQL

     -- Add new values in the VALUES clause in order of the column list.
     -- Each value must be type compatible with its associated column.
   INSERT INTO
     singers (singerid,
       birthdate,
       firstname,
       lastname,
       singerinfo)
   VALUES
     (<singerid>, -- type: bigint
       <birthdate>, -- type: timestamp with time zone
       <firstname>, -- type: character varying
       <lastname>, -- type: character varying
       <singerinfo> -- type: bytea
       );
     -- Change values in the WHERE condition to match the inserted row.
   SELECT
     *
   FROM
     singers
   WHERE
     singerid=<singerid>;
   

   Perhatikan bahwa PostgreSQL mengonversi nama kolom menjadi semua huruf kecil.

4. Edit klausa VALUES pernyataan INSERT dan klausa WHERE pernyataan SELECT:

   GoogleSQL

     -- Add new values in the VALUES clause in order of the column list.
     -- Each value must be type compatible with its associated column.
   INSERT INTO
     Singers (SingerId,
       BirthDate,
       FirstName,
       LastName,
       SingerInfo)
   VALUES
     (1, -- type: INT64
       NULL, -- type: DATE
       'Marc', -- type: STRING(1024)
       'Richards', -- type: STRING(1024)
       NULL -- type: BYTES(MAX)
       );
     -- Change values in the WHERE condition to match the inserted row.
   SELECT
     *
   FROM
     Singers
   WHERE
     SingerId=1;
   

   PostgreSQL

     -- Add new values in the VALUES clause in order of the column list.
     -- Each value must be type compatible with its associated column.
   INSERT INTO
     singers (singerid,
       birthdate,
       firstname,
       lastname,
       singerinfo)
   VALUES
     (1, -- type: bigint
       NULL, -- type: timestamp with time zone
       'Marc', -- type: character varying
       'Richards', -- type: character varying
       NULL -- type: bytea
       );
     -- Change values in the WHERE condition to match the inserted row.
   SELECT
     *
   FROM
     singers
   WHERE
     singerid=1;
   

5. Klik Run.

   Spanner menjalankan pernyataan. Setelah selesai, tab Results menunjukkan bahwa pernyataan pertama menyisipkan satu baris, dan menyediakan link untuk melihat data tabel.

6. Di tab Hasil, klik link tabel. Tabel Singers sekarang memiliki satu baris:

   GoogleSQL

   

   PostgreSQL

   

7. Klik Sisipkan untuk menambahkan baris lain.

   Konsol Google Cloud menampilkan kembali halaman Spanner Studio pada tabel Singers dengan tab kueri baru yang berisi pernyataan INSERT dan SELECT yang sama.

8. Edit klausa VALUES pernyataan INSERT dan klausa WHERE pernyataan SELECT:

   GoogleSQL

     -- Add new values in the VALUES clause in order of the column list.
     -- Each value must be type compatible with its associated column.
   INSERT INTO
     Singers (SingerId,
       BirthDate,
       FirstName,
       LastName,
       SingerInfo)
   VALUES
     (2, -- type: INT64
       NULL, -- type: DATE
       'Catalina', -- type: STRING(1024)
       'Smith', -- type: STRING(1024)
       NULL -- type: BYTES(MAX)
       );
     -- Change values in the WHERE condition to match the inserted row.
   SELECT
     *
   FROM
     Singers
   WHERE
     SingerId=2;
   

   PostgreSQL

     -- Add new values in the VALUES clause in order of the column list.
     -- Each value must be type compatible with its associated column.
   INSERT INTO
     singers (singerid,
       birthdate,
       firstname,
       lastname,
       singerinfo)
   VALUES
     (2, -- type: bigint
       NULL, -- type: timestamp with time zone
       'Catalina', -- type: character varying
       'Smith', -- type: character varying
       NULL -- type: bytea
       );
     -- Change values in the WHERE condition to match the inserted row.
   SELECT
     *
   FROM
     singers
   WHERE
     singerid=2;
   

9. Klik Run.

   Setelah Spanner menjalankan pernyataan, tab Results sekali lagi menunjukkan bahwa pernyataan pertama menyisipkan satu baris.

10. Klik link tabel. Tabel Singers sekarang memiliki dua baris:

    GoogleSQL

    

    PostgreSQL

    

Anda juga dapat menyisipkan nilai string kosong saat memasukkan data.

1. Klik Sisipkan untuk menambahkan baris.

   Spanner kembali menampilkan halaman Spanner Studio di tabel Singers dengan tab kueri baru yang berisi pernyataan INSERT dan SELECT yang sama.

2. Edit klausa VALUES pernyataan INSERT template dan klausa WHERE pernyataan SELECT:

   GoogleSQL

     -- Add new values in the VALUES clause in order of the column list.
     -- Each value must be type compatible with its associated column.
   INSERT INTO
     Singers (SingerId,
       BirthDate,
       FirstName,
       LastName,
       SingerInfo)
   VALUES
     (3, -- type: INT64
       NULL, -- type: DATE
       'Kena', -- type: STRING(1024)
       '', -- type: STRING(1024)
       NULL -- type: BYTES(MAX)
       );
     -- Change values in the WHERE condition to match the inserted row.
   SELECT
     *
   FROM
     Singers
   WHERE
     SingerId=3;
   

   PostgreSQL

     -- Add new values in the VALUES clause in order of the column list.
     -- Each value must be type compatible with its associated column.
   INSERT INTO
     singers (singerid,
       birthdate,
       firstname,
       lastname,
       singerinfo)
   VALUES
     (3, -- type: bigint
       NULL, -- type: timestamp with time zone
       'Kena', -- type: character varying
       '', -- type: character varying
       NULL -- type: bytea
       );
     -- Change values in the WHERE condition to match the inserted row.
   SELECT
     *
   FROM
     singers
   WHERE
     singerid=3;
   

   Perhatikan bahwa nilai yang diberikan untuk kolom nama belakang adalah string kosong, '', bukan nilai NULL.

3. Klik Run.

   Setelah Spanner menjalankan pernyataan, tab Results menunjukkan bahwa pernyataan pertama menyisipkan satu baris.

4. Klik link tabel. Tabel Singers kini memiliki tiga baris, dan baris dengan nilai kunci utama 3 memiliki string kosong di kolom LastName:

   GoogleSQL

   

   PostgreSQL

   

Mengedit data

1. Di halaman Data pada tabel Penyanyi, centang kotak di baris dengan nilai kunci utama 3, lalu klik Edit.

   Spanner menampilkan halaman Spanner Studio dengan tab baru yang berisi pernyataan UPDATE dan SET template yang dapat Anda edit. Perhatikan bahwa klausa WHERE dari kedua pernyataan menunjukkan bahwa baris yang akan diperbarui adalah baris dengan nilai kunci utama 3.

   GoogleSQL

     -- Change values in the SET clause to update the row where the WHERE condition is true.
   UPDATE
     Singers
   SET
     BirthDate='',
     FirstName='Kena',
     LastName='',
     SingerInfo=''
   WHERE
     SingerId=3;
   SELECT
     *
   FROM
     Singers
   WHERE
     SingerId=3;
   

   PostgreSQL

     -- Change values in the SET clause to update the row where the WHERE condition is true.
   UPDATE
     singers
   SET
     birthdate=NULL,
     firstname='Kena',
     lastname='',
     singerinfo=NULL
   WHERE
     singerid='3';
   SELECT
     *
   FROM
     singers
   WHERE
     singerid='3';
   

2. Edit klausa SET pernyataan UPDATE untuk memperbarui tanggal lahir saja:

   GoogleSQL

     -- Change values in the SET clause to update the row where the WHERE condition is true.
   UPDATE
     Singers
   SET
     BirthDate='1961-04-01'
   WHERE
     SingerId=3;
   SELECT
     *
   FROM
     Singers
   WHERE
     SingerId=3;
   

   PostgreSQL

     -- Change values in the SET clause to update the row where the WHERE condition is true.
   UPDATE
     singers
   SET
     birthdate='1961-04-01 00:00:00 -8:00'
   WHERE
     singerid='3';
   SELECT
     *
   FROM
     singers
   WHERE
     singerid='3';
   

3. Klik Run.

   Spanner menjalankan pernyataan. Setelah selesai, tab Results menunjukkan bahwa pernyataan pertama memperbarui satu baris, dan menyediakan link untuk melihat data tabel.

4. Di tab Hasil, klik link tabel.

   Baris yang diperbarui sekarang memiliki nilai untuk tanggal lahir.

   GoogleSQL

   

   PostgreSQL

   

Menghapus data

1. Di halaman Data pada tabel Penyanyi, centang kotak di baris dengan 2 di kolom pertama, lalu klik Delete.

2. Pada dialog yang muncul, klik Konfirmasi.

   Tabel Singers sekarang memiliki dua baris:

   GoogleSQL

   

   PostgreSQL

   

Menjalankan kueri

1. Di halaman Overview database, klik Spanner Studio di menu navigasi.

2. Klik Tab baru untuk membuat tab kueri baru. Kemudian, masukkan kueri berikut di editor kueri:

   GoogleSQL

   SELECT * FROM Singers;
   

   PostgreSQL

   SELECT * FROM singers;
   

3. Klik Run.

   Spanner menjalankan kueri. Setelah selesai, tab Results akan menampilkan hasil kueri Anda:

   GoogleSQL

   

   PostgreSQL

   

Selamat! Anda telah berhasil membuat {i>database<i} Spanner dan mengeksekusi pernyataan SQL dengan menggunakan editor kueri.

Pembersihan

Untuk menghindari biaya tambahan pada akun Penagihan Cloud Anda, hapus database dan instance yang Anda buat. Jika sebuah instance dihapus, semua database yang dibuat dalam instance tersebut akan otomatis dihapus.

Menghapus database

1. Di konsol Google Cloud, buka halaman Spanner Instances.

   Buka instance Spanner

2. Klik nama instance yang memiliki database yang ingin dihapus, misalnya, Test Instance.

3. Klik nama database yang ingin dihapus, misalnya, example-db.

4. Di halaman Database details, klik Delete database.

5. Konfirmasikan bahwa Anda ingin menghapus database tersebut dengan memasukkan nama database, lalu mengklik Delete.

Menghapus instance

1. Di konsol Google Cloud, buka halaman Spanner Instances.

   Buka instance Spanner

2. Klik nama instance yang ingin dihapus, misalnya, Test Instance.

3. Klik Hapus instance.

4. Konfirmasi bahwa Anda ingin menghapus instance dengan memasukkan nama instance dan mengklik Hapus.

Langkah selanjutnya

• Pelajari Instance.
• Memahami Model Skema dan Data Spanner.
• Pelajari Data Definition Language (DDL) GoogleSQL lebih lanjut.
• Pelajari Paket Eksekusi Kueri lebih lanjut.
• Pelajari cara menggunakan Spanner dengan C++, C#, Go, Java, Node.js, PHP, Python, Ruby, REST, atau gcloud.