Halaman ini diterjemahkan oleh Cloud Translation API.

Mengekspor dan mengimpor file secara paralel

MySQL | PostgreSQL | SQL Server

Halaman ini menjelaskan cara mengekspor dan mengimpor file ke instance Cloud SQL secara paralel.

Sebelum memulai

Sebelum Anda memulai operasi ekspor atau impor:

Pastikan database Anda memiliki ruang kosong yang memadai.

Operasi ekspor dan impor menggunakan resource database, tetapi tidak mengganggu operasi database normal kecuali jika penyediaan instance kurang lengkap.

Ikuti praktik terbaik untuk mengekspor dan mengimpor data.
Setelah menyelesaikan operasi impor, verifikasi hasilnya.

Mengekspor data dari Cloud SQL untuk PostgreSQL ke beberapa file secara paralel

Bagian berikut berisi informasi tentang cara mengekspor data dari Cloud SQL untuk PostgreSQL ke beberapa file secara paralel.

Peran dan izin yang diperlukan untuk mengekspor data dari Cloud SQL untuk PostgreSQL ke beberapa file secara paralel

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.

Mengekspor data ke beberapa file secara paralel

Anda dapat mengekspor data secara paralel dari beberapa file yang berada di Cloud SQL ke Cloud Storage. Untuk melakukannya, gunakan utilitas pg_dump dengan opsi --jobs.

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

gcloud

Untuk mengekspor data dari Cloud SQL ke beberapa file secara paralel, selesaikan langkah-langkah berikut:

Buat bucket Cloud Storage.
Catatan: Anda tidak perlu membuat folder di bucket. Jika folder tidak ada, Cloud SQL akan membuatnya untuk Anda sebagai bagian dari proses mengekspor beberapa file secara paralel. Namun, jika folder sudah ada, folder tersebut harus kosong atau operasi ekspor akan gagal.
Untuk menemukan akun layanan untuk instance Cloud SQL tempat Anda mengekspor file, gunakan perintah
gcloud sql instances describe.
```
gcloud sql instances describe INSTANCE_NAME
```

Ganti INSTANCE_NAME dengan nama instance Cloud SQL Anda.

Di output, cari nilai yang terkait dengan kolom serviceAccountEmailAddress.

Untuk memberikan peran IAM storage.objectAdmin ke akun layanan, gunakan perintah gcloud storage buckets add-iam-policy-binding. Untuk mendapatkan bantuan terkait penetapan izin IAM, lihat Menggunakan izin IAM.
Untuk mengekspor data dari Cloud SQL ke beberapa file secara paralel, gunakan perintah gcloud sql export sql:
```
gcloud sql export sql INSTANCE_NAME gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME \
--offload \
--parallel \
--threads=THREAD_NUMBER \
--database=DATABASE_NAME \
--table=TABLE_EXPRESSION
```
Lakukan penggantian berikut:
- INSTANCE_NAME: nama instance Cloud SQL tempat Anda mengekspor file secara paralel.
- BUCKET_NAME: nama bucket Cloud Storage.
- BUCKET_PATH: jalur ke bucket tempat file ekspor disimpan.
- FOLDER_NAME: folder tempat file ekspor disimpan.
- THREAD_NUMBER: jumlah thread yang digunakan Cloud SQL untuk mengekspor file secara paralel. Misalnya, jika Anda ingin mengekspor tiga file sekaligus secara paralel, tentukan 3 sebagai nilai untuk parameter ini.
- DATABASE_NAME: nama database di dalam instance Cloud SQL tempat ekspor dilakukan. Anda hanya boleh menentukan satu database.
- TABLE_EXPRESSION: tabel yang akan diekspor dari database yang ditentukan.
Catatan: Jika Anda ingin menggunakan ekspor serverless hingga 2 thread, gunakan parameter offload. Jika Anda ingin mengekspor beberapa file secara paralel, gunakan parameter parallel. Jika tidak, hapus parameter ini dari perintah.

Perintah export sql tidak berisi pemicu atau prosedur tersimpan, tetapi berisi tampilan. Untuk mengekspor pemicu atau prosedur tersimpan, gunakan satu thread untuk ekspor. Thread ini menggunakan alat pg_dump.

