并行导出和导入文件

MySQL   |  PostgreSQL   |  SQL Server

本页面介绍如何将文件并行导出和导入 Cloud SQL 实例。

注意：如果要将整个数据库从支持的数据库服务器（本地、在 AWS 或 Cloud SQL 中）迁移到新的 Cloud SQL 实例，请使用 Database Migration Service，而不是并行导出和导入文件。如果要导出数据以通过导出的文件创建新实例，请考虑通过备份恢复到不同实例或者克隆实例。

您可以通过检查操作的状态来验证多个文件的并行导入或导出操作已成功完成。您还可以取消将数据导入 Cloud SQL 实例以及从实例中导出数据。如需详细了解如何取消导入或导出操作，请参阅取消导入和导出数据。

须知事项

在开始导出或导入操作之前，请先做好以下准备工作：

• 确保您的数据库具有足够的可用空间。

导出和导入操作会使用数据库资源，但不会干扰典型的数据库操作，除非实例预配不足。

重要提示：开始大型操作之前，请确保实例上至少 25% 的磁盘可用。这样做有助于防止发生激进自动增长问题，这些问题可能对实例的可用性造成不利影响。
• 遵循导出和导入数据的最佳做法。
• 完成导入操作后，请验证结果。

将数据从 Cloud SQL for PostgreSQL 并行导出到多个文件

以下部分介绍如何将数据从 Cloud SQL for PostgreSQL 并行导出到多个文件。

将数据从 Cloud SQL for PostgreSQL 并行导出到多个文件所需的角色和权限

如需将数据从 Cloud SQL 导出到 Cloud Storage 中，启动导出的用户必须拥有以下角色之一：

• Cloud SQL Editor 角色
• 包括以下权限的自定义角色：
  • 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。

注意：您对 IAM 权限和角色所做的更改可能需要几分钟才能生效。如需了解详情，请参阅访问权限更改传播。

将数据并行导出到多个文件

您可以将 Cloud SQL 中多个文件中的数据并行导出到 Cloud Storage。为此，请将 pg_dump 实用程序与 --jobs 选项搭配使用。

如果您打算将数据导入 Cloud SQL，请按照从外部数据库服务器导出数据中的说明操作，以便使文件格式适合 Cloud SQL。

注意：如果您的数据包含大型对象 (blob)，则导出可能会占用大量内存，从而影响实例性能。如需帮助，请参阅导入和导出数据的问题。

gcloud

如需将数据从 Cloud SQL 并行导出到多个文件，请完成以下步骤：

1. 创建 Cloud Storage 存储桶。

   注意：您无需在存储桶中创建文件夹。如果文件夹不存在，则 Cloud SQL 会在并行导出多个文件的过程中为您创建该文件夹。但是，如果文件夹存在，则它必须为空，否则导出操作将失败。

2. 如需查找要导出文件的 Cloud SQL 实例的服务账号，请使用
   gcloud sql instances describe 命令。

   gcloud sql instances describe INSTANCE_NAME
   

将 INSTANCE_NAME 替换为您的 Cloud SQL 实例的名称。

在输出中，查找与 serviceAccountEmailAddress 字段关联的值。

3. 如需向服务账号授予 storage.objectAdmin IAM 角色，请使用 gsutil iam 实用程序。如需有关设置 IAM 权限的帮助，请参阅使用 IAM 权限。
4. 如需将数据从 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：存储导出文件的存储桶的路径。
   • FOLDER_NAME：存储导出文件的文件夹。
   • THREAD_NUMBER：Cloud SQL 用于并行导出文件的线程数。例如，如果要同时导出三个文件，请指定 3 作为此参数的值。
   • DATABASE_NAME：Cloud SQL 实例中的数据库的名称，您将从该数据库执行导出。您只能指定一个数据库。
   • TABLE_EXPRESSION：要从指定数据库导出的表。
   注意：如果您要将无服务器导出用于最多 2 个线程，请使用 offload 参数。如果您要并行导出多个文件，请使用 parallel 参数。否则，请从命令中移除这些参数。

   export sql 命令不包含触发器或存储过程，但包含视图。如需导出触发器或存储过程，请使用单线程进行导出。此线程使用 pg_dump 工具。

   导出完成后，Cloud Storage 存储桶中的文件夹应包含 pg_dump 目录格式的文件。

