Gerenciar perfis de conexão

Esta página descreve como realizar operações de visualização, atualização e exclusão de perfis de conexão.

Conferir um perfil de conexão

Você pode conferir as seguintes informações sobre seus perfis de conexão:

  • Todos os detalhes de configuração fornecidos durante a criação do perfil. Para mais informações, consulte Visão geral dos perfis de conexão.

  • Criação do perfil de conexão e horário da última modificação.

  • Uma lista de jobs de migração que usam esse perfil de conexão.

Para conferir os detalhes do perfil de conexão, siga estas etapas:

Console

  1. No Google Cloud console, acesse a página Perfis de conexão.

    Acessar Perfis de conexão

  2. Clique no nome do perfil de conexão que você quer acessar.

    A página de visão geral do perfil de conexão vai aparecer.

gcloud

Antes de usar os dados do comando abaixo, faça estas substituições:

  • REGION com o identificador da região em que o perfil de conexão é salvo.
  • CONNECTION_PROFILE_ID pelo identificador do perfil de conexão.

    Se você não souber o identificador, use o comando gcloud database-migration connection-profiles list para listar todos os perfis em uma determinada região e conferir os identificadores.

Para mais informações sobre esses valores, consulte Visão geral dos perfis de conexão.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud database-migration connection-profiles \
describe CONNECTION_PROFILE_ID \
  --region=REGION

Windows (PowerShell)

gcloud database-migration connection-profiles `
describe CONNECTION_PROFILE_ID `
  --region=REGION

Windows (cmd.exe)

gcloud database-migration connection-profiles ^
describe CONNECTION_PROFILE_ID ^
  --region=REGION

Atualizar um perfil de conexão

É possível modificar os seguintes detalhes do perfil de conexão:

  • Nome de exibição
  • (Somente no perfil de origem) Nome do bucket do Cloud Storage
  • (Somente perfil de destino) identificador da instância do Cloud SQL para SQL Server de destino, nome de usuário e senha do banco de dados

Para atualizar um perfil de conexão, siga estas etapas:

Console

  1. No Google Cloud console, acesse a página Perfis de conexão.

    Acessar Perfis de conexão

  2. Clique no nome de exibição do perfil de conexão que você quer modificar.

    Uma página de visão geral do perfil de conexão vai aparecer.

  3. Clique em Editar e atualize o perfil de conexão.
  4. Clique em Salvar.

gcloud

Este exemplo usa a flag --no-async opcional para que todas as operações sejam realizadas de forma síncrona. Isso significa que alguns comandos podem levar um tempo para serem concluídos. Você pode pular a flag --no-async para executar comandos de forma assíncrona. Se você fizer isso, use o comando gcloud database-migration operations describe para verificar se a operação foi bem-sucedida.

Antes de usar os dados do comando abaixo, faça estas substituições:

  • CONNECTION_PROFILE_ID pelo identificador do perfil de conexão.

    Se você não souber o identificador, use o comando gcloud database-migration connection-profiles list para listar todos os perfis em uma determinada região e conferir os identificadores.

  • REGION com o identificador da região em que o perfil de conexão é salvo.
  • (Opcional) CONNECTION_PROFILE_NAME com um nome legível para humanos do seu perfil de conexão. Esse valor é mostrado no console Google Cloud .
  • (Opcional, apenas para perfis de conexão de origem) SOURCE_STORAGE_BUCKET_NAME com o bucket do Cloud Storage que contém a pasta do banco de dados pai, em que você cria as pastas "full", "diff" e "logs", que contêm os arquivos de backup completo, diferencial e de registro de transações.
  • (Opcional, apenas para perfis de conexão de destino)
    • CLOUDSQL_INSTANCE_ID com o identificador da instância de destino do Cloud SQL para SQL Server. Para saber como conferir os detalhes da instância do Cloud SQL, consulte Conferir informações da instância na documentação do Cloud SQL.
    • Detalhes do usuário da migração: forneça os detalhes da conta de usuário do banco de dados dedicado na instância de destino. Para mais informações sobre essa conta de usuário, consulte Criar e configurar a instância de destino do Cloud SQL para SQL Server.
      • CLOUD_SQL_DB_USERNAME pelo nome de usuário da migração.
      • CLOUD_SQL_DB_USER_PASSWORD pela senha da conta de migração.
Para mais informações sobre esses valores, consulte Visão geral dos perfis de conexão.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud database-migration connection-profiles \
create sqlserver CONNECTION_PROFILE_ID \
  --no-async
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME \
  --gcs-bucket=SOURCE_STORAGE_BUCKET_NAME \
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID \
  --username=CLOUD_SQL_DB_USERNAME \
  --password=CLOUD_SQL_DB_USER_PASSWORD

Windows (PowerShell)

gcloud database-migration connection-profiles `
create sqlserver CONNECTION_PROFILE_ID `
  --no-async
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME `
  --gcs-bucket=SOURCE_STORAGE_BUCKET_NAME `
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID `
  --username=CLOUD_SQL_DB_USERNAME `
  --password=CLOUD_SQL_DB_USER_PASSWORD

Windows (cmd.exe)

gcloud database-migration connection-profiles ^
create sqlserver CONNECTION_PROFILE_ID ^
  --no-async
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME ^
  --gcs-bucket=SOURCE_STORAGE_BUCKET_NAME ^
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID ^
  --username=CLOUD_SQL_DB_USERNAME ^
  --password=CLOUD_SQL_DB_USER_PASSWORD

Você receberá uma resposta semelhante a esta:

Waiting for connection profile [CONNECTION_PROFILE_ID]
to be updated with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

Excluir um perfil de conexão

Só é possível excluir um perfil de conexão se não houver jobs de migração que usem esse perfil. Se você quiser excluir um perfil de conexão que está em uso por um job de migração, primeiro exclua todos os jobs de migração vinculados ao perfil de conexão.

Para excluir um perfil de conexão, siga estas etapas:

Console

  1. No Google Cloud console, acesse a página Perfis de conexão.

    Acessar Perfis de conexão

  2. Clique no nome de exibição do perfil de conexão que você quer excluir.

    A página de visão geral do perfil de conexão vai aparecer.

  3. Clique em Excluir.
  4. Na caixa de diálogo, clique em Excluir.

gcloud

Esse comando retorna uma solicitação de confirmação interativa que exige sua entrada para ser concluída. É possível pular a solicitação de confirmação usando a flag opcional --quiet.

Antes de usar os dados do comando abaixo, faça estas substituições:

  • REGION com o identificador da região em que o perfil de conexão é salvo.
  • CONNECTION_PROFILE_ID pelo identificador do perfil de conexão.

    Se você não souber o identificador, use o comando gcloud database-migration connection-profiles list para listar todos os perfis em uma determinada região e conferir os identificadores.

Para mais informações sobre esses valores, consulte Visão geral dos perfis de conexão.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud database-migration connection-profiles \
delete CONNECTION_PROFILE_ID \
  --region=REGION

Windows (PowerShell)

gcloud database-migration connection-profiles `
delete CONNECTION_PROFILE_ID `
  --region=REGION

Windows (cmd.exe)

gcloud database-migration connection-profiles ^
delete CONNECTION_PROFILE_ID ^
  --region=REGION
 Resultado

O delete retorna uma solicitação interativa em que você confirma a ação. Digite Y para remover o perfil de conexão: 

You are about to delete connection_profile [CONNECTION_PROFILE_ID]

Do you want to continue (Y/n)?
É possível pular as solicitações de confirmação interativas da Google Cloud CLI usando a flag --quiet opcional.