Setelah ekspor selesai, Anda akan memiliki file dalam folder di bucket Cloud Storage dalam format direktori pg_dump.
Jika Anda tidak memerlukan peran IAM yang ditetapkan di Peran dan izin yang diperlukan untuk mengekspor dari Cloud SQL untuk PostgreSQL, cabut peran tersebut.

REST v1

Untuk mengekspor data dari Cloud SQL ke beberapa file secara paralel, selesaikan langkah-langkah berikut:

Membuat bucket Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
Lakukan penggantian berikut:
- BUCKET_NAME: nama bucket, tunduk pada persyaratan penamaan. Misalnya, my-bucket.
- PROJECT_NAME: nama project Google Cloud yang berisi bucket Cloud Storage yang Anda buat.
- LOCATION_NAME: lokasi bucket tempat Anda ingin menyimpan file yang diekspor. Contoh, us-east1.
Catatan: Anda tidak perlu membuat folder di bucket. Jika folder tidak ada, Cloud SQL akan membuatnya untuk Anda sebagai bagian dari proses mengekspor beberapa file secara paralel. Namun, jika folder sudah ada, folder tersebut harus kosong atau operasi ekspor akan gagal.
Berikan legacyBucketWriter pada instance Anda peran IAM untuk bucket Anda. Untuk mendapatkan bantuan terkait penetapan izin IAM, lihat Menggunakan izin IAM.
Mengekspor data dari Cloud SQL ke beberapa file secara paralel:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_NAME: nama project Google Cloud yang berisi bucket Cloud Storage yang Anda buat.
- INSTANCE_NAME: nama instance Cloud SQL tempat Anda mengekspor file secara paralel.
- BUCKET_NAME: nama bucket Cloud Storage.
- BUCKET_PATH: jalur ke bucket tempat file ekspor disimpan.
- FOLDER_NAME: folder tempat file ekspor disimpan.
- DATABASE_NAME: nama database di dalam instance Cloud SQL tempat ekspor dilakukan. Anda hanya boleh menentukan satu database.
- THREAD_NUMBER: jumlah thread yang digunakan Cloud SQL untuk mengekspor file secara paralel. Misalnya, jika Anda ingin mengekspor tiga file sekaligus secara paralel, tentukan 3 sebagai nilai untuk parameter ini.
Catatan: Parameter offload memungkinkan Anda menggunakan ekspor serverless hingga 2 thread. Parameter parallel memungkinkan Anda mengekspor beberapa file secara paralel. Untuk menggunakan fitur ini, tetapkan nilai parameter ini ke TRUE. Jika tidak, tetapkan nilainya ke FALSE.

Metode HTTP dan URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/instances/INSTANCE_NAME/export
```
Meminta isi JSON:
```
{
 "exportContext":
   {
      "fileType": "SQL",
      "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
      "databases": ["DATABASE_NAME"],
      "offload": [TRUE|FALSE],
      "sqlExportOptions": {
        "parallel": [TRUE|FALSE],
        "threads": [THREAD_NUMBER]
       }
   }
}
```
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_NAME/instances/INSTANCE_NAME/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_NAME/instances/INSTANCE_NAME/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_NAME/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/operations/OPERATION_ID",
  "targetProject": "PROJECT_NAME"
}
```

Setelah ekspor selesai, Anda akan memiliki file dalam folder di bucket Cloud Storage dalam format direktori pg_dump.

Jika Anda tidak memerlukan peran IAM yang ditetapkan di Peran dan izin yang diperlukan untuk mengekspor dari Cloud SQL untuk PostgreSQL, cabut peran tersebut.

Untuk mengetahui daftar lengkap parameter permintaan, lihat halaman Cloud SQL Admin API.

REST v1beta4

Untuk mengekspor data dari Cloud SQL ke beberapa file secara paralel, selesaikan langkah-langkah berikut:

