Membuat dan mengelola database

Konsol

1. Di konsol Google Cloud , buka halaman Instance Cloud SQL.

   Buka Instance Cloud SQL

2. Untuk membuka halaman Ringkasan instance, klik nama instance.
3. Pilih Database dari menu navigasi SQL.
4. Klik Create database.
5. Pada dialog New database, tentukan nama database.
   
6. Klik Buat.

gcloud

Untuk informasi referensi, lihat gcloud sql databases create.

gcloud sql databases create DATABASE_NAME \ --instance=INSTANCE_NAME

Terraform

Untuk membuat database, gunakan resource Terraform .

resource "google_sql_database" "database" {   name     = "my-database"   instance = google_sql_database_instance.instance.name }

Menerapkan perubahan

Untuk menerapkan konfigurasi Terraform di project Google Cloud , selesaikan langkah-langkah di bagian berikut.

Menyiapkan Cloud Shell

1. Luncurkan Cloud Shell.

2. Tetapkan project default Google Cloud tempat Anda ingin menerapkan konfigurasi Terraform.

   Anda hanya perlu menjalankan perintah ini sekali per project, dan dapat dijalankan di direktori mana pun.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Variabel lingkungan akan diganti jika Anda menetapkan nilai eksplisit dalam file konfigurasi Terraform.

Menyiapkan direktori

Setiap file konfigurasi Terraform harus memiliki direktorinya sendiri (juga disebut modul root).

1. Di Cloud Shell, buat direktori dan file baru di dalam direktori tersebut. Nama file harus memiliki ekstensi .tf—misalnya main.tf. Dalam tutorial ini, file ini disebut sebagai main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Jika mengikuti tutorial, Anda dapat menyalin kode contoh di setiap bagian atau langkah.

   Salin kode contoh ke dalam main.tf yang baru dibuat.

   Atau, salin kode dari GitHub. Tindakan ini direkomendasikan jika cuplikan Terraform adalah bagian dari solusi menyeluruh.

3. Tinjau dan ubah contoh parameter untuk diterapkan pada lingkungan Anda.
4. Simpan perubahan Anda.
5. Lakukan inisialisasi Terraform. Anda hanya perlu melakukan ini sekali per direktori.

   terraform init

   Secara opsional, untuk menggunakan versi penyedia Google terbaru, sertakan opsi -upgrade:

   terraform init -upgrade

Menerapkan perubahan

1. Tinjau konfigurasi dan pastikan resource yang akan dibuat atau diupdate oleh Terraform sesuai yang Anda inginkan:

   terraform plan

   Koreksi konfigurasi jika diperlukan.

2. Terapkan konfigurasi Terraform dengan menjalankan perintah berikut dan memasukkan yes pada prompt:

   terraform apply

   Tunggu hingga Terraform menampilkan pesan "Apply complete!".

3. Buka Google Cloud project Anda untuk melihat hasilnya. Di konsol Google Cloud , buka resource Anda di UI untuk memastikan bahwa Terraform telah membuat atau mengupdatenya.

Menghapus perubahan

Untuk menghapus perubahan Anda, lakukan langkah-langkah berikut:

1. Untuk menonaktifkan perlindungan penghapusan, di file konfigurasi Terraform Anda, tetapkan argumen deletion_protection ke false.

   deletion_protection =  "false"

2. Terapkan konfigurasi Terraform dengan menjalankan perintah berikut dan memasukkan yes pada prompt:

   terraform apply

3. Hapus resource yang sebelumnya diterapkan dengan konfigurasi Terraform Anda dengan menjalankan perintah berikut dan memasukkan yes pada prompt:

   terraform destroy

REST v1

Permintaan berikut menggunakan metode databases:insert untuk membuat database baru pada instance yang diterapkan.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• project-id: ID project
• instance-id: ID instance
• database-name: Nama database di dalam instance Cloud SQL

Metode HTTP dan URL:

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases

Meminta isi JSON:

 {   "project": "project-id",   "instance": "instance-id",   "name": "database-name" } 

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "CREATE_DATABASE",   "name": "operation-id",   "targetId": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",   "targetProject": "project-id" } 

REST v1beta4

Permintaan berikut menggunakan metode databases:insert untuk membuat database baru pada instance yang diterapkan.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• project-id: ID project
• instance-id: ID instance
• database-name: Nama database di dalam instance Cloud SQL

Metode HTTP dan URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases

