Esta página foi traduzida pela API Cloud Translation.

Exportar e importar arquivos em paralelo,Exportar e importar arquivos em paralelo,Exportar e importar arquivos em paralelo,Exportar e importar arquivos em paralelo
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

MySQL | PostgreSQL | SQL Server

Esta página descreve como exportar e importar arquivos para instâncias do Cloud SQL em paralelo.

Antes de começar

Antes de iniciar uma operação de exportação ou importação:

Certifique-se de que seu banco de dados tenha espaço livre adequado.

As operações de exportação e importação usam recursos do banco de dados, mas não interferem nas operações típicas do banco de dados, a menos que a instância esteja subprovisionada.

Siga as melhores práticas para exportar e importar dados.
Após concluir uma operação de importação, verifique os resultados.

Exportar dados do Cloud SQL para PostgreSQL para vários arquivos em paralelo

As seções a seguir contêm informações sobre como exportar dados do Cloud SQL para PostgreSQL para vários arquivos em paralelo.

Funções e permissões necessárias para exportar dados do Cloud SQL para PostgreSQL para vários arquivos em paralelo

Para exportar dados do Cloud SQL para o Cloud Storage, o usuário que inicia a exportação deve ter uma das seguintes funções:

A função Editor do Cloud SQL
Uma função personalizada , incluindo as seguintes permissões:
- cloudsql.instances.get
- cloudsql.instances.export

Além disso, a conta de serviço da instância do Cloud SQL deve ter uma das seguintes funções:

A função storage.objectAdmin Identity and Access Management (IAM)
Uma função personalizada, incluindo as seguintes permissões:
- storage.objects.create
- storage.objects.list (para exportar arquivos apenas em paralelo)
- storage.objects.delete (para exportar arquivos apenas em paralelo)

Para obter ajuda com funções do IAM, consulte Gerenciamento de Identidade e Acesso .

Exportar dados para vários arquivos em paralelo

Você pode exportar dados em paralelo de vários arquivos armazenados no Cloud SQL para o Cloud Storage. Para isso, use o utilitário pg_dump com a opção --jobs .

Se você planeja importar seus dados para o Cloud SQL, siga as instruções fornecidas em Exportar dados de um servidor de banco de dados externo para que seus arquivos sejam formatados corretamente para o Cloud SQL.

gcloud

Para exportar dados do Cloud SQL para vários arquivos em paralelo, conclua as seguintes etapas:

Crie um bucket do Cloud Storage .
Observação: você não precisa criar uma pasta no bucket. Se a pasta não existir, o Cloud SQL a criará para você como parte do processo de exportação de vários arquivos em paralelo. No entanto, se a pasta existir, ela deverá estar vazia, ou a operação de exportação falhará.
Para encontrar a conta de serviço da instância do Cloud SQL da qual você está exportando arquivos, use o
gcloud sql instances describe .
```
gcloud sql instances describe INSTANCE_NAME
```

Substitua INSTANCE_NAME pelo nome da sua instância do Cloud SQL.

Na saída, procure o valor associado ao campo serviceAccountEmailAddress .