Membuat bucket Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
Lakukan penggantian berikut:
- BUCKET_NAME: nama bucket, tunduk pada persyaratan penamaan. Misalnya, my-bucket.
- PROJECT_NAME: nama project Google Cloud yang berisi bucket Cloud Storage yang Anda buat.
- LOCATION_NAME: lokasi bucket tempat Anda ingin menyimpan file yang diekspor. Contoh, us-east1.
Catatan: Anda tidak perlu membuat folder di bucket. Jika folder tidak ada, Cloud SQL akan membuatnya untuk Anda sebagai bagian dari proses mengekspor beberapa file secara paralel. Namun, jika folder sudah ada, folder tersebut harus kosong atau operasi ekspor akan gagal.
Berikan storage.objectAdmin pada instance Anda peran IAM untuk bucket Anda. Untuk mendapatkan bantuan terkait penetapan izin IAM, lihat Menggunakan izin IAM.
Mengekspor data dari Cloud SQL ke beberapa file secara paralel:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_NAME: nama project Google Cloud yang berisi bucket Cloud Storage yang Anda buat.
- INSTANCE_NAME: nama instance Cloud SQL tempat Anda mengekspor file secara paralel.
- BUCKET_NAME: nama bucket Cloud Storage.
- BUCKET_PATH: jalur ke bucket tempat file ekspor disimpan.
- FOLDER_NAME: folder tempat file ekspor disimpan.
- DATABASE_NAME: nama database di dalam instance Cloud SQL tempat ekspor dilakukan. Anda hanya boleh menentukan satu database.
- THREAD_NUMBER: jumlah thread yang digunakan Cloud SQL untuk mengekspor file secara paralel. Misalnya, jika Anda ingin mengekspor tiga file sekaligus secara paralel, tentukan 3 sebagai nilai untuk parameter ini.
Catatan: Parameter offload memungkinkan Anda menggunakan ekspor serverless hingga 2 thread. Parameter parallel memungkinkan Anda mengekspor beberapa file secara paralel. Untuk menggunakan fitur ini, tetapkan nilai parameter ini ke TRUE. Jika tidak, tetapkan nilainya ke FALSE.

Metode HTTP dan URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/instances/INSTANCE_NAME/export
```
Meminta isi JSON:
```
{
 "exportContext":
   {
      "fileType": "SQL",
      "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
      "databases": ["DATABASE_NAME"],
      "offload": [TRUE|FALSE],
      "sqlExportOptions": {
        "parallel": [TRUE|FALSE],
        "threads": [THREAD_NUMBER]
       }
   }
}
```
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_NAME/instances/INSTANCE_NAME/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_NAME/instances/INSTANCE_NAME/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_NAME/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/operations/OPERATION_ID",
  "targetProject": "PROJECT_NAME"
}
```

Setelah ekspor selesai, Anda akan memiliki file dalam folder di bucket Cloud Storage dalam format direktori pg_dump.

Jika Anda tidak memerlukan peran IAM yang ditetapkan di Peran dan izin yang diperlukan untuk mengekspor dari Cloud SQL untuk PostgreSQL, cabut peran tersebut.

Untuk mengetahui daftar lengkap parameter permintaan, lihat halaman Cloud SQL Admin API.

Mengimpor data dari beberapa file secara paralel ke Cloud SQL untuk PostgreSQL

Bagian berikut berisi informasi tentang cara mengimpor data dari beberapa file secara paralel ke Cloud SQL untuk PostgreSQL.

Peran dan izin yang diperlukan untuk mengimpor data dari beberapa file secara paralel 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 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.

Mengimpor data ke Cloud SQL untuk PostgreSQL

Anda dapat mengimpor data secara paralel dari beberapa file yang berada di Cloud Storage ke database. Untuk melakukannya, gunakan utilitas pg_restore dengan opsi --jobs.

gcloud

Untuk mengimpor data dari beberapa file secara paralel ke Cloud SQL, selesaikan langkah-langkah berikut:

Buat bucket Cloud Storage.
Upload file ke bucket Anda.

Catatan: Pastikan file yang Anda upload dalam format direktori pg_dump. Untuk mengetahui informasi selengkapnya, lihat Mengekspor data dari beberapa file secara paralel.

Untuk mendapatkan bantuan dalam mengupload file ke bucket, lihat Mengupload objek dari file.
Untuk menemukan akun layanan untuk instance Cloud SQL tempat Anda mengimpor file, gunakan perintah
gcloud sql instances describe.
```
gcloud sql instances describe INSTANCE_NAME
```