5. 如果您不需要在从 Cloud SQL for PostgreSQL 导出所需的角色和权限中设置的 IAM 角色，请撤销该角色。

REST v1

如需将数据从 Cloud SQL 并行导出到多个文件，请完成以下步骤：

1. 创建 Cloud Storage 存储桶，请运行以下命令：

   gsutil mb -p PROJECT_NAME -l LOCATION_NAME gs://BUCKET_NAME
   

   进行以下替换：
   • PROJECT_NAME：包含您要创建的 Cloud Storage 存储桶的 Google Cloud 项目的名称。
   • LOCATION_NAME：要存储导出文件的存储桶的位置。例如 us-east1。
   • BUCKET_NAME：存储桶的名称（须遵循命名要求）。例如 my-bucket。

   注意：您无需在存储桶中创建文件夹。如果文件夹不存在，则 Cloud SQL 会在并行导出多个文件的过程中为您创建该文件夹。但是，如果文件夹存在，则它必须为空，否则导出操作将失败。

2. 为您的实例提供存储桶的 legacyBucketWriter IAM 角色。如需有关设置 IAM 权限的帮助，请参阅使用 IAM 权限。

3. 将数据从 Cloud SQL 并行导出到多个文件：

   在使用任何请求数据之前，请先进行以下替换：

   • PROJECT_NAME：包含您创建的 Cloud Storage 存储桶的 Google Cloud 项目的名称。
   • INSTANCE_NAME：要并行导出文件的 Cloud SQL 实例的名称。
   • BUCKET_NAME：Cloud Storage 存储桶的名称。
   • 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": "[e-mail]",
     "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 目录格式的文件。

4. 如果您不需要在从 Cloud SQL for PostgreSQL 导出所需的角色和权限中设置的 IAM 角色，请撤销该角色。

如需查看请求参数的完整列表，请参阅 Cloud SQL Admin API 页面。

REST v1beta4

如需将数据从 Cloud SQL 并行导出到多个文件，请完成以下步骤：

1. 创建 Cloud Storage 存储桶，请运行以下命令：

   gsutil mb -p PROJECT_NAME -l LOCATION_NAME gs://BUCKET_NAME
   

   进行以下替换：
   • PROJECT_NAME：包含您要创建的 Cloud Storage 存储桶的 Google Cloud 项目的名称。
   • LOCATION_NAME：要存储导出文件的存储桶的位置。例如 us-east1。
   • BUCKET_NAME：存储桶的名称（须遵循命名要求）。例如 my-bucket。

   注意：您无需在存储桶中创建文件夹。如果文件夹不存在，则 Cloud SQL 会在并行导出多个文件的过程中为您创建该文件夹。但是，如果文件夹存在，则它必须为空，否则导出操作将失败。

2. 为您的实例提供存储桶的 storage.objectAdmin IAM 角色。如需有关设置 IAM 权限的帮助，请参阅使用 IAM 权限。

3. 将数据从 Cloud SQL 并行导出到多个文件：

   在使用任何请求数据之前，请先进行以下替换：

   • PROJECT_NAME：包含您创建的 Cloud Storage 存储桶的 Google Cloud 项目的名称。
   • INSTANCE_NAME：要并行导出文件的 Cloud SQL 实例的名称。
   • BUCKET_NAME：Cloud Storage 存储桶的名称。
   • 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": "[e-mail]",
     "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 目录格式的文件。

4. 如果您不需要在从 Cloud SQL for PostgreSQL 导出所需的角色和权限中设置的 IAM 角色，请撤销该角色。

如需查看请求参数的完整列表，请参阅 Cloud SQL Admin API 页面。

将多个文件中的数据并行导入 Cloud SQL for PostgreSQL

以下部分介绍如何将多个文件中的数据并行导入 Cloud SQL for PostgreSQL。

将多个文件中的数据并行导入 Cloud SQL for PostgreSQL 所需的角色和权限

