本頁面由 Cloud Translation API 翻譯而成。

並行匯出及匯入檔案
透過集合功能整理內容你可以依據偏好儲存及分類內容。

MySQL | PostgreSQL | SQL Server

本頁面說明如何並行匯出及匯入 Cloud SQL 執行個體中的檔案。

事前準備

開始匯出或匯入作業前：

請確認資料庫有足夠的可用空間。

匯出和匯入作業會使用資料庫資源，但除非執行個體未充分配置，否則不會干擾一般資料庫作業。

請遵循匯出及匯入資料的最佳做法。
完成匯入作業後，請驗證結果。

從 PostgreSQL 適用的 Cloud SQL 匯出資料至多個檔案並進行並行處理

以下各節說明如何從 PostgreSQL 適用的 Cloud SQL 並行匯出資料至多個檔案。

從 PostgreSQL 適用的 Cloud SQL 並行匯出資料至多個檔案時，所需的角色和權限

如要將資料從 Cloud SQL 匯出至 Cloud Storage，啟動匯出作業的使用者必須具備下列其中一個角色：

Cloud SQL 編輯者角色
自訂角色，包括下列權限：
- cloudsql.instances.get
- cloudsql.instances.export

此外，Cloud SQL 執行個體的服務帳戶必須具備下列其中一個角色：

storage.objectAdmin Identity and Access Management (IAM) 角色
自訂角色，包括下列權限：
- storage.objects.create
- storage.objects.list (僅限平行匯出檔案)
- storage.objects.delete (僅限平行匯出檔案)

如需有關 IAM 角色的說明，請參閱「身分與存取權管理」。

並行將資料匯出至多個檔案

您可以並行從 Cloud SQL 匯出多個檔案中的資料至 Cloud Storage。如要執行這項操作，請使用 pg_dump 公用程式搭配 --jobs 選項。

如果您打算將資料匯入 Cloud SQL，請按照「從外部資料庫伺服器匯出資料」一文中的操作說明，正確設定檔案格式以便匯入至 Cloud SQL。

gcloud

如要平行匯出 Cloud SQL 中的資料至多個檔案，請完成下列步驟：

建立 Cloud Storage 值區。
注意： 您不必在儲存桶中建立資料夾。如果資料夾不存在，Cloud SQL 會在匯出多個檔案的過程中為您建立資料夾。不過，如果資料夾已存在，則該資料夾必須是空白資料夾，否則匯出作業會失敗。
如要找出要匯出檔案的 Cloud SQL 執行個體服務帳戶，請使用
gcloud sql instances describe 指令。
```
gcloud sql instances describe INSTANCE_NAME
```

將 INSTANCE_NAME 改成 Cloud SQL 執行個體的名稱。

在輸出內容中，找出與 serviceAccountEmailAddress 欄位相關聯的值。

