Mengekspor dan mengimpor menggunakan file dump SQL

MySQL   |  PostgreSQL   |  SQL Server

Halaman ini menjelaskan cara mengekspor dan mengimpor data ke instance Cloud SQL menggunakan file dump SQL.

Catatan: Jika Anda memigrasikan seluruh database dari server database yang didukung (lokal, di AWS, atau Cloud SQL) ke instance Cloud SQL baru, Anda dapat menggunakan Database Migration Service daripada mengekspor lalu mengimpor file. Jika Anda mengekspor untuk membuat instance baru dari file yang diekspor, pertimbangkan untuk memulihkan dari cadangan ke instance lain atau meng-clone instance.

Anda dapat membatalkan impor data ke instance Cloud SQL dan ekspor data dari instance. Data ini terdapat dalam file dump SQL. Untuk mengetahui informasi selengkapnya tentang cara membatalkan operasi impor atau ekspor, lihat Membatalkan impor dan ekspor data.

Sebelum memulai

Penting: Sebelum memulai ekspor besar, pastikan minimal 25 persen ukuran database kosong (pada instance). Cara ini membantu mencegah masalah dengan pertumbuhan otomatis yang agresif,hal ini dapat memengaruhi ketersediaan instance.

Ekspor menggunakan resource database, tetapi tidak mengganggu operasi database normal, kecuali jika penyediaan instance kurang lengkap.

Untuk praktik terbaik, lihat Praktik Terbaik untuk Mengimpor dan Mengekspor Data.

Setelah menyelesaikan operasi impor, memverifikasi hasilnya.

Catatan: MySQL 8.0 untuk Cloud SQL menggunakanmysql_native_password sebagai plugin autentikasi default untuk pengguna baru, bukan caching_sha2_password. Namun, pengguna yang diimpor dari instance eksternal mungkin dikonfigurasi untuk menggunakan plugin caching_sha2_password untuk autentikasi. Hal ini dapat menimbulkan masalah saat menghubungkan. Untuk mengetahui informasi selengkapnya, lihat Autentikasi MySQL 8.

Mengekspor data dari Cloud SQL untuk MySQL

Peran dan izin yang diperlukan untuk mengekspor dari Cloud SQL untuk MySQL

Untuk mengekspor data dari Cloud SQL ke Cloud Storage, pengguna yang memulai ekspor harus memiliki salah satu peran berikut:

• Peran Cloud SQL Editor
• Peran khusus, yang mencakup izin berikut:
  • cloudsql.instances.get
  • cloudsql.instances.export

Selain itu, akun layanan untuk instance Cloud SQL harus memiliki salah satu peran berikut:

• Peran Identity and Access Management (IAM) storage.objectAdmin
• Peran khusus, termasuk izin berikut:
  • storage.objects.create
  • storage.objects.list (hanya untuk mengekspor file secara paralel)
  • storage.objects.delete (hanya untuk mengekspor file secara paralel)

Untuk mendapatkan bantuan terkait peran IAM, lihat Identity and Access Management.

Catatan: Perubahan yang Anda buat pada izin dan peran IAM mungkin memerlukan waktu beberapa menit untuk diterapkan. Untuk mengetahui informasi selengkapnya, lihat Penerapan perubahan akses.

Mengekspor ke file dump SQL dari Cloud SQL untuk MySQL

Untuk membuat file dump SQL, Anda harus mengekspor data dari Cloud SQL ke Cloud Storage. Setelah file berada di Cloud Storage, Anda dapat mengimpornya ke database Cloud SQL lainnya. Anda juga dapat mendownload data dari Cloud Storage ke lingkungan lokal Anda jika ingin mengaksesnya secara lokal.

Mengekspor dari Cloud SQL menggunakan aplikasi utilitas mysqldump dengan opsi --single-transaction dan --hex-blob. Dengan opsi --single-transaction, mysqldump memulai transaksi sebelum berjalan. Daripada mengunci seluruh database, tindakan ini memungkinkan mysqldump membaca database dalam kondisi saat ini, untuk memberikan dump data yang konsisten.

