Esta página foi traduzida pela API Cloud Translation.

Migrar do Cloud SQL para PostgreSQL para o AlloyDB para PostgreSQL

Esta página descreve como migrar uma instância do Cloud SQL para PostgreSQL copiando um backup do Cloud SQL para um de teste sem custos financeirosdo AlloyDB para PostgreSQL. Ao copiar um backup do Cloud SQL para um cluster do AlloyDB, é possível carregar dados rapidamente no Cloud SQL para PostgreSQL, o que permite avaliar ou migrar para o AlloyDB.

Nesta página, consideramos que você já conhece o Cloud SQL. Se você não conhece o AlloyDB, consulte a Visão geral do AlloyDB.

Para saber como migrar dados do Cloud SQL para o AlloyDB usando a replicação contínua de dados, consulte Database Migration Service para PostgreSQL para AlloyDB.

Não há compatibilidade com os seguintes recursos:

Instâncias do Cloud SQL Enterprise Plus
Restaurações entre projetos e entre regiões
Instâncias com chaves de criptografia gerenciadas pelo cliente (CMEK)
Instâncias com a autenticação de grupos do Identity and Access Management (IAM)

Antes de começar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the AlloyDB, Compute Engine, and Service Networking APIs.
Enable the APIs
Verifique se você tem o seguinte:
- As permissões necessárias do Identity and Access Management (IAM)
- Um backup do Cloud SQL com menos de 1TB
- Uma versão do PostgreSQL compatível com o AlloyDB
Funções exigidas

Para receber as permissões necessárias e copiar um backup do Cloud SQL para PostgreSQL em um cluster do AlloyDB, conceda a si mesmo os seguintes papéis do IAM no projeto:
- Leitor do Cloud SQL (roles/cloudsql.viewer) ou qualquer papel personalizado que inclua a permissão cloudsql.backupRuns.export.
- Administrador do Cloud AlloyDB (roles/alloydb.admin)
Copiar um backup do Cloud SQL para um cluster do AlloyDB

Copiar um backup do Cloud SQL para um cluster de teste sem custos financeiros do AlloyDB o restaura para a mesma versão do PostgreSQL no AlloyDB. Por exemplo, um backup do PostgreSQL 14 do Cloud SQL é restaurado para um cluster de teste sem custos financeiros do PostgreSQL . Lembre-se de que as versões de extensão e as versões secundárias do PostgreSQL podem ser diferentes.

A cópia de um backup do Cloud SQL só é compatível com a configuração dos itens aceitos no cluster de teste sem custos financeiros do AlloyDB .

Observação:não é possível copiar um backup se ele for maior que 1TB.

Para copiar um backup do Cloud SQL para um cluster de teste sem custos financeiros do AlloyDB , siga estas etapas:
Console
1. No console Google Cloud , acesse a página Clusters.
  
  Acessar Clusters
2. Se você ainda não provisionou um cluster, clique em Iniciar um teste gratuito. Se você já tiver um cluster, clique em Migrar dados.
3. Clique em Copiar do backup do Cloud SQL.
4. Na página Copiar do backup do Cloud SQL, ative as APIs necessárias. Se você já as ativou, não é necessário reativá-las.
5. Na página Selecionar tipo de cluster, clique em Cluster de teste sem custos financeiros. Se você não se qualificar para um cluster de teste gratuito, esse campo vai aparecer esmaecido.
6. Clique em Selecionar tipo de cluster.
7. Selecione a instância do Cloud SQL que você quer copiar e clique em Selecionar instância. É possível filtrar as instâncias do Cloud SQL.
  Somente as versões de banco de dados compatíveis são exibidas. As réplicas não têm backups e não aparecem na lista de instâncias disponíveis.
8. Selecione o backup que você quer importar e clique em Selecionar backup. Esta página mostra os mil backups mais recentes.
9. Na página Criar cluster sem custos financeiros, insira o ID do cluster e as informações de rede.
10. Clique em Iniciar teste sem custos.
Depois que a operação é concluída, uma instância principal é criada automaticamente. Um novo cluster do AlloyDB vai aparecer com os dados copiados do backup do Cloud SQL para PostgreSQL que você selecionou.