如要將 storage.objectAdmin 身分與存取權管理角色授予服務帳戶，請使用 gcloud storage buckets add-iam-policy-binding 指令。如需設定 IAM 權限的說明，請參閱「使用 IAM 權限」一文。
如要並行從 Cloud SQL 匯出資料至多個檔案，請使用 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
```
請將以下項目改為對應的值：
- INSTANCE_NAME：要並行匯出檔案的 Cloud SQL 執行個體名稱。
- BUCKET_NAME：Cloud Storage 值區的名稱。
- BUCKET_PATH：匯出檔案儲存的 bucket 路徑。
- FOLDER_NAME：匯出檔案的儲存資料夾。
- THREAD_NUMBER：Cloud SQL 用於平行匯出檔案的執行緒數。舉例來說，如果您想一次並行匯出三個檔案，請將 3 指定為此參數的值。
- DATABASE_NAME (選用)：Cloud SQL 執行個體內的資料庫名稱，匯出作業會從這裡執行。如果您未指定資料庫，Cloud SQL 會從執行個體匯出所有使用者資料庫。詳情請參閱「匯出整個執行個體」
- TABLE_EXPRESSION：從指定資料庫匯出的資料表。
注意： 如果您想使用無伺服器匯出功能，最多可使用 2 個執行緒，請使用 offload 參數。如要並行匯出多個檔案，請使用 parallel 參數。否則，請從指令中移除這些參數。

export sql 指令不含觸發條件或預存程序，但包含視圖。如要匯出觸發事件或儲存程序，請使用單一執行緒進行匯出。這個執行緒使用 pg_dump 工具。

匯出完成後，Cloud Storage 值區中的資料夾應會包含 pg_dump 目錄格式的檔案。
如果您不需要在「從 PostgreSQL 適用的 Cloud SQL 匯出資料所需的角色和權限」一文中設定的 IAM 角色，請撤銷該角色。

REST v1

如要平行匯出 Cloud SQL 中的資料至多個檔案，請完成下列步驟：

建立 Cloud Storage 值區：
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
請進行下列替換：
- BUCKET_NAME：值區名稱，必須遵守命名規定。例如：my-bucket。
- PROJECT_NAME：包含您要建立的 Cloud Storage 值區的 Google Cloud 專案名稱。
- LOCATION_NAME：您要儲存匯出檔案的值區位置。例如：us-east1。
注意： 您不必在儲存桶中建立資料夾。如果資料夾不存在，Cloud SQL 會在匯出多個檔案的過程中為您建立資料夾。不過，如果資料夾已存在，則該資料夾必須是空白資料夾，否則匯出作業會失敗。
為執行個體提供值區的 legacyBucketWriter IAM 角色。如需設定身分與存取權管理權限的相關說明，請參閱「使用身分與存取權管理權限」一文。
並行從 Cloud SQL 匯出資料至多個檔案：

使用任何要求資料之前，請先替換以下項目：
- PROJECT_NAME：包含您建立的 Cloud Storage 值區的 Google Cloud 專案名稱。
- INSTANCE_NAME：要並行匯出檔案的 Cloud SQL 執行個體名稱。
- BUCKET_NAME：Cloud Storage 值區的名稱。
- BUCKET_PATH：匯出檔案儲存的 bucket 路徑。
- FOLDER_NAME：匯出檔案的儲存資料夾。
- DATABASE_NAME：Cloud SQL 執行個體內資料庫的名稱，匯出作業會從這裡執行。如果您想從執行個體匯出所有使用者資料庫，請從要求主體中移除這個欄位。
- THREAD_NUMBER：Cloud SQL 用於平行匯出檔案的執行緒數量。舉例來說，如果您想一次並行匯出三個檔案，請將 3 指定為此參數的值。
注意： offload 參數可讓您使用無伺服器匯出功能，最多可用於 2 個執行緒。parallel 參數可讓您同時匯出多個檔案。如要使用這些功能，請將這些參數的值設為 TRUE。否則，請將其值設為 FALSE。
HTTP 方法和網址：
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/instances/INSTANCE_NAME/export
```
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]
       }
   }
}
```
如要傳送要求，請展開以下其中一個選項：
curl (Linux、macOS 或 Cloud Shell)

注意：以下指令假設您已使用使用者帳戶登入 gcloud CLI，方法是執行 gcloud init 或 gcloud auth login，或是使用 Cloud Shell，後者會自動登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：
```
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)