Jika file dump SQL Anda berisi klausa DEFINER (tampilan, pemicu, stored_procedures, dan sebagainya), yang bergantung pada urutan eksekusi pernyataan tersebut, penggunaan file ini untuk impor dapat gagal. Mempelajari lebih lanjut penggunaan DEFINER dan kemungkinan solusi di Cloud SQL.

Catatan: Jika data Anda berisi objek besar (blob), proses ekspor dapat menghabiskan memori dalam jumlah besar, yang memengaruhi performa instance. Untuk mendapatkan bantuan, baca Masalah Umum.

Untuk mengekspor data dari database pada instance Cloud SQL ke file dump SQL di bucket Cloud Storage:

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 Export.
4. Di bagian Format file, klik SQL untuk membuat file dump SQL.
5. Di bagian Data yang akan diekspor, klik Satu atau beberapa database dalam instance ini untuk mengekspor database tertentu.
6. Menggunakan menu drop-down untuk memilih database yang ingin Anda ekspor.
7. Di bagian Tujuan, pilih Browse untuk menelusuri bucket Cloud Storage atau folder untuk ekspor Anda.
8. Klik Ekspor untuk memulai ekspor.

gcloud

1. Membuat bucket Cloud Storage.
2. Temukan akun layanan untuk instance Cloud SQL tempat Anda melakukan ekspor. Anda dapat melakukannya dengan menjalankan perintah gcloud sql instances describe. Cari kolom serviceAccountEmailAddress di output.

   gcloud sql instances describe INSTANCE_NAME
     

3. Gunakan gcloud storage buckets add-iam-policy-binding untuk memberikan peran IAM storage.objectAdmin ke akun layanan. Untuk mendapatkan bantuan terkait penetapan izin IAM, lihat Menggunakan izin IAM.
4. Ekspor database ke bucket Cloud Storage:
   Catatan: Jika Anda ingin menggunakan ekspor serverless, gunakan parameter offload. Jika tidak, hapus dari perintah berikut.

   gcloud sql export sql INSTANCE_NAME gs://BUCKET_NAME/sqldumpfile.gz \
   --database=DATABASE_NAME \
   --offload
     

   Perintah export sql tidak berisi pemicu atau prosedur tersimpan, tetapi berisi tampilan. Untuk mengekspor pemicu dan/atau prosedur tersimpan, gunakan alat mysqldump.

   Untuk mengetahui informasi selengkapnya tentang penggunaan perintah export sql, lihat sql export sql halaman referensi perintah.

5. Jika Anda tidak perlu mempertahankan peran IAM yang telah ditetapkan sebelumnya, cabut sekarang.

REST v1

1. Buat bucket untuk ekspor:

   gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME

   Langkah ini tidak wajib, tetapi sangat direkomendasikan, agar Anda tidak membuka akses ke data lain.

2. Berikan legacyBucketWriter pada instance Anda peran IAM untuk bucket Anda. Untuk mendapatkan bantuan terkait penetapan izin IAM, lihat Menggunakan izin IAM.
3. Ekspor database Anda:

   Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

   • PROJECT_ID: project ID
   • INSTANCE_ID: ID instance
   • BUCKET_NAME: nama bucket Cloud Storage
   • PATH_TO_DUMP_FILE: jalur ke file dump SQL
   • DATABASE_NAME_1: nama database di dalam instance Cloud SQL
   • DATABASE_NAME_2: nama database di dalam instance Cloud SQL
   Catatan: Untuk menggunakan ekspor serverless, tetapkan nilai parameter offload ke TRUE. Ekspor serverless memerlukan biaya tambahan. Lihat halaman harga.

Metode HTTP dan URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/export

Meminta isi JSON:

{
 "exportContext":
   {
      "fileType": "SQL",
      "uri": "gs://BUCKET_NAME/PATH_TO_DUMP_FILE",
      "databases": ["DATABASE_NAME"],
      "offload": TRUE | FALSE
    }
}

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/export"

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/export" | Select-Object -Expand Content

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

Respons

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