Quando você copia um backup do Cloud SQL para PostgreSQL para um cluster do AlloyDB, as flags de banco de dados e as permissões de nível de recurso não são migradas automaticamente. Depois que a cópia é concluída, você precisa configurar essas flags e permissões manualmente.

Para saber quais flags de banco de dados do Cloud SQL para PostgreSQL são compatíveis com o AlloyDB, acesse a página Criar seu cluster sem custos financeiros.
gcloud

Para usar a CLI gcloud, instale e inicialize a CLI gcloud ou use o Cloud Shell.
1. Execute o comando gcloud beta alloydb clusters migrate-cloud-sql:
  gcloud beta alloydb clusters migrate-cloud-sql CLUSTER_ID
  --cluster-id=CLUSTER_ID \
  --cloud-sql-backup-id=CLOUD_SQL_BACKUP_ID \
  --cloud-sql-instance-id=CLOUD_SQL_INSTANCE_ID \
  --cloud-sql-project-id=CLOUD_SQL_PROJECT_ID
  --password=PASSWORD \
  --region=REGION \
  --database-version=DATABASE_VERSION \
  --subscription-type=TRIAL
  Substitua:
  - CLUSTER: ID do cluster do Cloud SQL para PostgreSQL.
  - CLOUD_SQL_BACKUP_ID: ID do backup do Cloud SQL de que será feita a migração. Precisa ser o ID do backup.
  - CLOUD_SQL_INSTANCE_ID: ID da instância do Cloud SQL de onde migrar. Precisa ser o ID da instância.
  - CLOUD_SQL_PROJECT_ID: projeto do Cloud SQL de origem da migração. Ele precisa ser o ID do projeto.
  - PASSWORD: senha inicial do usuário do PostgreSQL a ser definida durante a criação do cluster.
  - REGION: local, por exemplo, asia-east1 ou us-east1. Confira a lista completa de regiões em locais regionais.
  - DATABASE_VERSION: versão do banco de dados do cluster. Precisa ser um dos seguintes formatos: POSTGRES_14, POSTGRES_15 ou POSTGRES_16. A versão do banco de dados precisa ser a mesma do backup do Cloud SQL.
  - SUBSCRIPTION_TYPE: tipo de assinatura do cluster. Precisa ser um dos seguintes: STANDARD ou TRIAL.
2. Execute o comando gcloud beta alloydb operations describe para confirmar o status da operação de backup:
  gcloud beta alloydb operations describe OPERATION_ID \ --region=REGION_ID \ --project=PROJECT_ID
  Substitua:
  - OPERATION_ID: o nome da operação do AlloyDB.
  - REGION_ID: a região em que o cluster do AlloyDB é implantado.
  - PROJECT_ID: o ID do projeto;
3. Use o comando gcloud alloydb instances create para criar uma instância principal.
API REST
1. Para receber uma lista de backups da instância que você quer restaurar, chame o método backupsRuns.list
  GET "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns"
  Substitua:
  - PROJECT_ID: o ID do projeto;
  - INSTANCE_ID: o ID da instância
  Solicitar corpo JSON:
  { "kind": string, "items": [ { object (BackupRun) } ], "nextPageToken": string }
  Para enviar a solicitação, use uma destas opções:
  curl (Linux, macOS ou Cloud Shell)
  
  O comando a seguir pressupõe que você fez login no gcloud CLI com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando Cloud Shell, que faz login automaticamente no gcloud CLI.
  
  É possível verificar a conta ativa executando gcloud auth list.
  
  Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:
  
  curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://sqladmin.googleapis.com//sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns"
  PowerShell (Windows)
  
  O comando a seguir pressupõe que você fez login no gcloud CLI com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente no gcloud CLI.
  
  É possível verificar a conta ativa executando gcloud auth list.
  
  Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:
  
  $cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method GET ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Uri "https://sqladmin.googleapis.com//sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns"|Select-Object -Expand Content
  
  Você vai receber uma resposta JSON semelhante a esta:
  
  Resposta
  
  Se a solicitação for bem-sucedida, o corpo da resposta vai conter uma lista de BackupRun.
  A resposta da API retorna uma lista de backups da instância como uma lista de matrizes, incluindo "id": string,.
