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: Mengimpor dari file SQL jauh lebih lambat dan lebih cocok untuk subset data atau beberapa tabel kecil. Mengimpor dari file SQL rentan mengalami kegagalan, karena masalah sintaksis, ukuran file, atau format file. Jika Anda mengekspor untuk membuat instance baru dari file yang diekspor, pertimbangkan untuk memulihkan dari cadangan ke instance lain atau meng-clone instance.

Mengekspor dari Cloud SQL ke file dump SQL tidak didukung untuk SQL Server.

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, verifikasi hasilnya.

Mengekspor data dari Cloud SQL untuk SQL Server

Mengekspor dari Cloud SQL ke file dump SQL tidak didukung untuk SQL Server.

Mengimpor data ke Cloud SQL untuk SQL Server

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

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

• Peran Cloud SQL Editor
• Peran khusus, termasuk 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 impor bergaris)

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

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

Mengimpor file dump SQL ke Cloud SQL untuk SQL Server

File SQL adalah file teks biasa dengan urutan perintah SQL.

Dalam prosedur berikut, siapkan untuk menentukan database yang sudah ada untuk mengimpor file SQL Anda.

Catatan: Anda tidak dapat mengimpor database yang diekspor dari versi SQL Server yang lebih tinggi atau mengimpor dari tingkat kompatibilitas yang lebih tinggi ke tingkat kompatibilitas yang lebih rendah. Misalnya, jika Anda mengekspor versi SQL Server 2017, Anda tidak dapat mengimpornya ke versi SQL Server 2014.

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 gsutil iam untuk memberikan storage.objectAdmin peran IAM ke akun layanan untuk bucket.

   gsutil iam ch serviceAccount:SERVICE-ACCOUNT:objectAdmin \
   gs://BUCKET_NAME
     

   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 gsutil iam.

REST v1

1. Membuat bucket Cloud Storage.

2. Upload file ke bucket Anda.

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

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

   Sebelum menggunakan salah satu data permintaan, lakukan penggantian 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 melihat respons JSON seperti berikut:

   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 instances:import.
5. Jika Anda merasa tidak perlu mempertahankan izin IAM yang ditetapkan sebelumnya, hapus sekarang.

REST v1beta4

1. Membuat bucket Cloud Storage.

2. Upload file ke bucket Anda.

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

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

   Sebelum menggunakan salah satu data permintaan, lakukan penggantian 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 melihat respons JSON seperti berikut:

   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 instances:import.
5. Jika Anda merasa tidak perlu mempertahankan izin IAM yang ditetapkan sebelumnya, hapus sekarang.

Langkah selanjutnya

• 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.