4. Jika Anda tidak perlu mempertahankan peran IAM yang telah ditetapkan sebelumnya, hapus sekarang.

Untuk mengetahui daftar lengkap parameter permintaan, lihat halaman instances:export.

REST v1beta4

1. Buat bucket untuk ekspor:

   gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
   

   Langkah ini tidak wajib, tetapi sangat direkomendasikan, agar Anda tidak membuka akses ke data lain.

2. Berikan storage.objectAdmin pada instance Anda peran IAM untuk bucket Anda. Untuk mendapatkan bantuan terkait penetapan izin IAM, lihat Menggunakan izin IAM.
3. Ekspor database Anda:

   Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

   • PROJECT_ID: project ID
   • INSTANCE_ID: ID instance
   • BUCKET_NAME: nama bucket Cloud Storage
   • PATH_TO_DUMP_FILE: jalur ke file dump SQL
   • DATABASE_NAME_1: nama database di dalam instance Cloud SQL
   • DATABASE_NAME_2: nama database di dalam instance Cloud SQL
   Catatan: Untuk menggunakan ekspor serverless, tetapkan nilai parameter offload ke TRUE. Ekspor serverless memerlukan biaya tambahan. Lihat halaman harga.

Metode HTTP dan URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/export

Meminta isi JSON:

{
  "exportContext":
    {
       "fileType": "SQL",
       "uri": "gs://BUCKET_NAME/PATH_TO_DUMP_FILE",
       "databases": ["DATABASE_NAME"],
       "offload": TRUE | FALSE
     }
 }

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/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/export"

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/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/export" | 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/TARGET_INSTANCE_ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

4. Jika Anda tidak perlu mempertahankan peran IAM yang telah ditetapkan sebelumnya, cabut sekarang.

Untuk mengetahui daftar lengkap parameter permintaan, lihat halaman instance:ekspor.

Mengekspor dari server MySQL lokal Anda menggunakan mysqldump

Jika Anda mengekspor data dari database MySQL lokal untuk diimpor ke database Cloud SQL, Anda harus menggunakan aplikasi utilitas mysqldump dengan flag berikut:

• --databases Anda harus menggunakan opsi --databases untuk menentukan daftar eksplisit database yang akan diekspor, dan daftar tersebut tidak boleh berisi database sistem mysql.
• --hex-blob Jika database Anda berisi kolom biner, Anda harus menggunakan flag ini untuk memastikan kolom biner And diimpor dengan benar.
• --set-gtid-purged=OFF Informasi GTID tidak boleh disertakan dalam file dump SQL, dan logging biner tidak boleh dinonaktifkan oleh file dump SQL. (Tidak diperlukan untuk MySQL 5.5 atau replikasi eksternal.)
• --single-transaction Memulai transaksi sebelum berjalan. Daripada mengunci seluruh database, tindakan ini memungkinkan mysqldump membaca database dalam kondisi saat ini, untuk memberikan dump data yang konsisten.

Catatan: Jika Anda ingin mengimpor file dump SQL ke database Cloud SQL, jangan mengekspor pengguna MySQL buatan pelanggan. Anda harus menambahkan pengguna secara langsung ke database Cloud SQL. Melihat Membuat pengguna.

Dari command line, jalankan mysqldump:

mysqldump --databases DATABASE_NAME -h INSTANCE_IP -u USERNAME -p \
--hex-blob --single-transaction --set-gtid-purged=OFF \
--default-character-set=utf8mb4 > SQL_FILE.sql

Catatan: Untuk mengekspor prosedur tersimpan dari instance Cloud SQL, sertakan flag --routines. Untuk mengekspor pemicu dari instance Cloud SQL, pastikan bahwa --skip-triggers tidak ditentukan. Jika logging biner diaktifkan dan Anda ingin mengekspor pemicu serta prosedur tersimpan, Anda juga harus menetapkan log_bin_trust_function_creators flag di database MySQL Anda.

Untuk mendapatkan bantuan terkait mysqldump, lihat referensi mysqldump.

Replikasi eksternal ke Cloud SQL untuk MySQL

