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.

Sebelum memulai

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 PostgreSQL

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

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, termasuk 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.

Mengekspor ke file dump SQL dari Cloud SQL untuk PostgreSQL

Saat Anda menggunakan Cloud SQL untuk melakukan ekspor, baik dari Konsol Google Cloud, gcloud CLI, atau API, yang Anda gunakanpg_dump utilitas, dengan opsi yang diperlukan untuk memastikan bahwa file ekspor yang dihasilkan valid untuk diimpor kembali ke Cloud SQL.

Jika berencana untuk mengimpor data ke Cloud SQL, Anda harus mengikuti petunjuk yang diberikan di bagian Mengekspor data dari server database eksternal sehingga file dump SQL Anda diformat dengan benar untuk Cloud SQL singkat ini.

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

Konsol

Di konsol Google Cloud, buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Untuk membuka halaman Ringkasan instance, klik nama instance.
Klik Export.
Di bagian File format, klik SQL untuk membuat file dump SQL.
Di bagian Data untuk diekspor, gunakan menu drop-down untuk memilih database yang ingin Anda ekspor.
Di bagian Destination, pilih Browse untuk menelusuri bucket atau folder Cloud Storage untuk ekspor Anda.
Klik Ekspor untuk memulai ekspor.

gcloud

Membuat bucket Cloud Storage.
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
  
```
Gunakan gsutil iam untuk memberikan peran IAM storage.objectAdmin ke akun layanan. Untuk mendapatkan bantuan terkait penetapan izin IAM, lihat Menggunakan izin IAM.
Ekspor database ke bucket Cloud Storage:
Catatan: Gunakan flag --offload jika Anda ingin menggunakan ekspor serverless. 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 yang tersimpan, gunakan alat pg_dump.

Untuk mengetahui informasi selengkapnya tentang penggunaan perintah export sql, lihat halaman referensi perintah sql export sql.
Jika Anda tidak perlu mempertahankan peran IAM yang telah ditetapkan sebelumnya, revoke sekarang.

REST v1

Buat bucket untuk ekspor:
```
gsutil mb -p PROJECT_NAME -l LOCATION_NAME gs://BUCKET_NAME
```
Langkah ini tidak wajib, tetapi sangat direkomendasikan, agar Anda tidak membuka akses ke data lain.
Beri instance Anda peran IAM legacyBucketWriter untuk bucket Anda. Untuk mendapatkan bantuan terkait penetapan izin IAM, lihat Menggunakan izin IAM.
Ekspor database 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_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
- offload: Mengaktifkan ekspor serverless. Tetapkan ke true untuk menggunakan ekspor serverless.
  Catatan: 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 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/export"
```
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/export" | 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": "user@example.com",
  "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"
}
```
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

Buat bucket untuk ekspor:
```
gsutil mb -p PROJECT_NAME -l LOCATION_NAME gs://BUCKET_NAME
```
Langkah ini tidak wajib, tetapi sangat direkomendasikan, agar Anda tidak membuka akses ke data lain.
Beri instance Anda peran IAM storage.objectAdmin untuk bucket Anda. Untuk mendapatkan bantuan terkait penetapan izin IAM, lihat Menggunakan izin IAM.
Ekspor database 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_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
- offload: Mengaktifkan ekspor serverless. Tetapkan ke true untuk menggunakan ekspor serverless.
  Catatan: 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 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/export"
```
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/export" | 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": "user@example.com",
  "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"
}
```
Jika Anda tidak perlu mempertahankan peran IAM yang telah ditetapkan sebelumnya, revoke sekarang.

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

Mengimpor data ke Cloud SQL untuk PostgreSQL

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

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 mengimpor file secara paralel)

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

Mengimpor file dump SQL ke Cloud SQL untuk PostgreSQL

File SQL adalah file teks biasa dengan urutan perintah SQL.

Konsol

Di konsol Google Cloud, buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Untuk membuka halaman Ringkasan instance, klik nama instance.
Klik Import.
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).
Untuk Format, pilih SQL.
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.
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.
Klik Import untuk memulai impor.

gcloud

Membuat bucket Cloud Storage.
Upload file ke bucket Anda.

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

Menjelaskan instance tujuan impor:

gcloud sql instances describe INSTANCE_NAME

Menyalin kolom serviceAccountEmailAddress.
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.
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.
Jika Anda tidak perlu mempertahankan izin IAM yang telah ditetapkan sebelumnya, hapus menggunakan gsutil iam.

REST v1

Membuat file dump SQL. Petunjuk yang ditautkan menetapkan tanda tertentu yang membuat file dump tersebut kompatibel dengan Cloud SQL.
- Jika Anda mengimpor data dari server PostgreSQL lokal:
Membuat bucket Cloud Storage.
Upload file ke bucket Anda.

Untuk mendapatkan bantuan dalam mengupload file ke bucket, lihat Mengupload objek.
Beri instance Anda peran IAM legacyBucketWriter dan objectViewer untuk bucket Anda. Untuk mendapatkan bantuan terkait penetapan izin IAM, lihat Menggunakan izin IAM.
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": "user@example.com",
  "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 menggunakan akun pengguna lain untuk impor, tentukan properti importContext.importUser.
Untuk mengetahui daftar lengkap parameter permintaan, lihat halaman instances:import.
Jika Anda tidak perlu mempertahankan izin IAM yang telah ditetapkan sebelumnya, hapus sekarang.

REST v1beta4

Membuat file dump SQL. Petunjuk yang ditautkan menetapkan tanda tertentu yang membuat file dump tersebut kompatibel dengan Cloud SQL.
- Jika Anda mengimpor data dari server PostgreSQL lokal:
Membuat bucket Cloud Storage.
Upload file ke bucket Anda.

Untuk bantuan dalam mengupload file ke bucket, lihat Mengupload objek.
Berikan instance Anda peran IAM storage.objectAdmin untuk bucket Anda. Untuk mendapatkan bantuan terkait penetapan izin IAM, lihat Menggunakan izin IAM.
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": "user@example.com",
  "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 menggunakan akun pengguna lain untuk impor, tentukan properti importContext.importUser.
Untuk mengetahui daftar lengkap parameter permintaan, lihat halaman instances:import.
Jika Anda tidak perlu mempertahankan izin IAM yang telah 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.

Mengekspor dan mengimpor menggunakan file dump SQL

Sebelum memulai

Mengekspor data dari Cloud SQL untuk PostgreSQL

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

Mengekspor ke file dump SQL dari Cloud SQL untuk PostgreSQL

Konsol

gcloud

REST v1

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Respons

REST v1beta4

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Respons

Mengimpor data ke Cloud SQL untuk PostgreSQL

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

Mengimpor file dump SQL ke Cloud SQL untuk PostgreSQL

Konsol

gcloud

REST v1

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Respons

REST v1beta4

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Respons

Langkah selanjutnya