Membuat dan melakukan kueri database di konsol Google Cloud

Panduan memulai ini menunjukkan cara menggunakan konsol Google Cloud untuk membuat database di Spanner, menyisipkan data, dan menjalankan kueri SQL.

Dalam panduan memulai ini, Anda akan:

• Membuat instance Spanner.
• Membuat database.
• Membuat skema.
• Menyisipkan dan memodifikasi data.
• Menjalankan kueri.

Untuk mengetahui informasi tentang biaya penggunaan Spanner, lihat Harga.

Sebelum memulai

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Opsional: Spanner API akan diaktifkan secara otomatis. Jika belum, aktifkan secara manual:
   Mengaktifkan Spanner API

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

Membuat instance dengan konsol Google Cloud

Saat pertama kali menggunakan Spanner, Anda harus membuat instance, yaitu alokasi resource yang digunakan oleh database Spanner dalam 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 Create a provisioned instance.

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

4. Di bagian Select an edition, pilih Standard, lalu klik Continue.

5. Di bagian Name your instance, masukkan Instance name, seperti Test Instance.

   ID Instance diisi secara otomatis berdasarkan nama instance, misalnya, test-instance. Ubah jika diperlukan, lalu klik Continue.

6. Di bagian Configure your instance, untuk Choose a configuration, pertahankan opsi default Regional dan pilih lokasi konfigurasi dari menu drop-down.

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

7. Klik Lanjutkan.

8. Di bagian Configure compute capacity, untuk Select unit, pilih Processing units (PUs). Untuk Choose a scaling mode, pertahankan Manual allocation dan Quantity default dari 1000 unit pemrosesan.

9. Opsional: Di bagian Backups, hapus centang pada kotak Enable default backup schedules jika Anda tidak ingin jadwal pencadangan default dibuat untuk instance pengujian ini.

10. Klik Create.

    Konsol Google Cloud 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 Anda buat, misalnya Test Instance.

3. Di halaman Overview instance yang terbuka, klik Create database.

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

5. Pilih dialek database.

   Untuk mengetahui informasi tentang dukungan untuk PostgreSQL dan panduan untuk memilih dialek, lihat Antarmuka PostgreSQL. Biarkan bagian Define your schema (optional) kosong. Anda akan menentukan skema di Spanner Studio di bagian berikutnya dalam panduan memulai ini.

6. Klik Create.

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

Membuat skema untuk database Anda

1. Di menu navigasi, klik Spanner Studio.

2. Di halaman Spanner Studio, klik add New tab atau gunakan tab Untitled query, lalu masukkan salah satu kueri berikut,
   bergantung pada dialek database Anda:

   GoogleSQL

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

   PostgreSQL

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

3. Klik play_circle Run.

   Spanner menjalankan pernyataan. Setelah selesai, tab Results akan menampilkan Update completed.

Menyisipkan dan memodifikasi data

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

Masukkan data

1. Di panel Explorer, klik more_vert View actions untuk tabel Singers, lalu klik Insert data.

   Spanner akan membuka tab kueri baru di Spanner Studio yang berisi pernyataan INSERT template.

2. Edit klausa VALUES pernyataan INSERT template 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,
       FirstName,
       LastName,
       BirthDate)
   VALUES
     (1, -- type: INT64
       'Marc', -- type: STRING(1024)
       'Richards', -- type: STRING(1024)
       NULL -- type: DATE
       )
   THEN RETURN
     SingerId,
     FirstName,
     LastName,
     BirthDate;
   

   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,
       firstname,
       lastname,
       birthdate)
   VALUES
     (1, -- type: bigint
       'Marc', -- type: character varying
       'Richards', -- type: character varying
       NULL -- type: timestamp with time zone
       )
   RETURNING
     singerid,
     firstname,
     lastname,
     birthdate;
   

   Perhatikan bahwa PostgreSQL mengonversi nama kolom menjadi huruf kecil semua.

3. Klik play_circle Run.

   Spanner menjalankan pernyataan. Setelah selesai, tab Results akan menampilkan 1 row inserted dan data baris yang disisipkan.

4. Di panel Explorer, klik more_vert View actions untuk tabel Singers, lalu klik Insert data.

5. Edit klausa VALUES pernyataan INSERT:

   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,
       FirstName,
       LastName,
       BirthDate)
   VALUES
     (2, -- type: INT64
       'Catalina', -- type: STRING(1024)
       'Smith', -- type: STRING(1024)
       NULL -- type: DATE
       )
   THEN RETURN
     SingerId,
     FirstName,
     LastName,
     BirthDate;
   

   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,
       firstname,
       lastname,
       birthdate)
   VALUES
     (2, -- type: bigint
       'Catalina', -- type: character varying
       'Smith', -- type: character varying
       NULL -- type: timestamp with time zone
       )
   RETURNING
     singerid,
     firstname,
     lastname,
     birthdate;
   