注意：下列指令假設您已透過執行 gcloud init 或 gcloud auth login 登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：
```
$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
```
您應該會收到如下的 JSON 回應：
回應
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "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"
}
```

匯出完成後，Cloud Storage 值區中的資料夾應會包含 pg_dump 目錄格式的檔案。

如果您不需要在「從 PostgreSQL 適用的 Cloud SQL 匯出資料所需的角色和權限」一節中設定的 IAM 角色，請撤銷該角色。

如需要求的完整參數清單，請參閱 Cloud SQL Administration API 頁面。

REST v1beta4

如要平行匯出 Cloud SQL 中的資料至多個檔案，請完成下列步驟：

建立 Cloud Storage 值區：
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
請進行下列替換：
- BUCKET_NAME：值區名稱，必須遵守命名規定。例如：my-bucket。
- PROJECT_NAME：包含您要建立的 Cloud Storage 值區的 Google Cloud 專案名稱。
- LOCATION_NAME：您要儲存匯出檔案的值區位置。例如：us-east1。
注意： 您不必在儲存桶中建立資料夾。如果資料夾不存在，Cloud SQL 會在匯出多個檔案的過程中為您建立資料夾。不過，如果資料夾已存在，則該資料夾必須是空白資料夾，否則匯出作業會失敗。
為執行個體提供值區的 storage.objectAdmin IAM 角色。如需設定身分與存取權管理權限的相關說明，請參閱「使用身分與存取權管理權限」一文。
並行從 Cloud SQL 匯出資料至多個檔案：

使用任何要求資料之前，請先替換以下項目：
- PROJECT_NAME：包含您建立的 Cloud Storage 值區的 Google Cloud 專案名稱。
- INSTANCE_NAME：要並行匯出檔案的 Cloud SQL 執行個體名稱。
- BUCKET_NAME：Cloud Storage 值區的名稱。
- BUCKET_PATH：匯出檔案儲存的 bucket 路徑。
- FOLDER_NAME：匯出檔案的儲存資料夾。
- DATABASE_NAME：Cloud SQL 執行個體內資料庫的名稱，匯出作業會從這裡執行。如要從執行個體匯出所有使用者資料庫，請從要求主體中移除這個欄位。
- THREAD_NUMBER：Cloud SQL 用於平行匯出檔案的執行緒數量。舉例來說，如果您想一次並行匯出三個檔案，請將 3 指定為此參數的值。
注意： offload 參數可讓您使用無伺服器匯出功能，最多可用於 2 個執行緒。parallel 參數可讓您同時匯出多個檔案。如要使用這些功能，請將這些參數的值設為 TRUE。否則，請將其值設為 FALSE。
HTTP 方法和網址：
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/instances/INSTANCE_NAME/export
```
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]
       }
   }
}
```
如要傳送要求，請展開以下其中一個選項：
curl (Linux、macOS 或 Cloud Shell)

注意：以下指令假設您已使用使用者帳戶登入 gcloud CLI，方法是執行 gcloud init 或 gcloud auth login，或是使用 Cloud Shell，後者會自動登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：
```
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)

