Halaman ini diterjemahkan oleh Cloud Translation API.

Membuat dan mengelola database

MySQL | PostgreSQL | SQL Server

Halaman ini berisi informasi tentang cara membuat, mencantumkan, dan menghapus database MySQL pada instance Cloud SQL.

Instance yang baru dibuat memiliki empat database sistem:

information_schema: Menyediakan akses ke metadata database, informasi tentang server MySQL.
mysql: Skema sistem. Objek ini berisi tabel yang menyimpan informasi yang diperlukan oleh server MySQL saat dijalankan.
performance_schema: Fitur untuk memantau eksekusi MySQL Server di level rendah.
sys: Berisi kumpulan objek yang membantu DBA dan developer menafsirkan data yang dikumpulkan oleh skema performa.

Untuk mengetahui informasi selengkapnya tentang database MySQL, baca dokumentasi MySQL.

Sebelum memulai

Sebelum menyelesaikan tugas di halaman ini, Anda harus sudah:

Membuat instance Cloud SQL. Untuk mengetahui informasi selengkapnya, lihat Membuat instance.

Jika berencana menggunakan klien mysql untuk membuat atau mengelola database, Anda harus sudah:

Mengonfigurasi akses dan terhubung ke instance dengan klien mysql. Untuk mengetahui informasi selengkapnya tentang opsi koneksi, baca Opsi Koneksi untuk Aplikasi Eksternal.

Membuat database pada instance Cloud SQL

Catatan: Panjang maksimum nama database adalah 64 karakter. Untuk informasi selengkapnya tentang kriteria lain untuk nama ini, lihat Nama Objek Skema.

Jika Anda tidak menentukan himpunan karakter dan kolasi kustom saat membuat database, database tersebut akan memiliki nilai default berikut:

MySQL 5.6, 5.7: (dibuat dengan konsol Google Cloud, Cloud SQL Admin API, gcloud CLI, Terraform, atau klien MySQL)

Himpunan karakter: utf8
Kolasi: utf8_general_ci

MySQL 8.0.x dan yang lebih baru (dibuat dengan konsol Google Cloud)

Himpunan karakter: utf8
Kolasi: utf8_general_ci

MySQL 8.0.x dan yang lebih baru (dibuat dengan Cloud SQL Admin API, gcloud CLI, Terraform, atau klien MySQL)

Himpunan karakter: utf8mb4
Kolasi: utf8mb4_0900_ai_ci

Jika Anda perlu mengubah konfigurasi himpunan karakter atau kolasi database setelah pembuatan, lihat Memperbarui himpunan karakter dan kolasi untuk database.

Konsol

Di konsol Google Cloud, buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Untuk membuka halaman Ringkasan instance, klik nama instance.
Pilih Database dari menu navigasi SQL.
Klik Buat database.
Pada dialog Buat database, tentukan nama database, serta himpunan karakter dan kolasi (opsional).
Untuk informasi selengkapnya tentang himpunan karakter dan kolase, lihat Himpunan Karakter, Kolasi, Unicode.
Klik Buat.

gcloud

Untuk informasi referensi, lihat gcloud sql databases create.

Untuk informasi selengkapnya tentang himpunan karakter dan kolase, lihat Himpunan Karakter, Kolasi, Unicode.

gcloud sql databases create DATABASE_NAME \
--instance=INSTANCE_NAME \
[--charset=CHARSET] \
[--collation=COLLATION]

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