Ganti INSTANCE_NAME dengan nama instance Cloud SQL Anda.

Di output, cari nilai yang terkait dengan kolom serviceAccountEmailAddress.

Untuk memberikan peran IAM storage.objectAdmin ke akun layanan, gunakan utilitas gcloud storage buckets add-iam-policy-binding. Untuk mendapatkan bantuan terkait penetapan izin IAM, lihat Menggunakan izin IAM.
Untuk mengimpor data dari beberapa file secara paralel ke Cloud SQL, gunakan perintah gcloud sql import sql:
```
gcloud sql import sql INSTANCE_NAME gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME \
--offload \
--parallel \ 
--threads=THREAD_NUMBER \
--database=DATABASE_NAME
```
Lakukan penggantian berikut:
- INSTANCE_NAME: nama instance Cloud SQL tempat Anda mengimpor file secara paralel.
- BUCKET_NAME: nama bucket Cloud Storage.
- BUCKET_PATH: jalur ke bucket tempat file impor disimpan.
- FOLDER_NAME: folder tempat file impor disimpan.
- THREAD_NUMBER: jumlah thread yang digunakan Cloud SQL untuk mengimpor file secara paralel. Misalnya, jika Anda ingin mengimpor tiga file sekaligus secara paralel, tentukan 3 sebagai nilai untuk parameter ini.
- DATABASE_NAME: nama database di dalam instance Cloud SQL tempat impor dilakukan. Anda hanya boleh menentukan satu database.
Catatan: Jika Anda ingin menggunakan impor serverless hingga 2 thread, gunakan parameter offload. Jika Anda ingin mengimpor beberapa file secara paralel, gunakan parameter parallel.

Jika Anda menggunakan parameter parallel, dan ingin menghapus (membersihkan) objek database sebelum membuatnya ulang, gunakan parameter clean. Jika Anda menggunakan parameter parallel, dan ingin menyertakan pernyataan SQL IF EXISTS dengan setiap pernyataan DROP yang dihasilkan oleh parameter clean, gunakan parameter if-exists.

Jika tidak, hapus parameter ini dari perintah.

Jika perintah menampilkan error seperti ERROR_RDBMS, tinjau izinnya; kesalahan ini sering kali disebabkan oleh masalah izin.
Jika Anda tidak memerlukan izin IAM yang Anda tetapkan di Peran dan izin yang diperlukan untuk mengimpor ke Cloud SQL untuk PostgreSQL, gunakan gcloud storage buckets remove-iam-policy-binding untuk menghapusnya.

REST v1

Untuk mengimpor data dari beberapa file secara paralel ke Cloud SQL, selesaikan langkah-langkah berikut:

Membuat bucket Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
Lakukan penggantian berikut:
- BUCKET_NAME: nama bucket, tunduk pada persyaratan penamaan. Misalnya, my-bucket.
- PROJECT_NAME: nama project Google Cloud yang berisi bucket Cloud Storage yang Anda buat.
- LOCATION_NAME: lokasi bucket tempat Anda ingin menyimpan file yang diimpor. Contoh, us-east1.
Upload file ke bucket Anda.

Catatan: Pastikan file yang Anda upload dalam format direktori pg_dump. Untuk mengetahui informasi selengkapnya, lihat Mengekspor data dari beberapa file secara paralel.

Untuk mendapatkan bantuan dalam mengupload file ke bucket, lihat Mengupload objek dari file.
Berikan instance Anda peran IAM storage.objectAdmin untuk bucket Anda. Untuk mendapatkan bantuan terkait penetapan izin IAM, lihat Menggunakan izin IAM.
Mengimpor data dari beberapa file secara paralel ke Cloud SQL:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_NAME: nama project Google Cloud yang berisi bucket Cloud Storage yang Anda buat.
- INSTANCE_NAME: nama instance Cloud SQL tempat Anda mengimpor file secara paralel.
- BUCKET_NAME: nama bucket Cloud Storage.
- BUCKET_PATH: jalur ke bucket tempat file impor disimpan.
- FOLDER_NAME: folder tempat file impor disimpan.
- DATABASE_NAME: nama database di dalam instance Cloud SQL tempat impor dilakukan. Anda hanya boleh menentukan satu database.
- THREAD_NUMBER: jumlah thread yang digunakan Cloud SQL untuk mengimpor file secara paralel. Misalnya, jika Anda ingin mengimpor tiga file sekaligus secara paralel, tentukan 3 sebagai nilai untuk parameter ini.
Catatan: Parameter offload memungkinkan Anda menggunakan impor serverless hingga 2 thread. Parameter parallel memungkinkan Anda mengimpor beberapa file secara paralel.
Jika Anda menggunakan parameter parallel, parameter clean memungkinkan Anda menghapus (membersihkan) objek database sebelum membuatnya ulang. Jika Anda menggunakan parameter parallel, parameter ifExists memungkinkan Anda menyertakan pernyataan SQL IF EXISTS dengan setiap pernyataan DROP yang dihasilkan oleh parameter clean.