Para conceder a função storage.objectAdmin do IAM à conta de serviço, use o comando gcloud storage buckets add-iam-policy-binding . Para obter ajuda na definição de permissões do IAM, consulte Usar permissões do IAM .
Para exportar dados do Cloud SQL para vários arquivos em paralelo, use o comando 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
```
Faça as seguintes substituições:
- INSTANCE_NAME : o nome da instância do Cloud SQL da qual você está exportando arquivos em paralelo.
- BUCKET_NAME : o nome do bucket do Cloud Storage.
- BUCKET_PATH : o caminho para o bucket onde os arquivos de exportação são armazenados.
- FOLDER_NAME : a pasta onde os arquivos de exportação são armazenados.
- THREAD_NUMBER : o número de threads que o Cloud SQL usa para exportar arquivos em paralelo. Por exemplo, se você quiser exportar três arquivos simultaneamente em paralelo, especifique 3 como o valor para este parâmetro.
- DATABASE_NAME (opcional): o nome dos bancos de dados dentro da instância do Cloud SQL da qual a exportação é feita. Se você não especificar um banco de dados, o Cloud SQL exportará todos os bancos de dados de usuários da instância. Para obter mais informações, consulte Exportar uma instância inteira.
- TABLE_EXPRESSION : as tabelas a serem exportadas do banco de dados especificado.
Observação: se você quiser usar exportações sem servidor para até 2 threads, use o parâmetro offload . Se quiser exportar vários arquivos em paralelo, use o parâmetro parallel . Caso contrário, remova esses parâmetros do comando.
O comando export sql não contém gatilhos ou procedimentos armazenados, mas contém visualizações. Para exportar gatilhos ou procedimentos armazenados, use uma única thread para a exportação. Esta thread usa a ferramenta pg_dump .
Após a conclusão da exportação, você deverá ter arquivos em uma pasta no bucket do Cloud Storage no formato de diretório pg_dump .
Se você não precisar da função do IAM definida em Funções e permissões necessárias para exportar do Cloud SQL para PostgreSQL , revogue -a.

REST v1

Para exportar dados do Cloud SQL para vários arquivos em paralelo, conclua as seguintes etapas:

Crie um bucket do Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
Faça as seguintes substituições:
- BUCKET_NAME : o nome do bucket, sujeito aos requisitos de nomenclatura . Por exemplo, my-bucket .
- PROJECT_NAME : o nome do Google Cloud projeto que contém o bucket do Cloud Storage que você está criando.
- LOCATION_NAME : o local do bucket onde você deseja armazenar os arquivos que está exportando. Por exemplo, us-east1 .
Observação: você não precisa criar uma pasta no bucket. Se a pasta não existir, o Cloud SQL a criará para você como parte do processo de exportação de vários arquivos em paralelo. No entanto, se a pasta existir, ela deverá estar vazia, ou a operação de exportação falhará.
Forneça à sua instância a função do IAM " legacyBucketWriter " para o seu bucket. Para obter ajuda com a definição de permissões do IAM, consulte Usar permissões do IAM .
Exporte dados do Cloud SQL para vários arquivos em paralelo:
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
- PROJECT_NAME : o nome do Google Cloud projeto que contém o bucket do Cloud Storage que você criou.
- INSTANCE_NAME : o nome da instância do Cloud SQL da qual você está exportando arquivos em paralelo.
- BUCKET_NAME : o nome do bucket do Cloud Storage.
- BUCKET_PATH : o caminho para o bucket onde os arquivos de exportação são armazenados.
- FOLDER_NAME : a pasta onde os arquivos de exportação são armazenados.
- DATABASE_NAME : o nome do banco de dados dentro da instância do Cloud SQL da qual a exportação é feita. Se você quiser exportar todos os bancos de dados de usuários da instância, remova este campo do corpo da solicitação.
- THREAD_NUMBER : o número de threads que o Cloud SQL usa para exportar arquivos em paralelo. Por exemplo, se você quiser exportar três arquivos simultaneamente em paralelo, especifique 3 como o valor para este parâmetro.
Observação: O parâmetro offload permite que você use exportações sem servidor para até 2 threads. O parâmetro parallel permite exportar vários arquivos em paralelo. Para usar esses recursos, defina os valores desses parâmetros como TRUE . Caso contrário, defina seus valores como FALSE .
Método HTTP e URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/instances/INSTANCE_NAME/export
```
Corpo JSON da solicitação:
```
{
 "exportContext":
   {
      "fileType": "SQL",
      "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
      "databases": ["DATABASE_NAME"],
      "offload": [TRUE|FALSE],
      "sqlExportOptions": {
        "parallel": [TRUE|FALSE],
        "threads": [THREAD_NUMBER]
       }
   }
}
```
Para enviar sua solicitação, expanda uma destas opções:
curl (Linux, macOS ou Cloud Shell)
Observação: o comando a seguir pressupõe que você tenha efetuado login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login , ou usando o Cloud Shell , que efetua login automaticamente na CLI gcloud . Você pode verificar a conta ativa no momento executando gcloud auth list .
Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:
```
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)
Observação: o comando a seguir pressupõe que você tenha efetuado login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Você pode verificar a conta ativa no momento executando gcloud auth list .
Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:
```
$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
```
Você deve receber uma resposta JSON semelhante à seguinte:
Resposta
```
{
  "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"
}
```

Após a conclusão da exportação, você deverá ter arquivos em uma pasta no bucket do Cloud Storage no formato de diretório pg_dump .

Se você não precisar da função do IAM definida em Funções e permissões necessárias para exportar do Cloud SQL para PostgreSQL , revogue -a.

Para obter a lista completa de parâmetros para a solicitação, consulte a página da API de administração do Cloud SQL .

REST v1beta4

Para exportar dados do Cloud SQL para vários arquivos em paralelo, conclua as seguintes etapas:

Crie um bucket do Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
Faça as seguintes substituições:
- BUCKET_NAME : o nome do bucket, sujeito aos requisitos de nomenclatura . Por exemplo, my-bucket .
- PROJECT_NAME : o nome do Google Cloud projeto que contém o bucket do Cloud Storage que você está criando.
- LOCATION_NAME : o local do bucket onde você deseja armazenar os arquivos que está exportando. Por exemplo, us-east1 .
Observação: você não precisa criar uma pasta no bucket. Se a pasta não existir, o Cloud SQL a criará para você como parte do processo de exportação de vários arquivos em paralelo. No entanto, se a pasta existir, ela deverá estar vazia, ou a operação de exportação falhará.
Forneça à sua instância a função storage.objectAdmin do IAM para o seu bucket. Para obter ajuda com a definição de permissões do IAM, consulte Usar permissões do IAM .
Exporte dados do Cloud SQL para vários arquivos em paralelo:
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
- PROJECT_NAME : o nome do Google Cloud projeto que contém o bucket do Cloud Storage que você criou.
- INSTANCE_NAME : o nome da instância do Cloud SQL da qual você está exportando arquivos em paralelo.
- BUCKET_NAME : o nome do bucket do Cloud Storage.
- BUCKET_PATH : o caminho para o bucket onde os arquivos de exportação são armazenados.
- FOLDER_NAME : a pasta onde os arquivos de exportação são armazenados.
- DATABASE_NAME : o nome do banco de dados dentro da instância do Cloud SQL da qual a exportação é feita. Se você quiser exportar todos os bancos de dados de usuários da instância, remova este campo do corpo da solicitação.
- THREAD_NUMBER : o número de threads que o Cloud SQL usa para exportar arquivos em paralelo. Por exemplo, se você quiser exportar três arquivos simultaneamente em paralelo, especifique 3 como o valor para este parâmetro.
Observação: O parâmetro offload permite que você use exportações sem servidor para até 2 threads. O parâmetro parallel permite exportar vários arquivos em paralelo. Para usar esses recursos, defina os valores desses parâmetros como TRUE . Caso contrário, defina seus valores como FALSE .
Método HTTP e URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/instances/INSTANCE_NAME/export
```
Corpo JSON da solicitação:
```
{
 "exportContext":
   {
      "fileType": "SQL",
      "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
      "databases": ["DATABASE_NAME"],
      "offload": [TRUE|FALSE],
      "sqlExportOptions": {
        "parallel": [TRUE|FALSE],
        "threads": [THREAD_NUMBER]
       }
   }
}
```
Para enviar sua solicitação, expanda uma destas opções:
curl (Linux, macOS ou Cloud Shell)
Observação: o comando a seguir pressupõe que você tenha efetuado login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login , ou usando o Cloud Shell , que efetua login automaticamente na CLI gcloud . Você pode verificar a conta ativa no momento executando gcloud auth list .
Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:
```
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)
Observação: o comando a seguir pressupõe que você tenha efetuado login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Você pode verificar a conta ativa no momento executando gcloud auth list .
Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:
```
$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
```
Você deve receber uma resposta JSON semelhante à seguinte:
Resposta
```
{
  "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"
}
```

Após a conclusão da exportação, você deverá ter arquivos em uma pasta no bucket do Cloud Storage no formato de diretório pg_dump .

Se você não precisar da função do IAM definida em Funções e permissões necessárias para exportar do Cloud SQL para PostgreSQL , revogue -a.

Para obter a lista completa de parâmetros para a solicitação, consulte a página da API de administração do Cloud SQL .

Exportar e importar uma instância inteira

Você pode exportar ou importar todos os bancos de dados de usuários em uma instância inteira usando uma exportação paralela formatada em diretório.

Para exportar ou importar uma instância inteira, use os mesmos comandos mostrados nas seções de exportação paralela e importação paralela , removendo os campos databases ou database , respectivamente. Se você não especificar um banco de dados, o Cloud SQL executará uma exportação ou importação paralela para todos os bancos de dados de usuários na instância. Isso exclui os bancos de dados do sistema e os bancos de dados do Cloud SQL usados para gerenciar operações internas.

Em uma exportação paralela formatada em diretório para o Cloud Storage, após a conclusão bem-sucedida da exportação, os dados associados a cada banco de dados são armazenados em um subdiretório nomeado para cada banco de dados, semelhante ao seguinte:

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

Se você quiser executar uma importação paralela para uma instância inteira e os arquivos da instância foram criados fora do Cloud SQL, essa estrutura de subdiretório será necessária para que a operação seja concluída com sucesso.

Quando toda a estrutura de despejo da instância é detectada, o banco de dados de importação especificado na API é ignorado. A operação detecta toda a estrutura da instância a partir do nome do diretório.

Não é possível executar uma exportação ou importação de instância inteira para outros formatos de arquivo.

Não é possível exportar ou importar uma instância inteira como um único arquivo SQL ou CSV.

Importar dados de vários arquivos em paralelo para o Cloud SQL para PostgreSQL

As seções a seguir contêm informações sobre como importar dados de vários arquivos em paralelo para o Cloud SQL para PostgreSQL.

Funções e permissões necessárias para importar dados de vários arquivos em paralelo para o Cloud SQL para PostgreSQL

Para importar dados do Cloud Storage para o Cloud SQL, o usuário que inicia a importação deve ter uma das seguintes funções:

A função de administrador do Cloud SQL
Uma função personalizada , incluindo as seguintes permissões:
- cloudsql.instances.get
- cloudsql.instances.import

Além disso, a conta de serviço da instância do Cloud SQL deve ter uma das seguintes funções:

A função storage.objectAdmin do IAM
Uma função personalizada, incluindo as seguintes permissões:
- storage.objects.get
- storage.objects.list (para importar arquivos apenas em paralelo)

Para obter ajuda com funções do IAM, consulte Gerenciamento de Identidade e Acesso .

Importar dados para o Cloud SQL para PostgreSQL

Você pode importar dados em paralelo de vários arquivos armazenados no Cloud Storage para o seu banco de dados. Para isso, use o utilitário pg_restore com a opção --jobs .

gcloud

Para importar dados de vários arquivos em paralelo para o Cloud SQL, conclua as seguintes etapas:

Crie um bucket do Cloud Storage .
Carregue os arquivos para seu bucket.
Observação: certifique-se de que os arquivos que você está enviando estejam no formato de diretório pg_dump . Para obter mais informações, consulte Exportar dados de vários arquivos em paralelo .
Para obter ajuda com o upload de arquivos para buckets, consulte Upload de objetos de arquivos .
Para encontrar a conta de serviço da instância do Cloud SQL para a qual você está importando arquivos, use o
gcloud sql instances describe .
```
gcloud sql instances describe INSTANCE_NAME
```

Substitua INSTANCE_NAME pelo nome da sua instância do Cloud SQL.

Na saída, procure o valor associado ao campo serviceAccountEmailAddress .

Para conceder a função storage.objectAdmin do IAM à conta de serviço, use o utilitário gcloud storage buckets add-iam-policy-binding . Para obter ajuda na definição de permissões do IAM, consulte Usar permissões do IAM .
Para importar dados de vários arquivos em paralelo para o Cloud SQL, use o comando gcloud sql import sql :
```
gcloud sql import sql INSTANCE_NAME gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME \
--parallel \ 
--threads=THREAD_NUMBER \
--database=DATABASE_NAME
```
Faça as seguintes substituições:
- INSTANCE_NAME : o nome da instância do Cloud SQL para a qual você está importando arquivos em paralelo.
- BUCKET_NAME : o nome do bucket do Cloud Storage.
- BUCKET_PATH : o caminho para o bucket onde os arquivos de importação são armazenados.
- FOLDER_NAME : a pasta onde os arquivos de importação são armazenados.
- THREAD_NUMBER : o número de threads que o Cloud SQL usa para importar arquivos em paralelo. Por exemplo, se você quiser importar três arquivos simultaneamente em paralelo, especifique 3 como o valor para este parâmetro.
- DATABASE_NAME : o nome do banco de dados dentro da instância do Cloud SQL da qual a importação é feita. É necessário especificar apenas um banco de dados.
Nota: Se você quiser importar vários arquivos em paralelo, use o parâmetro parallel .
Se você usar o parâmetro parallel e quiser remover (limpar) objetos do banco de dados antes de recriá-los, use o parâmetro clean . Se você usar o parâmetro parallel e quiser incluir a instrução SQL IF EXISTS em cada instrução DROP produzida pelo parâmetro clean , use o parâmetro if-exists .
Caso contrário, remova esses parâmetros do comando.
Se o comando retornar um erro como ERROR_RDBMS , revise as permissões; esse erro geralmente ocorre devido a problemas de permissões.
Se você não precisar das permissões do IAM definidas em Funções e permissões necessárias para importar para o Cloud SQL para PostgreSQL , use gcloud storage buckets remove-iam-policy-binding para removê-las.

REST v1

Para importar dados de vários arquivos em paralelo para o Cloud SQL, conclua as seguintes etapas:

Crie um bucket do Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
Faça as seguintes substituições:
- BUCKET_NAME : o nome do bucket, sujeito aos requisitos de nomenclatura . Por exemplo, my-bucket .
- PROJECT_NAME : o nome do Google Cloud projeto que contém o bucket do Cloud Storage que você está criando.
- LOCATION_NAME : o local do bucket onde você deseja armazenar os arquivos que está importando. Por exemplo, us-east1 .
Carregue os arquivos para seu bucket.
Observação: certifique-se de que os arquivos que você está enviando estejam no formato de diretório pg_dump . Para obter mais informações, consulte Exportar dados de vários arquivos em paralelo .
Para obter ajuda com o upload de arquivos para buckets, consulte Upload de objetos de arquivos .
Forneça à sua instância a função storage.objectAdmin do IAM para o seu bucket. Para obter ajuda com a definição de permissões do IAM, consulte Usar permissões do IAM .
Importe dados de vários arquivos em paralelo para o Cloud SQL:
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
- PROJECT_NAME : o nome do Google Cloud projeto que contém o bucket do Cloud Storage que você criou.
- INSTANCE_NAME : o nome da instância do Cloud SQL para a qual você está importando arquivos em paralelo.
- BUCKET_NAME : o nome do bucket do Cloud Storage.
- BUCKET_PATH : o caminho para o bucket onde os arquivos de importação são armazenados.
- FOLDER_NAME : a pasta onde os arquivos de importação são armazenados.
- DATABASE_NAME : o nome do banco de dados dentro da instância do Cloud SQL da qual a importação é feita. É necessário especificar apenas um banco de dados.
- THREAD_NUMBER : o número de threads que o Cloud SQL usa para importar arquivos em paralelo. Por exemplo, se você quiser importar três arquivos simultaneamente em paralelo, especifique 3 como o valor para este parâmetro.
Observação: o parâmetro offload permite que você use importações sem servidor para até 2 threads. O parâmetro parallel permite importar vários arquivos em paralelo.
Se você usar o parâmetro parallel , o parâmetro clean permitirá que você descarte (limpe) objetos do banco de dados antes de recriá-los. Se você usar o parâmetro parallel , o parâmetro ifExists permitirá que você inclua a instrução SQL IF EXISTS em cada instrução DROP produzida pelo parâmetro clean .
Para usar esses recursos, defina os valores desses parâmetros como TRUE . Caso contrário, defina os valores como FALSE .
Método HTTP e URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/instances/INSTANCE_NAME/import
```
Corpo JSON da solicitação:
```
{
  "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]
        }
    }
 }
```
Para enviar sua solicitação, expanda uma destas opções:
curl (Linux, macOS ou Cloud Shell)
Observação: o comando a seguir pressupõe que você tenha efetuado login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login , ou usando o Cloud Shell , que efetua login automaticamente na CLI gcloud . Você pode verificar a conta ativa no momento executando gcloud auth list .
Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:
```
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)
Observação: o comando a seguir pressupõe que você tenha efetuado login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Você pode verificar a conta ativa no momento executando gcloud auth list .
Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:
```
$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
```
Você deve receber uma resposta JSON semelhante à seguinte:
Resposta
```
{
  "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"
}
```
Para usar um usuário diferente para a importação, especifique a propriedade importContext.importUser .
Para obter a lista completa de parâmetros para a solicitação, consulte a página da API de administração do Cloud SQL .
Se você não precisar das permissões do IAM definidas em Funções e permissões necessárias para importar para o Cloud SQL para PostgreSQL , use gcloud storage buckets remove-iam-policy-binding para removê-las.

REST v1beta4

Para importar dados de vários arquivos em paralelo para o Cloud SQL, conclua as seguintes etapas:

Crie um bucket do Cloud Storage:
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
Faça as seguintes substituições:
- BUCKET_NAME : o nome do bucket, sujeito aos requisitos de nomenclatura . Por exemplo, my-bucket .
- PROJECT_NAME : o nome do Google Cloud projeto que contém o bucket do Cloud Storage que você está criando.
- LOCATION_NAME : o local do bucket onde você deseja armazenar os arquivos que está importando. Por exemplo, us-east1 .
Carregue os arquivos para seu bucket.
Observação: certifique-se de que os arquivos que você está enviando estejam no formato de diretório pg_dump . Para obter mais informações, consulte Exportar dados de vários arquivos em paralelo .
Para obter ajuda com o upload de arquivos para buckets, consulte Upload de objetos de arquivos .
Forneça à sua instância a função storage.objectAdmin do IAM para o seu bucket. Para obter ajuda com a definição de permissões do IAM, consulte Usar permissões do IAM .
Importe dados de vários arquivos em paralelo para o Cloud SQL:
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
- PROJECT_NAME : o nome do Google Cloud projeto que contém o bucket do Cloud Storage que você criou.
- INSTANCE_NAME : o nome da instância do Cloud SQL da qual você está importando arquivos em paralelo.
- BUCKET_NAME : o nome do bucket do Cloud Storage.
- BUCKET_PATH : o caminho para o bucket onde os arquivos de importação são armazenados.
- FOLDER_NAME : a pasta onde os arquivos de importação são armazenados.
- DATABASE_NAME : o nome do banco de dados dentro da instância do Cloud SQL da qual a importação é feita. É necessário especificar apenas um banco de dados.
- THREAD_NUMBER : o número de threads que o Cloud SQL usa para importar arquivos em paralelo. Por exemplo, se você quiser importar três arquivos simultaneamente em paralelo, especifique 3 como o valor para este parâmetro.
Observação: o parâmetro offload permite que você use importações sem servidor para até 2 threads. O parâmetro parallel permite importar vários arquivos em paralelo.
Se você usar o parâmetro parallel , o parâmetro clean permitirá que você descarte (limpe) objetos do banco de dados antes de recriá-los. Se você usar o parâmetro parallel , o parâmetro ifExists permitirá que você inclua a instrução SQL IF EXISTS em cada instrução DROP produzida pelo parâmetro clean .
Para usar esses recursos, defina os valores desses parâmetros como TRUE . Caso contrário, defina os valores como FALSE .
Método HTTP e URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/instances/INSTANCE_NAME/import
```
Corpo JSON da solicitação:
```
 {
   "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]
         }
     }
  }
```
Para enviar sua solicitação, expanda uma destas opções:
curl (Linux, macOS ou Cloud Shell)
Observação: o comando a seguir pressupõe que você tenha efetuado login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login , ou usando o Cloud Shell , que efetua login automaticamente na CLI gcloud . Você pode verificar a conta ativa no momento executando gcloud auth list .
Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:
```
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)
Observação: o comando a seguir pressupõe que você tenha efetuado login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Você pode verificar a conta ativa no momento executando gcloud auth list .
Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:
```
$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
```
Você deve receber uma resposta JSON semelhante à seguinte:
Resposta
```
{
  "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"
}
```
Para usar um usuário diferente para a importação, especifique a propriedade importContext.importUser .
Para obter a lista completa de parâmetros para a solicitação, consulte a página da API de administração do Cloud SQL .
Se você não precisar das permissões do IAM definidas em Funções e permissões necessárias para importar para o Cloud SQL para PostgreSQL , use gcloud storage buckets remove-iam-policy-binding para removê-las.

Limitações

Se você especificar muitos threads ao importar ou exportar dados de vários arquivos em paralelo, poderá usar mais memória do que a sua instância do Cloud SQL tem. Se isso ocorrer, uma mensagem de erro interna será exibida. Verifique o uso de memória da sua instância e aumente o tamanho dela, conforme necessário. Para obter mais informações, consulte Sobre as configurações da instância .
Ao executar uma exportação, vírgulas em nomes de bancos de dados ou nomes de tabelas nos campos databases ou tables não são suportadas.
Certifique-se de ter espaço em disco suficiente para o download do arquivo de despejo inicial. Caso contrário, aparecerá um erro no space left on disk .
Se a sua instância tiver apenas uma CPU virtual (vCPU), você não poderá importar ou exportar vários arquivos em paralelo. O número de vCPUs da sua instância não pode ser menor que o número de threads que você está usando para a operação de importação ou exportação, e o número de threads deve ser de pelo menos dois.

O utilitário pg_dump não consegue dividir em partes nenhuma tabela exportada. Portanto, se você tiver uma tabela muito grande, ela pode se tornar um gargalo para a velocidade da operação de exportação.

O que vem a seguir

Aprenda como consultar o status das operações de importação e exportação .
Aprenda como cancelar a importação e exportação de dados .
Saiba mais sobre as melhores práticas para importar e exportar dados .
Saiba mais sobre problemas conhecidos sobre importações e exportações .

Exportar e importar arquivos em paralelo,Exportar e importar arquivos em paralelo,Exportar e importar arquivos em paralelo,Exportar e importar arquivos em paralelo Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Exportar dados do Cloud SQL para PostgreSQL para vários arquivos em paralelo

Funções e permissões necessárias para exportar dados do Cloud SQL para PostgreSQL para vários arquivos em paralelo

Exportar dados para vários arquivos em paralelo

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

Exportar e importar uma instância inteira

Importar dados de vários arquivos em paralelo para o Cloud SQL para PostgreSQL

Funções e permissões necessárias para importar dados de vários arquivos em paralelo para o Cloud SQL para PostgreSQL

Importar dados para o Cloud SQL para PostgreSQL

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

Limitações

O que vem a seguir

Exportar e importar arquivos em paralelo,Exportar e importar arquivos em paralelo,Exportar e importar arquivos em paralelo,Exportar e importar arquivos em paralelo
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.