本頁面的部分或所有資訊可能不適用於 S3NS 的 Cloud de Confiance。詳情請參閱「與 Google Cloud 的差異」。

Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

並行匯出及匯入檔案

MySQL | PostgreSQL

本頁面說明如何將檔案平行匯出及匯入 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 角色的相關協助，請參閱「Identity and Access Management」。

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

您可以從 Cloud SQL 中的多個檔案，平行匯出資料至 Cloud Storage。gcloud sql export 函式搭配 -parallel 旗標，使用 pg_dump 公用程式搭配 --jobs 選項，從多個檔案匯出。

如果您打算將資料匯入 Cloud SQL，請按照「從外部資料庫伺服器匯出資料」一文的操作說明，確保檔案格式正確，可供 Cloud SQL 使用。

從 Cloud SQL 平行匯出的檔案會壓縮兩次。雖然您可以將這些檔案匯回 Cloud SQL，而不進行任何修改，但如果您想使用開放原始碼 pg_dump 公用程式將檔案匯入其他資料庫，則必須先解壓縮檔案。

gcloud

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

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

將 INSTANCE_NAME 替換為 Cloud SQL 執行個體名稱。

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

如要將 storage.objectAdmin IAM 角色授予服務帳戶，請使用 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 的名稱。
- BUCKET_PATH：儲存匯出檔案的值區路徑。
- FOLDER_NAME：儲存匯出檔案的資料夾。
- THREAD_NUMBER：Cloud SQL 用於平行匯出檔案的執行緒數量。舉例來說，如要同時匯出三個檔案，請將這個參數的值指定為 3。
- DATABASE_NAME (選用)：Cloud SQL 執行個體中要匯出資料的資料庫名稱。如未指定資料庫，Cloud SQL 會從執行個體匯出所有使用者資料庫。詳情請參閱「匯出整個執行個體」
- TABLE_EXPRESSION：要從指定資料庫匯出的資料表。
注意：如要使用無伺服器匯出功能，最多可使用 2 個執行緒，請使用 offload 參數。如要同時匯出多個檔案，請使用 parallel 參數。否則，請從指令中移除這些參數。

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

REST v1

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

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

使用任何要求資料之前，請先修改下列項目的值：
- PROJECT_NAME： Cloud de Confiance by S3NS 專案的名稱，其中包含您建立的 Cloud Storage bucket。
- INSTANCE_NAME：要平行匯出檔案的 Cloud SQL 執行個體名稱。
- BUCKET_NAME：Cloud Storage bucket 的名稱。
- BUCKET_PATH：儲存匯出檔案的值區路徑。
- 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 init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 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": "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"
}
```

匯出完成後，Cloud Storage bucket 中應該會有一個資料夾，其中包含 pg_dump 目錄格式的檔案。

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

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

REST v1beta4

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

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

使用任何要求資料之前，請先修改下列項目的值：
- PROJECT_NAME： Cloud de Confiance by S3NS 專案的名稱，其中包含您建立的 Cloud Storage bucket。
- INSTANCE_NAME：要平行匯出檔案的 Cloud SQL 執行個體名稱。
- BUCKET_NAME：Cloud Storage bucket 的名稱。
- BUCKET_PATH：儲存匯出檔案的值區路徑。
- 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 init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 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": "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"
}
```

匯出完成後，Cloud Storage bucket 中應會出現一個資料夾，內含 pg_dump 目錄格式的檔案。

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

如需完整的請求參數清單，請參閱 Cloud SQL Admin 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 角色的相關協助，請參閱「Identity and Access Management」。

將資料匯入 PostgreSQL 適用的 Cloud SQL

您可以從 Cloud Storage 中的多個檔案，平行匯入資料至資料庫。方法是使用 pg_restore 公用程式搭配 --jobs 選項。

gcloud

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

建立 Cloud Storage bucket。
將檔案上傳至 bucket。

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

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

將 INSTANCE_NAME 替換為 Cloud SQL 執行個體名稱。

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

如要將 storage.objectAdmin IAM 角色授予服務帳戶，請使用 gcloud storage buckets add-iam-policy-binding 公用程式。如需設定 IAM 權限的相關說明，請參閱「使用 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 的名稱。
- BUCKET_PATH：儲存匯入檔案的值區路徑。
- 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 bucket：
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
進行下列替換：
- BUCKET_NAME：bucket 名稱，須符合命名規定。例如：my-bucket。
- PROJECT_NAME： Cloud de Confiance by S3NS 專案的名稱，其中包含您要建立的 Cloud Storage bucket。
- LOCATION_NAME：要儲存匯入檔案的 bucket 位置。例如：us-east1。
將檔案上傳至 bucket。

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

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