Untuk menggunakan fitur ini, tetapkan nilai parameter ini ke TRUE. Jika tidak, tetapkan nilainya ke FALSE.

Metode HTTP dan URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/instances/INSTANCE_NAME/import
```
Meminta isi JSON:
```
{
  "importContext":
    {
       "fileType": "SQL",
       "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
       "databases": ["DATABASE_NAME"],
       "offload": [TRUE|FALSE],
       "sqlImportOptions": {
         "parallel": [TRUE|FALSE],
         "clean": [TRUE|FALSE],
         "ifExists": [TRUE|FALSE],
         "threads": [THREAD_NUMBER]
        }
    }
 }
```
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_NAME/instances/INSTANCE_NAME/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_NAME/instances/INSTANCE_NAME/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_NAME/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/operations/OPERATION_ID",
  "targetProject": "PROJECT_NAME"
}
```
Untuk menggunakan akun pengguna lain untuk impor, tentukan properti importContext.importUser.
Untuk mengetahui daftar lengkap parameter permintaan, lihat halaman Cloud SQL Admin API.
Jika Anda tidak memerlukan izin IAM yang Anda tetapkan di Peran dan izin yang diperlukan untuk mengimpor ke Cloud SQL untuk PostgreSQL, gunakan gcloud storage buckets remove-iam-policy-binding untuk menghapusnya.

REST v1beta4

Untuk mengimpor data dari beberapa file secara paralel ke Cloud SQL, selesaikan langkah-langkah berikut:

Membuat bucket Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
Lakukan penggantian berikut:
- BUCKET_NAME: nama bucket, tunduk pada persyaratan penamaan. Misalnya, my-bucket.
- PROJECT_NAME: nama project Google Cloud yang berisi bucket Cloud Storage yang Anda buat.
- LOCATION_NAME: lokasi bucket tempat Anda ingin menyimpan file yang diimpor. Contoh, us-east1.
Upload file ke bucket Anda.

Catatan: Pastikan file yang Anda upload dalam format direktori pg_dump. Untuk mengetahui informasi selengkapnya, lihat Mengekspor data dari beberapa file secara paralel.

Untuk mendapatkan bantuan dalam mengupload file ke bucket, lihat Mengupload objek dari file.
Berikan instance Anda peran IAM storage.objectAdmin untuk bucket Anda. Untuk mendapatkan bantuan terkait penetapan izin IAM, lihat Menggunakan izin IAM.
Mengimpor data dari beberapa file secara paralel ke Cloud SQL:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_NAME: nama project Google Cloud yang berisi bucket Cloud Storage yang Anda buat.
- INSTANCE_NAME: nama instance Cloud SQL tempat Anda mengimpor file secara paralel.
- BUCKET_NAME: nama bucket Cloud Storage.
- BUCKET_PATH: jalur ke bucket tempat file impor disimpan.
- FOLDER_NAME: folder tempat file impor disimpan.
- DATABASE_NAME: nama database di dalam instance Cloud SQL tempat impor dilakukan. Anda hanya boleh menentukan satu database.
- THREAD_NUMBER: jumlah thread yang digunakan Cloud SQL untuk mengimpor file secara paralel. Misalnya, jika Anda ingin mengimpor tiga file sekaligus secara paralel, tentukan 3 sebagai nilai untuk parameter ini.
Catatan: Parameter offload memungkinkan Anda menggunakan impor serverless hingga 2 thread. Parameter parallel memungkinkan Anda mengimpor beberapa file secara paralel.
Jika Anda menggunakan parameter parallel, parameter clean memungkinkan Anda menghapus (membersihkan) objek database sebelum membuatnya ulang. Jika Anda menggunakan parameter parallel, parameter ifExists memungkinkan Anda menyertakan pernyataan SQL IF EXISTS dengan setiap pernyataan DROP yang dihasilkan oleh parameter clean.