Untuk membuat file dump yang akan digunakan dalam konfigurasi server eksternal, lihat Mereplikasi dari server eksternal.

Mengimpor data ke Cloud SQL untuk MySQL

Peran dan izin yang diperlukan untuk mengimpor ke Cloud SQL untuk MySQL

Untuk mengimpor data dari Cloud Storage ke Cloud SQL, pengguna yang memulai impor harus memiliki salah satu peran berikut:

• Peran Admin Cloud SQL
• Peran khusus, yang mencakup izin berikut:
  • cloudsql.instances.get
  • cloudsql.instances.import

Selain itu, akun layanan untuk instance Cloud SQL harus memiliki salah satu peran berikut:

• Peran IAM storage.objectAdmin
• Peran khusus, termasuk izin berikut:
  • storage.objects.get
  • storage.objects.list (hanya untuk mengimpor file secara paralel)

Untuk mendapatkan bantuan terkait peran IAM, lihat Identity and Access Management.

Catatan: Perubahan yang Anda buat pada izin dan peran IAM mungkin memerlukan waktu beberapa menit untuk diterapkan. Untuk mengetahui informasi selengkapnya, lihat Penerapan perubahan akses.

Mengimpor file dump SQL ke Cloud SQL untuk MySQL

File SQL adalah file teks biasa dengan urutan perintah SQL.

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 Import.
4. Di bagian Pilih file yang ingin Anda impor data, masukkan jalur ke bucket dan file dump SQL yang akan digunakan untuk impor, atau cari file yang sudah ada singkat ini.

   Anda dapat mengimpor file yang dikompresi (.gz) atau file yang tidak dikompresi (.sql).

5. Untuk Format, pilih SQL.

6. Pilih database tempat Anda ingin mengimpor data.

   Hal ini menyebabkan Cloud SQL menjalankan pernyataan USE DATABASE sebelum impor.

   Jika file dump SQL Anda menyertakan pernyataan USE DATABASE, file tersebut akan menggantikan database yang ditetapkan di Konsol Google Cloud.

7. Jika Anda ingin menentukan pengguna tertentu untuk melakukan impor, pilih pengguna.

   Jika file impor Anda berisi pernyataan yang harus dilakukan oleh pengguna tertentu, gunakan kolom ini untuk menentukan pengguna tersebut.

8. Klik Import untuk memulai impor.

gcloud

1. Membuat bucket Cloud Storage.

2. Upload file ke bucket Anda.

   Untuk bantuan dalam mengupload file ke bucket, lihat Mengupload objek.

3. Menjelaskan instance tujuan impor:

   gcloud sql instances describe INSTANCE_NAME

4. Menyalin kolom serviceAccountEmailAddress.
5. Menggunakan gcloud storage buckets add-iam-policy-binding untuk memberikan storage.objectAdmin peran IAM ke akun layanan untuk bucket.

   gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME \
     --member=serviceAccount:SERVICE-ACCOUNT \
     --role=roles/storage.objectAdmin
     

   Untuk mendapatkan bantuan terkait penetapan izin IAM, lihat Menggunakan izin IAM.
6. Impor database:

   gcloud sql import sql INSTANCE_NAME gs://BUCKET_NAME/IMPORT_FILE_NAME \
   --database=DATABASE_NAME

   Untuk informasi tentang penggunaan perintah import sql, lihat halaman referensi perintah sql import sql.

   Jika perintah menampilkan error seperti ERROR_RDBMS, tinjau izinnya; kesalahan ini sering kali disebabkan oleh masalah izin.

7. Jika Anda tidak perlu mempertahankan izin IAM yang telah ditetapkan sebelumnya, hapus menggunakan gcloud storage buckets remove-iam-policy-binding.

REST v1

1. Membuat file dump SQL. Petunjuk yang ditautkan menetapkan flag tertentu yang membuat file dump tersebut kompatibel dengan Cloud SQL.

   • Jika Anda mengimpor data dari server MySQL lokal:
   1. Membuat file dump SQL.
   2. Membuat bucket di Cloud Storage.
   3. Mengupload file dump SQL ke bucket Cloud Storage.
   • Jika Anda mengimpor data dari instance Cloud SQL lain, lihat petunjuk di Mengekspor data dari Cloud SQL ke file dump SQL.