Luncurkan Cloud Shell.
Tetapkan project Google Cloud default 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).

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
```
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.
Tinjau dan ubah contoh parameter untuk diterapkan pada lingkungan Anda.
Simpan perubahan Anda.
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

Tinjau konfigurasi dan pastikan resource yang akan dibuat atau diupdate oleh Terraform sesuai yang Anda inginkan:
```
terraform plan
```
Koreksi konfigurasi jika diperlukan.
Terapkan konfigurasi Terraform dengan menjalankan perintah berikut dan memasukkan yes pada prompt:
```
terraform apply
```
Tunggu hingga Terraform menampilkan pesan "Apply complete!".
Buka project Google Cloud 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:

Untuk menonaktifkan perlindungan penghapusan, di file konfigurasi Terraform Anda, tetapkan argumen deletion_protection ke false.
```
deletion_protection =  "false"
```
Terapkan konfigurasi Terraform dengan menjalankan perintah berikut dan memasukkan yes pada prompt:
```
terraform apply
```

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 (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah 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"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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:

Tanggapan

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "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 (Linux, macOS, atau Cloud Shell)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah 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"

PowerShell (Windows)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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:

Respons

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "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 mysql

Untuk referensi selengkapnya, lihat CREATE DATABASE dalam dokumentasi PostgreSQL.

Untuk informasi selengkapnya tentang himpunan karakter dan kolase, lihat Himpunan Karakter, Kolasi, Unicode.

CREATE DATABASE database_name
  [[CHARACTER SET charset_name][COLLATE collation_name]];

Mencantumkan database Anda

Untuk mencantumkan semua database di instance:

Konsol

Di konsol Google Cloud, buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Untuk membuka halaman Ringkasan instance, klik nama instance.
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 (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

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

PowerShell (Windows)

Jalankan perintah berikut:

$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:

Tanggapan

{
  "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.

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 (Linux, macOS, atau Cloud Shell)

Jalankan perintah 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"

PowerShell (Windows)

Jalankan perintah berikut:

$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:

Respons

{
  "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 mysql

Untuk informasi referensi, lihat SHOW DATABASES dalam dokumentasi MySQL.

SHOW DATABASES;

Menghapus database

Untuk menghapus database di instance Cloud SQL:

Konsol

Di konsol Google Cloud, buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Untuk membuka halaman Ringkasan instance, klik nama instance.
Klik Database dari menu sebelah kiri.
Dalam daftar database, temukan database yang ingin Anda hapus, lalu klik ikon tempat sampah.
Di dialog Hapus database, masukkan nama database, lalu klik Hapus.

Catatan: Menghapus database akan menghapus semua file dalam direktori database, termasuk semua file yang tidak digunakan secara langsung oleh database. Contoh file tersebut adalah file #sql-* yang dibuat dari operasi ALTER TABLE yang dihentikan di MySQL 5.6 dan MySQL 5.7.

gcloud

Untuk informasi referensi, lihat gcloud sql databases delete.

gcloud sql databases delete DATABASE_NAME \
--instance=INSTANCE_NAME

Catatan: Menghapus database akan menghapus semua file dalam direktori database, termasuk file yang tidak digunakan langsung oleh database. Contoh file tersebut adalah file #sql-* yang dibuat dari operasi ALTER TABLE yang dihentikan di MySQL 5.6 dan MySQL 5.7.

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 (Linux, macOS, atau Cloud Shell)

Jalankan perintah 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"

PowerShell (Windows)

Jalankan perintah berikut:

$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:

Tanggapan

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "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 (Linux, macOS, atau Cloud Shell)

Jalankan perintah 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"

PowerShell (Windows)

Jalankan perintah berikut:

$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:

Respons

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "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 mysql

Untuk referensi selengkapnya, baca DROP DATABASE dalam dokumentasi MySQL.

DROP DATABASE [database_name];

Catatan: Jika direktori database berisi file yang tidak langsung digunakan oleh database, perintah DROP DATABASE akan menghasilkan error yang menunjukkan bahwa direktori database tersebut tidak dapat dihapus, seperti:

Terjadi error saat meletakkan database (tidak dapat rmdir './database_name', errno: 39)
Terjadi error saat meletakkan database (tidak dapat rmdir './database_name', errno: 17)

Contoh file tersebut adalah file #sql-* yang dibuat dari operasi ALTER TABLE yang dihentikan di MySQL 5.6 dan MySQL 5.7. Untuk menghapus file ini dan menyelesaikan operasi DROP DATABASE, ulangi operasi ini menggunakan salah satu dari metode lainnya: konsol, perintah gcloud, atau panggilan REST API.

Langkah berikutnya

Mengelola pengguna untuk instance Anda.
Mengimpor data ke instance Anda.
Pelajari opsi untuk terhubung ke instance Anda menggunakan klien mysql.
Membuat tabel database.
Prosedur tersimpan Cloud SQL untuk MySQL.

Coba sendiri

JIka Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi perfoma Cloud SQL dalam skenario di dunia nyata. Pelanggan baru mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

Coba Cloud SQL gratis