Untuk menggunakan fitur ini, tetapkan nilai parameter ini ke TRUE. Jika tidak, tetapkan nilainya ke FALSE.

Metode HTTP dan URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/instances/INSTANCE_NAME/import
```
Meminta isi JSON:
```
 {
   "importContext":
     {
        "fileType": "SQL",
        "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
        "databases": ["DATABASE_NAME"],
        "offload": [TRUE|FALSE],
        "sqlImportOptions": {
          "parallel": [TRUE|FALSE],
          "clean": [TRUE|FALSE],
          "ifExists": [TRUE|FALSE],
          "threads": [THREAD_NUMBER]
         }
     }
  }
```
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_NAME/instances/INSTANCE_NAME/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_NAME/instances/INSTANCE_NAME/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_NAME/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/operations/OPERATION_ID",
  "targetProject": "PROJECT_NAME"
}
```
Untuk menggunakan akun pengguna lain untuk impor, tentukan properti importContext.importUser.
Untuk mengetahui daftar lengkap parameter permintaan, lihat halaman Cloud SQL Admin API.
Jika Anda tidak memerlukan izin IAM yang Anda tetapkan di Peran dan izin yang diperlukan untuk mengimpor ke Cloud SQL untuk PostgreSQL, gunakan gcloud storage buckets remove-iam-policy-binding untuk menghapusnya.

Batasan

Jika Anda menentukan terlalu banyak thread saat mengimpor atau mengekspor data dari beberapa file secara paralel, Anda mungkin menggunakan lebih banyak memori daripada yang dimiliki instance Cloud SQL. Jika hal ini terjadi, pesan error internal akan muncul. Periksa penggunaan memori instance Anda dan tingkatkan ukuran instance, sesuai kebutuhan. Untuk informasi selengkapnya, lihat Tentang setelan instance.
Saat melakukan ekspor, koma dalam nama database atau nama tabel di kolom databases atau tables tidak didukung.
Pastikan Anda memiliki cukup ruang disk untuk mendownload file dump awal. Jika tidak, error no space left on disk akan muncul.
Jika instance Anda hanya memiliki satu CPU virtual (vCPU), Anda tidak dapat mengimpor atau mengekspor beberapa file secara paralel. Jumlah vCPU untuk instance Anda tidak boleh lebih kecil dari jumlah thread yang Anda gunakan untuk operasi impor atau ekspor, dan jumlah thread harus minimal dua.
Utilitas pg_dump tidak dapat mengelompokkan tabel yang Anda ekspor. Oleh karena itu, jika Anda memiliki satu tabel yang sangat besar, tabel tersebut dapat menjadi bottleneck untuk kecepatan operasi ekspor.

Langkah selanjutnya

Pelajari cara memeriksa status operasi impor dan ekspor.
Pelajari cara membatalkan impor dan ekspor data.
Pelajari praktik terbaik untuk mengimpor dan mengekspor data.
Pelajari masalah umum untuk impor dan ekspor.

Mengekspor dan mengimpor file secara paralel

Sebelum memulai

Mengekspor data dari Cloud SQL untuk PostgreSQL ke beberapa file secara paralel

Peran dan izin yang diperlukan untuk mengekspor data dari Cloud SQL untuk PostgreSQL ke beberapa file secara paralel

Mengekspor data ke beberapa file secara paralel

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 dari beberapa file secara paralel ke Cloud SQL untuk PostgreSQL

Peran dan izin yang diperlukan untuk mengimpor data dari beberapa file secara paralel ke Cloud SQL untuk PostgreSQL

Mengimpor data ke Cloud SQL untuk PostgreSQL

gcloud

REST v1

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Respons

REST v1beta4

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Respons

Batasan

Langkah selanjutnya