2. Membuat bucket Cloud Storage.

3. Upload file ke bucket Anda.

   Untuk mendapatkan bantuan dalam mengupload file ke bucket, lihat Mengupload objek.

4. Beri instance Anda peran IAM legacyBucketWriter dan objectViewer untuk bucket Anda. Untuk mendapatkan bantuan terkait penetapan izin IAM, lihat Menggunakan izin IAM.
5. Impor file dump Anda:

   Sebelum menggunakan salah satu data permintaan, buat pengganti berikut:

   • project-id: ID project
   • instance-id: ID instance
   • bucket_name: Nama bucket Cloud Storage
   • path_to_sql_file: Jalur ke file SQL
   • 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/import

   Meminta isi JSON:

   {
    "importContext":
      {
         "fileType": "SQL",
         "uri": "gs://bucket_name/path_to_sql_file",
         "database": "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/import"

   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/import" | Select-Object -Expand Content

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

   Respons

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

   Untuk mengetahui daftar lengkap parameter permintaan, lihat halaman instance:import.
6. Jika Anda tidak perlu mempertahankan izin IAM yang telah ditetapkan sebelumnya, hapus sekarang.

REST v1beta4

1. Membuat file dump SQL. Petunjuk yang ditautkan menetapkan flag tertentu yang membuat file dump tersebut kompatibel dengan Cloud SQL.

   • Jika Anda mengimpor data dari server MySQL lokal:
   1. Membuat file dump SQL.
   2. Membuat bucket di Cloud Storage.
   3. Mengupload file dump SQL ke bucket Cloud Storage.
   • Jika Anda mengimpor data dari instance Cloud SQL lain, lihat petunjuk di Mengekspor data dari Cloud SQL ke file dump SQL.
2. Membuat bucket Cloud Storage.

3. Upload file ke bucket Anda.

   Untuk bantuan dalam mengupload file ke bucket, lihat Mengupload objek.

4. Berikan instance Anda peran IAM storage.objectAdmin untuk bucket Anda. Untuk mendapatkan bantuan terkait penetapan izin IAM, lihat Menggunakan izin IAM.
5. Impor file dump Anda:

   Sebelum menggunakan salah satu data permintaan, buat pengganti berikut:

   • project-id: ID project
   • instance-id: ID instance
   • bucket_name: Nama bucket Cloud Storage
   • path_to_sql_file: Jalur ke file SQL
   • 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/import

   Meminta isi JSON:

   {
    "importContext":
      {
         "fileType": "SQL",
         "uri": "gs://bucket_name/path_to_sql_file",
         "database": "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/sql/v1beta4/projects/project-id/instances/instance-id/import"

   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/sql/v1beta4/projects/project-id/instances/instance-id/import" | 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/target-instance-id",
     "status": "PENDING",
     "user": "[e-mail]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "operation-id",
     "targetId": "instance-id",
     "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

   Untuk mengetahui daftar lengkap parameter permintaan, lihat halaman instance:import.
6. Jika Anda tidak perlu mempertahankan izin IAM yang telah ditetapkan sebelumnya, hapus sekarang.

Catatan: Jika Anda mendapatkan pesan error yang menyatakan bahwa Anda memerlukan hak istimewa SUPER saat mencoba mengimpor data, file ekspor akan berisi elemen yang tidak dapat diimpor ke Cloud SQL. Memastikan Anda mengikuti petunjuk dalam mengekspor data untuk diimpor ke Cloud SQL saat Anda membuat file ekspor.

Langkah berikutnya

• Pelajari cara memeriksa status operasi impor dan ekspor.
• Pelajari lebih lanjut praktik terbaik untuk mengimpor dan mengekspor data.
• Mempelajari Cloud Storage lebih lanjut.
• Masalah umum untuk impor dan ekspor.