6. Klik play_circle Run.

   Spanner menjalankan pernyataan. Setelah selesai, tab Results akan menampilkan 1 row inserted dan data baris yang disisipkan.

7. Di panel Explorer, klik more_vert View actions untuk tabel Singers, lalu klik Preview data.

8. Klik play_circle Run. Tab Results menampilkan dua baris dalam tabel Singers.

Anda juga dapat menyisipkan nilai string kosong saat memasukkan data.

1. Di panel Explorer, klik more_vert View actions untuk tabel Singers, lalu klik Insert data.

   Spanner akan membuka tab kueri baru di Spanner Studio yang berisi pernyataan INSERT template.

2. Edit klausa VALUES pernyataan INSERT template:

   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,
       FirstName,
       LastName,
       BirthDate)
   VALUES
     (3, -- type: INT64
       'Kena', -- type: STRING(1024)
       '', -- type: STRING(1024)
       NULL -- type: DATE
       )
   THEN RETURN
     SingerId,
     FirstName,
     LastName,
     BirthDate;
   

   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,
       firstname,
       lastname,
       birthdate)
   VALUES
     (3, -- type: bigint
       'Kena', -- type: character varying
       '', -- type: character varying
       NULL -- type: timestamp with time zone
       )
   RETURNING
     singerid,
     firstname,
     lastname,
     birthdate;
   

3. Klik play_circle Run.

   Spanner menjalankan pernyataan. Setelah selesai, tab Results akan menampilkan 1 row inserted dan data baris yang disisipkan.

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

4. Di panel Explorer, klik more_vert View actions untuk tabel Singers, lalu klik Preview data.

5. Klik play_circle Run. Tab Results menampilkan tiga baris dalam tabel Singers, dan baris dengan nilai kunci utama 3 memiliki string kosong di kolom LastName.

Edit data

1. Klik add New tab untuk membuat tab kueri baru, lalu masukkan pernyataan UPDATE berikut untuk memperbarui tanggal lahir baris dengan nilai kunci utama 3:

   GoogleSQL

   UPDATE
     Singers
   SET
     BirthDate='1961-04-01'
   WHERE
     SingerId=3
   THEN RETURN
     SingerId,
     FirstName,
     LastName,
     BirthDate;
   

   PostgreSQL

   UPDATE
     singers
   SET
     birthdate='1961-04-01 00:00:00 -8:00'
   WHERE
     singerid=3
   RETURNING
     singerid,
     firstname,
     lastname,
     birthdate;
   

2. Klik play_circle Run.

   Spanner menjalankan pernyataan. Setelah selesai, tab Results akan menampilkan 1 row updated dan data baris yang diperbarui.

3. Di panel Explorer, klik more_vert View actions untuk tabel Singers, lalu klik Preview data.

4. Klik play_circle Run. Tab Results menampilkan baris dalam tabel Singers, tempat baris yang diperbarui kini memiliki nilai untuk tanggal lahir.

Menghapus data

1. Klik add New tab untuk membuat tab kueri baru, lalu masukkan pernyataan DELETE berikut untuk menghapus baris dengan nilai kunci utama 2:

   GoogleSQL

   DELETE FROM Singers
   WHERE SingerId = 2;
   

   PostgreSQL

   DELETE FROM singers
   WHERE singerid = 2;
   

2. Klik play_circle Run.

   Spanner menjalankan pernyataan. Setelah selesai, tab Results akan menampilkan 1 row deleted. Tabel Singers sekarang memiliki dua baris.

Menjalankan kueri di konsol Google Cloud

1. Klik add New tab untuk membuat tab kueri baru. Kemudian, masukkan kueri berikut di editor kueri:

   GoogleSQL

   SELECT * FROM Singers;
   

   PostgreSQL

   SELECT * FROM singers;
   

2. Klik play_circle Run.

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

Selamat! Anda telah berhasil membuat database Spanner dan mengeksekusi pernyataan SQL menggunakan editor kueri.

Pembersihan

Agar tidak menimbulkan biaya tambahan pada akun Google Cloud Anda, hapus database dan instance. Menonaktifkan Cloud Billing API tidak akan menghentikan tagihan. Saat Anda menghapus instance, semua database dalam instance tersebut akan dihapus.

Menghapus database

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

   Buka instance Spanner

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

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

4. Di halaman Database details, klik delete Delete database.

5. Konfirmasi bahwa Anda ingin menghapus database dengan memasukkan nama database dan mengklik Delete.

Menghapus instance

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

   Buka instance Spanner

2. Klik nama instance yang ingin Anda hapus, misalnya, Test Instance.

3. Klik delete Delete instance.

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

Langkah berikutnya

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