注意：下列指令假設您已透過執行 gcloud init 或 gcloud auth login 登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：
```
$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
```
您應該會收到如下的 JSON 回應：
回應
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "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"
}
```

匯出完成後，Cloud Storage 值區中的資料夾應會包含 pg_dump 目錄格式的檔案。

如果您不需要在「從 PostgreSQL 適用的 Cloud SQL 匯出資料所需的角色和權限」一文中設定的 IAM 角色，請撤銷該角色。

如需此要求的完整參數清單，請參閱 Cloud SQL Administration API 頁面。

匯出及匯入整個執行個體

您可以使用目錄格式的平行匯出功能，匯出或匯入整個執行個體中的所有使用者資料庫。

如要匯出或匯入整個執行個體，請使用平行匯出和平行匯入部分所示的相同指令，分別移除 databases 或 database 欄位。如果您未指定資料庫，Cloud SQL 會為執行個體中的所有使用者資料庫執行平行匯出或匯入作業。這項政策不包含用於管理內部作業的系統資料庫和 Cloud SQL 資料庫。

在以目錄格式並行匯出至 Cloud Storage 的情況下，匯出作業完成後，與每個資料庫相關聯的資料會儲存在以每個資料庫命名的子目錄中，如下所示：

gs://example-bucket/test-folder/
    |---- postgres/
    |    |---- 3929.dat.gz (table data file)
    |    |---- toc.dat (metadata file)
    |
    |---- second_database/
    |    |---- 3930.dat.gz
    |    |---- 3931.dat.gz
    |    |---- toc.dat

如果您想為整個執行個體執行平行匯入作業，且執行個體的檔案是在 Cloud SQL 外部建立，則必須使用這個子目錄結構，才能順利完成作業。

偵測到整個例項傾印結構時，系統會忽略 API 中指定的匯入資料庫。這項作業會根據目錄名稱偵測整個例項的結構。

您無法針對其他檔案格式執行整個執行個體匯出或匯入作業。

您無法將整個執行個體匯出或匯入為單一 SQL 檔案或 CSV 檔案。

將資料從多個檔案並行匯入 PostgreSQL 適用的 Cloud SQL

以下各節說明如何從多個檔案並行匯入資料至 PostgreSQL 適用的 Cloud SQL。

從多個檔案並行匯入 PostgreSQL 適用的 Cloud SQL 資料時，所需的角色和權限

如要將資料從 Cloud Storage 匯入至 Cloud SQL，啟動匯入作業的使用者必須具備下列其中一個角色：

Cloud SQL 管理員角色
自訂角色，包括下列權限：
- cloudsql.instances.get
- cloudsql.instances.import

此外，Cloud SQL 執行個體的服務帳戶必須具備下列其中一個角色：

storage.objectAdmin IAM 角色
自訂角色，包括下列權限：
- storage.objects.get
- storage.objects.list (僅限平行匯入檔案)

如需有關 IAM 角色的說明，請參閱「身分與存取權管理」。

將資料匯入 PostgreSQL 適用的 Cloud SQL

您可以從位於 Cloud Storage 的多個檔案，平行匯入資料至資料庫。如要執行這項操作，請使用 pg_restore 公用程式搭配 --jobs 選項。

gcloud

如要將多個檔案的資料平行匯入至 Cloud SQL，請完成下列步驟：

建立 Cloud Storage 值區。
將檔案上傳至值區。

注意： 請確認上傳的檔案採用 pg_dump 目錄格式。詳情請參閱「平行匯出多個檔案中的資料」。

如需將檔案上傳至值區的說明，請參閱「從檔案上傳物件」。
如要找出要匯入檔案的 Cloud SQL 執行個體的服務帳戶，請使用
gcloud sql instances describe 指令。
```
gcloud sql instances describe INSTANCE_NAME
```

將 INSTANCE_NAME 改成 Cloud SQL 執行個體的名稱。

在輸出內容中，找出與 serviceAccountEmailAddress 欄位相關聯的值。

如要將 storage.objectAdmin 身分與存取權管理角色授予服務帳戶，請使用 gcloud storage buckets add-iam-policy-binding 公用程式。如需設定 IAM 權限的說明，請參閱「使用身分與存取權管理權限」。
如要將多個檔案的資料平行匯入至 Cloud SQL，請使用 gcloud sql import sql 指令：
```
gcloud sql import sql INSTANCE_NAME gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME \
--parallel \ 
--threads=THREAD_NUMBER \
--database=DATABASE_NAME
```
請將以下項目改為對應的值：
- INSTANCE_NAME：您要並行匯入檔案的 Cloud SQL 執行個體名稱。
- BUCKET_NAME：Cloud Storage 值區的名稱。
- BUCKET_PATH：匯入檔案儲存的 bucket 路徑。
- FOLDER_NAME：匯入檔案的儲存資料夾。
- THREAD_NUMBER：Cloud SQL 用於並行匯入檔案的執行緒數。舉例來說，如果您想一次並行匯入三個檔案，請將 3 指定為此參數的值。
- DATABASE_NAME：Cloud SQL 執行個體內資料庫的名稱，匯入作業會從這裡執行。您只能指定一個資料庫。
注意： 如要平行匯入多個檔案，請使用 parallel 參數。

如果您使用 parallel 參數，且想在重新建立資料庫物件前先刪除 (清除) 這些物件，請使用 clean 參數。如果您使用 parallel 參數，且想在 clean 參數產生的每個 DROP 陳述式中加入 IF EXISTS SQL 陳述式，請使用 if-exists 參數。

否則請從指令中移除這些參數。

如果指令傳回類似 ERROR_RDBMS 的錯誤，請重新檢視權限，因為這個錯誤通常是因權限問題所致。
如果您不需要在「將資料匯入 PostgreSQL 適用的 Cloud SQL 所需的角色和權限」中設定的 IAM 權限，請使用 gcloud storage buckets remove-iam-policy-binding 將這些權限移除。

REST v1

如要將多個檔案的資料平行匯入至 Cloud SQL，請完成下列步驟：

建立 Cloud Storage 值區：
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
請進行下列替換：
- BUCKET_NAME：值區名稱，必須遵守命名規定。例如：my-bucket。
- PROJECT_NAME：包含您要建立的 Cloud Storage 值區的 Google Cloud 專案名稱。
- LOCATION_NAME：您要儲存匯入檔案的值區位置。例如：us-east1。
將檔案上傳至值區。

注意： 請確認上傳的檔案採用 pg_dump 目錄格式。詳情請參閱「平行匯出多個檔案中的資料」。

如需將檔案上傳至值區的說明，請參閱「從檔案上傳物件」。
為執行個體提供值區的 storage.objectAdmin IAM 角色。如需設定 IAM 權限的說明，請參閱「使用 IAM 權限」。
將多個檔案的資料平行匯入至 Cloud SQL：

使用任何要求資料之前，請先替換以下項目：
- PROJECT_NAME：包含您建立的 Cloud Storage 值區的 Google Cloud 專案名稱。
- INSTANCE_NAME：您要並行匯入檔案的 Cloud SQL 執行個體名稱。
- BUCKET_NAME：Cloud Storage 值區的名稱。
- BUCKET_PATH：匯入檔案儲存的 bucket 路徑。
- FOLDER_NAME：匯入檔案的儲存資料夾。
- DATABASE_NAME：Cloud SQL 執行個體內資料庫的名稱，匯入作業會從這裡執行。您只能指定一個資料庫。
- THREAD_NUMBER：Cloud SQL 用於平行匯入檔案的執行緒數。舉例來說，如果您想一次並行匯入三個檔案，請將 3 指定為此參數的值。
注意： offload 參數可讓您使用最多 2 個執行緒的無伺服器匯入功能。parallel 參數可讓您同時匯入多個檔案。
如果您使用 parallel 參數，clean 參數可讓您在重新建立資料庫物件前先刪除 (清除) 資料庫物件。如果您使用 parallel 參數，ifExists 參數可讓您在 clean 參數產生的每個 DROP 陳述式中加入 IF EXISTS SQL 陳述式。

如要使用這些功能，請將這些參數的值設為 TRUE。否則，請將其值設為 FALSE。

HTTP 方法和網址：
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/instances/INSTANCE_NAME/import
```
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]
        }
    }
 }