如需将数据从 Cloud Storage 导入到 Cloud SQL 中，启动导入的用户必须拥有以下角色之一：

• Cloud SQL Editor 角色
• 包括以下权限的自定义角色：
  • cloudsql.instances.get
  • cloudsql.instances.import

此外，Cloud SQL 实例的服务账号必须拥有以下角色之一：

• storage.objectAdmin IAM 角色
• 包括以下权限的自定义角色：
  • storage.objects.get
  • storage.objects.list（仅用于并行导入文件）

如需有关 IAM 角色的帮助，请参阅 Identity and Access Management。

注意：您对 IAM 权限和角色所做的更改可能需要几分钟才能生效。如需了解详情，请参阅访问权限更改传播。

将数据导入到 Cloud SQL for PostgreSQL

您可以将 Cloud Storage 中多个文件的数据并行导入到数据库中。为此，请将 pg_restore 实用程序与 --jobs 选项搭配使用。

注意：如果您的数据包含大型对象 (blob)，则导入可能会占用大量内存，从而影响实例性能。如需帮助，请参阅导入和导出数据的问题。

gcloud

如需将多个文件中的数据并行导入 Cloud SQL，请完成以下步骤：

1. 创建 Cloud Storage 存储桶。

2. 将文件上传到存储桶。

   注意：请确保您上传的文件采用 pg_dump 目录格式。如需了解详情，请参阅并行导出多个文件中的数据。

   如需有关将文件上传到存储桶方面的帮助，请参阅从文件上传对象。

3. 如需查找要导入文件的 Cloud SQL 实例的服务账号，请使用
   gcloud sql instances describe 命令。

   gcloud sql instances describe INSTANCE_NAME
   

将 INSTANCE_NAME 替换为您的 Cloud SQL 实例的名称。

在输出中，查找与 serviceAccountEmailAddress 字段关联的值。

4. 如需向服务账号授予 storage.objectAdmin IAM 角色，请使用 gsutil iam 实用程序。如需有关设置 IAM 权限的帮助，请参阅使用 IAM 权限。
5. 如需将多个文件中的数据并行导入 Cloud SQL，请使用 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
   

   进行以下替换：

   • INSTANCE_NAME：Cloud SQL 实例的名称，您将向其中并行导入文件。
   • BUCKET_NAME：Cloud Storage 存储桶的名称。
   • BUCKET_PATH：存储导入文件的存储桶的路径。
   • FOLDER_NAME：存储导入文件的文件夹。
   • THREAD_NUMBER：Cloud SQL 用于并行导入文件的线程数。例如，如果要同时导入三个文件，请指定 3 作为此参数的值。
   • DATABASE_NAME：Cloud SQL 实例中的数据库的名称，您将从该数据库执行导入。您只能指定一个数据库。
   注意：如果您要将无服务器导入用于最多 2 个线程，请使用 offload 参数。如果您要并行导入多个文件，请使用 parallel 参数。否则，请从命令中移除这些参数。

   如果该命令返回 ERROR_RDBMS 之类的错误，请检查权限；此类错误通常是由权限问题导致的。

6. 如果您不需要在导入 Cloud SQL for PostgreSQL 所需的角色和权限中设置的 IAM 权限，请使用 gsutil iam 移除相应权限。

REST v1

如需将多个文件中的数据并行导入 Cloud SQL，请完成以下步骤：

1. 创建 Cloud Storage 存储桶，请运行以下命令：

   gsutil mb -p PROJECT_NAME -l LOCATION_NAME gs://BUCKET_NAME
   

   进行以下替换：
   • PROJECT_NAME：包含您要创建的 Cloud Storage 存储桶的 Google Cloud 项目的名称。
   • LOCATION_NAME：要存储导入文件的存储桶的位置。例如 us-east1。
   • BUCKET_NAME：存储桶的名称（须遵循命名要求）。例如 my-bucket。

2. 将文件上传到存储桶。

   注意：请确保您上传的文件采用 pg_dump 目录格式。如需了解详情，请参阅并行导出多个文件中的数据。

   如需有关将文件上传到存储桶方面的帮助，请参阅从文件上传对象。