使用任何要求資料之前，請先修改下列項目的值：
- PROJECT_NAME： Cloud de Confiance by S3NS 專案的名稱，其中包含您建立的 Cloud Storage bucket。
- INSTANCE_NAME：要平行匯入檔案的 Cloud SQL 執行個體名稱。
- BUCKET_NAME：Cloud Storage bucket 的名稱。
- BUCKET_PATH：儲存匯入檔案的值區路徑。
- FOLDER_NAME：儲存匯入檔案的資料夾。
- DATABASE_NAME：Cloud SQL 執行個體中要匯入資料的資料庫名稱。您只能指定一個資料庫。
- THREAD_NUMBER：Cloud SQL 用於平行匯入檔案的執行緒數量。舉例來說，如要同時匯入三個檔案，請將這個參數的值設為 3。
注意：offload 參數可讓您使用無伺服器匯入功能，最多可使用 2 個執行緒。parallel 參數可讓您同時匯入多個檔案。
如果使用 parallel 參數，則可透過 clean 參數，在重新建立資料庫物件前，先捨棄 (清除) 這些物件。如果使用 parallel 參數，則可透過 ifExists 參數，將 IF EXISTS SQL 陳述式與 clean 參數產生的每個 DROP 陳述式一併納入。

如要使用這些功能，請將這些參數的值設為 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 init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 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": "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"
}
```
如要使用其他使用者進行匯入，請指定 importContext.importUser 屬性。
如需要求參數的完整清單，請參閱「Cloud SQL Admin API」頁面。
如果您不需要在「匯入 PostgreSQL 適用的 Cloud SQL 所需的角色和權限」中設定的 IAM 權限，請使用 gcloud storage buckets remove-iam-policy-binding 移除這些權限。

REST v1beta4

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

建立 Cloud Storage bucket：
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
進行下列替換：
- BUCKET_NAME：bucket 名稱，須符合命名規定。例如：my-bucket。
- PROJECT_NAME： Cloud de Confiance by S3NS 專案的名稱，其中包含您要建立的 Cloud Storage bucket。
- LOCATION_NAME：要儲存匯入檔案的 bucket 位置。例如：us-east1。
將檔案上傳至 bucket。

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

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

使用任何要求資料之前，請先修改下列項目的值：
- PROJECT_NAME： Cloud de Confiance by S3NS 專案的名稱，其中包含您建立的 Cloud Storage bucket。
- INSTANCE_NAME：要平行匯入檔案的 Cloud SQL 執行個體名稱。
- BUCKET_NAME：Cloud Storage bucket 的名稱。
- BUCKET_PATH：儲存匯入檔案的值區路徑。
- FOLDER_NAME：儲存匯入檔案的資料夾。
- DATABASE_NAME：Cloud SQL 執行個體中要匯入資料的資料庫名稱。您只能指定一個資料庫。
- THREAD_NUMBER：Cloud SQL 用於平行匯入檔案的執行緒數量。舉例來說，如要同時匯入三個檔案，請將這個參數的值設為 3。
注意：offload 參數可讓您使用無伺服器匯入功能，最多可使用 2 個執行緒。parallel 參數可讓您同時匯入多個檔案。
如果使用 parallel 參數，則可透過 clean 參數，在重新建立資料庫物件前，先捨棄 (清除) 這些物件。如果使用 parallel 參數，則可透過 ifExists 參數，將 IF EXISTS SQL 陳述式與 clean 參數產生的每個 DROP 陳述式一併納入。

如要使用這些功能，請將這些參數的值設為 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 init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 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": "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"
}
```
如要使用其他使用者進行匯入，請指定 importContext.importUser 屬性。
如需要求參數的完整清單，請參閱「Cloud SQL Admin API」頁面。
如果您不需要在「將資料匯入 PostgreSQL 適用的 Cloud SQL 所需的角色和權限」中設定的 IAM 權限，請使用 gcloud storage buckets remove-iam-policy-binding 移除這些權限。

限制

如果從多個檔案平行匯入或匯出資料時指定過多執行緒，可能會耗用超過 Cloud SQL 執行個體擁有的記憶體。如果發生這種情況，系統會顯示內部錯誤訊息。請檢查執行個體的記憶體用量，並視需要增加執行個體的大小。詳情請參閱「關於執行個體設定」。
執行匯出作業時，databases 或 tables 欄位中的資料庫名稱或資料表名稱不支援逗號。
請確認您有足夠的磁碟空間，可下載初始 dump 檔案。否則會顯示 no space left on disk 錯誤。
如果執行個體只有一個虛擬 CPU (vCPU)，就無法同時匯入或匯出多個檔案。執行個體的 vCPU 數量不得少於匯入或匯出作業使用的執行緒數量，且執行緒數量至少須為兩個。
多執行緒 (平行) 匯入和匯出與單一執行緒匯入和匯出不相容。舉例來說，單一執行緒匯出作業產生的 dump 檔案，只能由單一執行緒匯入作業匯入。同樣地，平行匯出作業產生的 dump 檔案只能透過平行匯入作業匯入。

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)

回應

限制

後續步驟