```
如要傳送要求，請展開以下其中一個選項：
curl (Linux、macOS 或 Cloud Shell)

注意：以下指令假設您已使用使用者帳戶登入 gcloud CLI，方法是執行 gcloud init 或 gcloud auth login，或是使用 Cloud Shell，後者會自動登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：
```
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)

注意：下列指令假設您已透過執行 gcloud init 或 gcloud auth login 登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：
```
$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
```
您應該會收到如下的 JSON 回應：
回應
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "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"
}
```
如要使用不同的使用者匯入，請指定 importContext.importUser 屬性。
如需此要求的完整參數清單，請參閱 Cloud SQL Admin API 頁面。
如果您不需要在「匯入 PostgreSQL 適用的 Cloud SQL 時所需的角色和權限」中設定的 IAM 權限，請使用 gcloud storage buckets remove-iam-policy-binding 將其移除。

REST v1beta4

如要將多個檔案的資料平行匯入至 Cloud SQL，請完成下列步驟：

建立 Cloud Storage 值區：
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
請進行下列替換：
- BUCKET_NAME：值區名稱，必須遵守命名規定。例如：my-bucket。
- PROJECT_NAME：包含您要建立的 Cloud Storage 值區的 Google Cloud 專案名稱。
- LOCATION_NAME：您要儲存匯入檔案的值區位置。例如：us-east1。
將檔案上傳至值區。

注意： 請確認上傳的檔案採用 pg_dump 目錄格式。詳情請參閱「平行匯出多個檔案中的資料」。

如需將檔案上傳至值區的說明，請參閱「從檔案上傳物件」。
為執行個體提供值區的 storage.objectAdmin IAM 角色。如需設定 IAM 權限的說明，請參閱「使用 IAM 權限」。
將多個檔案的資料平行匯入至 Cloud SQL：

使用任何要求資料之前，請先替換以下項目：
- PROJECT_NAME：包含您建立的 Cloud Storage 值區的 Google Cloud 專案名稱。
- INSTANCE_NAME：您要並行匯入檔案的 Cloud SQL 執行個體名稱。
- BUCKET_NAME：Cloud Storage 值區的名稱。
- BUCKET_PATH：匯入檔案儲存的 bucket 路徑。
- FOLDER_NAME：匯入檔案的儲存資料夾。
- DATABASE_NAME：Cloud SQL 執行個體內資料庫的名稱，匯入作業會從這裡執行。您只能指定一個資料庫。
- THREAD_NUMBER：Cloud SQL 用於平行匯入檔案的執行緒數。舉例來說，如果您想一次並行匯入三個檔案，請將 3 指定為此參數的值。
注意： offload 參數可讓您使用最多 2 個執行緒的無伺服器匯入功能。parallel 參數可讓您同時匯入多個檔案。
如果您使用 parallel 參數，clean 參數可讓您在重新建立資料庫物件前先刪除 (清除) 資料庫物件。如果您使用 parallel 參數，ifExists 參數可讓您在 clean 參數產生的每個 DROP 陳述式中加入 IF EXISTS SQL 陳述式。

如要使用這些功能，請將這些參數的值設為 TRUE。否則，請將其值設為 FALSE。

HTTP 方法和網址：
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/instances/INSTANCE_NAME/import
```
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]
         }
     }
  }