3. 为您的实例提供存储桶的 storage.objectAdmin IAM 角色。如需有关设置 IAM 权限的帮助，请参阅使用 IAM 权限。

4. 将多个文件中的数据并行导入 Cloud SQL：

   在使用任何请求数据之前，请先进行以下替换：

   • PROJECT_NAME：包含您创建的 Cloud Storage 存储桶的 Google Cloud 项目的名称。
   • INSTANCE_NAME：Cloud SQL 实例的名称，您将向其中并行导入文件。
   • BUCKET_NAME：Cloud Storage 存储桶的名称。
   • 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/import

   请求 JSON 正文：

   {
    "importContext":
      {
         "fileType": "SQL",
         "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
         "databases": ["DATABASE_NAME"],
         "offload": [TRUE|FALSE],
         "sqlImportOptions": {
           "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/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": "[e-mail]",
     "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 页面。
5. 如果您不需要在导入 Cloud SQL for PostgreSQL 所需的角色和权限中设置的 IAM 权限，请使用 gsutil iam 移除相应权限。

REST v1beta4

如需将多个文件中的数据并行导入 Cloud SQL，请完成以下步骤：

1. 创建 Cloud Storage 存储桶，请运行以下命令：

   gsutil mb -p PROJECT_NAME -l LOCATION_NAME gs://BUCKET_NAME
   

   进行以下替换：
   • PROJECT_NAME：包含您要创建的 Cloud Storage 存储桶的 Google Cloud 项目的名称。
   • LOCATION_NAME：要存储导入文件的存储桶的位置。例如 us-east1。
   • BUCKET_NAME：存储桶的名称（须遵循命名要求）。例如 my-bucket。

2. 将文件上传到存储桶。

   注意：请确保您上传的文件采用 pg_dump 目录格式。如需了解详情，请参阅并行导出多个文件中的数据。

   如需有关将文件上传到存储桶方面的帮助，请参阅从文件上传对象。

3. 为您的实例提供存储桶的 storage.objectAdmin IAM 角色。如需有关设置 IAM 权限的帮助，请参阅使用 IAM 权限。

4. 将多个文件中的数据并行导入 Cloud SQL：

   在使用任何请求数据之前，请先进行以下替换：

   • PROJECT_NAME：包含您创建的 Cloud Storage 存储桶的 Google Cloud 项目的名称。
   • INSTANCE_NAME：Cloud SQL 实例的名称，您将从其并行导入文件。
   • BUCKET_NAME：Cloud Storage 存储桶的名称。
   • 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/import

   请求 JSON 正文：

   {
    "importContext":
      {
         "fileType": "SQL",
         "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
         "databases": ["DATABASE_NAME"],
         "offload": [TRUE|FALSE],
         "sqlImportOptions": {
           "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/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": "[e-mail]",
     "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 页面。
5. 如果您不需要在导入 Cloud SQL for PostgreSQL 所需的角色和权限中设置的 IAM 权限，请使用 gsutil iam 移除相应权限。

限制

• 如果在并行导入或导出多个文件中的数据时指定过多线程，则内存用量可能会超过 Cloud SQL 实例拥有的内存。如果发生这种情况，系统会显示内部错误消息。请检查实例的内存用量，并根据需要增加实例的大小。如需了解详情，请参阅实例设置简介。
• 执行导出时，不支持在 databases 或 tables 字段中的数据库名称或表名称中使用英文逗号。
• 请确保您有足够的磁盘可用空间用于下载初始转储文件。否则，系统会显示 no space left on disk 错误。
• 如果实例只有一个虚拟 CPU (vCPU)，则无法并行导入或导出多个文件。实例的 vCPU 数不能小于用于导入或导出操作的线程数，并且线程数必须至少为 2。
• pg_dump 实用程序无法对导出的任何表进行分块。因此，如果您的表非常大，则可能会成为导出操作速度的瓶颈。

后续步骤

• 了解如何查看导入和导出操作的状态。
• 了解如何取消导入和导出数据。
• 了解导入和导出数据的最佳实践。
• 了解导入和导出的已知问题。