2. Chame o método restoreFromCloudSQL:
  POST https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION/clusters:restoreFromCloudSQL
  Substitua:
  - PROJECT_ID: o ID do projeto;
  - REGION: a região em que o cluster do AlloyDB é implantado.
  Solicitar corpo JSON:
  { "clusterId": string, "cluster": { "databaseVersion": "POSTGRES_14/POSTGRES_15/POSTGRES_16", "subscriptionType": "TRIAL" }, // Union field source can be only one of the following: "cloudsqlBackupRunSource": { object (CloudSQLBackupRunSource) } // End of list of possible types for union field source. }
  Para enviar a solicitação, use uma destas opções:
  curl (Linux, macOS ou Cloud Shell)
  
  O comando a seguir pressupõe que você fez login no gcloud CLI com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente no gcloud CLI.
  
  É possível verificar a conta ativa executando gcloud auth list.
  
  Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:
  
  curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION/clusters:restoreFromCloudSQL"
  PowerShell (Windows)
  
  O comando a seguir pressupõe que você fez login no gcloud CLI com sua conta de usuário executando gcloud init ou gcloudauth login, ou usando o Cloud Shell, que faz login automaticamente no gcloud CLI.
  
  É possível verificar a conta ativa executando gcloud auth list.
  
  Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:
  
  $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://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION/clusters:restoreFromCloudSQL"|Select-Object -Expand Content
  Você vai receber uma resposta JSON semelhante a esta:
  
  Resposta
  
  Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.
  
  Um novo cluster é criado no projeto e local especificados, com um volume restaurado do backup indicado na mensagem CloudSQLBackupRunSource.
3. Quando o cluster estiver no estado READY, crie a instância principal chamando o método projects.locationsinstances.create:
  POST https://alloydb.googleapis.com/v1beta/{parent=projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID}/instances
  Substitua:
  - PROJECT_ID: o ID do projeto;
  - REGION: a região em que o cluster do AlloyDB é implantado.
  - CLUSTER_ID: o ID do cluster.
  Solicitar corpo JSON:
  { "instanceId": "string", "instance": { "object": "Instance" } }
  O corpo da solicitação contém uma instância de Instance.
  
  Para enviar a solicitação, use uma destas opções:
  curl (Linux, macOS ou Cloud Shell)
  
  O comando a seguir pressupõe que você fez login no gcloud CLI com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente no gcloud CLI.
  
  É possível verificar a conta ativa executando gcloud auth list.
  
  Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:
  
  curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID/instances"
  PowerShell (Windows)
  
  O comando a seguir pressupõe que você fez login no gcloud CLI com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente no gcloud CLI.
  
  É possível verificar a conta ativa executando gcloud auth list.
  
  Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:
  
  $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://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID/instances"|Select-Object -Expand Content
  Você vai receber uma resposta JSON semelhante a esta:
  
  Resposta
  
  Se a solicitação for bem-sucedida, o corpo da resposta vai conter uma instância recém-criada de Operation.
4. Depois que a instância for atualizada para o estado READY, conecte-se a ela e acesse os dados restaurados do snapshot do Cloud SQL.
A seguir
- Conectar-se ao AlloyDB usando um IP público.
- Gerenciar dados com o AlloyDB Studio.

Migrar do Cloud SQL para PostgreSQL para o AlloyDB para PostgreSQL Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Funções exigidas

Copiar um backup do Cloud SQL para um cluster do AlloyDB

Console

gcloud

API REST

Solicitar corpo JSON:

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

Solicitar corpo JSON:

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

Solicitar corpo JSON:

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

A seguir

Migrar do Cloud SQL para PostgreSQL para o AlloyDB para PostgreSQL