```
如要傳送要求，請展開以下其中一個選項：
curl (Linux、macOS 或 Cloud Shell)

注意：以下指令假設您已使用使用者帳戶登入 gcloud CLI，方法是執行 gcloud init 或 gcloud auth login，或是使用 Cloud Shell，後者會自動登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：
```
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)

注意：下列指令假設您已透過執行 gcloud init 或 gcloud auth login 登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：
```
$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
```
您應該會收到如下的 JSON 回應：
回應
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "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"
}
```
如要使用不同的使用者匯入，請指定 importContext.importUser 屬性。
如需此要求的完整參數清單，請參閱 Cloud SQL Admin API 頁面。
如果您不需要在「將資料匯入 PostgreSQL 適用的 Cloud SQL 所需的角色和權限」中設定的 IAM 權限，請使用 gcloud storage buckets remove-iam-policy-binding 將這些權限移除。

限制

如果您在平行匯入或匯出多個檔案的資料時，指定太多執行緒，可能會使用比 Cloud SQL 執行個體更多記憶體。如果發生這種情況，系統會顯示內部錯誤訊息。檢查執行個體的記憶體用量，並視需要增加執行個體的大小。詳情請參閱「關於執行個體設定」。
執行匯出作業時，系統不支援 databases 或 tables 欄位中資料庫名稱或資料表名稱中的逗號。
請確認磁碟空間足以下載初始傾印檔案。否則會顯示 no space left on disk 錯誤。
如果執行個體只有一個虛擬 CPU (vCPU)，則無法並行匯入或匯出多個檔案。執行個體的 vCPU 數量不得少於用於匯入或匯出作業的執行緒數量，且執行緒數量至少須為 2。

pg_dump 公用程式無法分割您匯出的任何資料表。因此，如果您有一個非常大的資料表，則該資料表可能會成為匯出作業速度的瓶頸。

並行匯出及匯入檔案 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

從 PostgreSQL 適用的 Cloud SQL 匯出資料至多個檔案並進行並行處理

從 PostgreSQL 適用的 Cloud SQL 並行匯出資料至多個檔案時，所需的角色和權限

並行將資料匯出至多個檔案

gcloud

REST v1

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

REST v1beta4

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

匯出及匯入整個執行個體

將資料從多個檔案並行匯入 PostgreSQL 適用的 Cloud SQL

從多個檔案並行匯入 PostgreSQL 適用的 Cloud SQL 資料時，所需的角色和權限

將資料匯入 PostgreSQL 適用的 Cloud SQL

gcloud

REST v1

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

REST v1beta4

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

限制

後續步驟

並行匯出及匯入檔案
透過集合功能整理內容你可以依據偏好儲存及分類內容。