Meminta isi JSON:

 {   "project": "project-id",   "instance": "instance-id",   "name": "database-name" } 

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "CREATE_DATABASE",   "name": "operation-id",   "targetId": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",   "targetProject": "project-id" } 

Klien psql

Untuk informasi referensi, lihat CREATE DATABASE dalam dokumentasi PostgreSQL.

Lihat topik berikut dalam dokumentasi PostgreSQL untuk latar belakang dan daftar nilai himpunan karakter yang didukung:

• Dukungan Kolaborasi
• Dukungan Kumpulan Karakter

CREATE DATABASE database_name   [[ ENCODING encoding ][ LC_COLLATE lc_collate ]];

Contoh:
CREATE DATABASE "example_db" WITH OWNER "example_user" ENCODING 'UTF8' LC_COLLATE = 'pl_PL.utf8' LC_CTYPE = 'pl_PL.utf8' TEMPLATE template0;

Konsol

1. Di konsol Google Cloud , buka halaman Instance Cloud SQL.

   Buka Instance Cloud SQL

2. Untuk membuka halaman Ringkasan instance, klik nama instance.
3. Klik Database dari menu sebelah kiri. Halaman Database mencantumkan database bersama jenis kolasi, himpunan karakter, dan jenis database-nya.

gcloud

Untuk informasi referensi, lihat gcloud sql databases list.

gcloud sql databases list \ --instance=INSTANCE_NAME

REST v1

Permintaan berikut menggunakan metode databases:list untuk mencantumkan database ke sebuah instance.

Saat mencantumkan database menggunakan API, Anda akan melihat database template tambahan dan database sistem yang tidak ditampilkan oleh konsol. Anda tidak dapat menghapus atau mengelola database sistem.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• project-id: ID project
• instance-id: ID instance

Metode HTTP dan URL:

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

 {   "kind": "sql#database",   "charset": "utf8",   "collation": "utf8_general_ci",   "etag": "etag",   "name": "sys",   "instance": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases/sys",   "project": "project-id" } 

REST v1beta4

Permintaan berikut menggunakan metode databases:list untuk mencantumkan database ke sebuah instance.

Saat mencantumkan database menggunakan API, Anda akan melihat database template tambahan dan database sistem yang tidak ditampilkan oleh konsol. Anda tidak dapat menghapus atau mengelola database sistem.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• project-id: ID project
• instance-id: ID instance

Metode HTTP dan URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

 {   "kind": "sql#database",   "charset": "utf8",   "collation": "utf8_general_ci",   "etag": "etag",   "name": "sys",   "instance": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases/sys",   "project": "project-id" } 

Klien psql

Untuk informasi referensi, lihat daftar.

Saat mencantumkan database menggunakan psql klien, Anda akan melihat database template tambahan dan database sistem yang tidak ditampilkan oleh konsol. Anda tidak dapat menghapus atau mengelola database sistem.

\l

Konsol

1. Di konsol Google Cloud , buka halaman Instance Cloud SQL.

   Buka Instance Cloud SQL

2. Untuk membuka halaman Ringkasan instance, klik nama instance.
3. Klik Database dari menu sebelah kiri.
4. Dalam daftar database, temukan database yang ingin Anda hapus, lalu klik ikon tempat sampah.
5. Pada dialog Hapus database, masukkan nama database lalu klik Hapus.

gcloud

Untuk informasi referensi, lihat gcloud sql databases delete.

gcloud sql databases delete DATABASE_NAME \ --instance=INSTANCE_NAME

REST v1

Permintaan berikut menggunakan metode databases:delete untuk menghapus database yang ditentukan.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• project-id: ID project
• instance-id: ID instance
• database-name: Nama database di dalam instance Cloud SQL

Metode HTTP dan URL:

DELETE https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases/database-name

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases/database-name"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases/database-name" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "DELETE_DATABASE",   "name": "operation-id",   "targetId": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",   "targetProject": "project-id" } 

REST v1beta4

Permintaan berikut menggunakan metode databases:delete untuk menghapus database yang ditentukan.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• project-id: ID project
• instance-id: ID instance
• database-name: Nama database di dalam instance Cloud SQL

Metode HTTP dan URL:

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases/database-name

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases/database-name"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases/database-name" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "DELETE_DATABASE",   "name": "operation-id",   "targetId": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",   "targetProject": "project-id" } 

Klien psql

Untuk informasi referensi, lihat DROP DATABASE dalam dokumentasi PostgreSQL.

DROP DATABASE [database_name];