Gerenciar perfis de conexão

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

Ver um perfil de conexão

É possível 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 este perfil de conexão.

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

Console

  1. No console do Google Cloud , 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 visualizar.

    Uma página de visão geral do perfil de conexão é exibida.

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 está salvo.
  • CONNECTION_PROFILE_ID com o 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 perfil de origem) Nome do bucket do Cloud Storage
  • (Somente perfil de destino) identificador da instância de destino do Cloud SQL para SQL Server, nome de usuário e senha do banco de dados

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

Console

  1. No console do Google Cloud , 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 aparece para o perfil de conexão.

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

gcloud

Este exemplo usa a flag opcional --no-async 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 com o 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 está salvo.
  • (Opcional) CONNECTION_PROFILE_NAME com um nome legível para seu perfil de conexão. Esse valor é exibido no console Google Cloud .
  • (Opcional, apenas para perfis de conexão de origem) SOURCE_STORAGE_BUCKET_NAME com o nome do bucket do Cloud Storage que contém a pasta do banco de dados principal em que você cria as pastas completas, diferenciais e de registros (que contêm o backup completo, o backup diferencial e os arquivos 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 ver detalhes da instância do Cloud SQL, consulte Ver informações da instância na documentação do Cloud SQL.
    • Detalhes do usuário de migração: forneça os detalhes da conta de usuário do banco de dados dedicada 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 com o nome de usuário da migração.
      • CLOUD_SQL_DB_USER_PASSWORD com a 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 o usem. Se você quiser excluir um perfil de conexão que está sendo usado 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 console do Google Cloud , 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.

    Uma página de visão geral do perfil de conexão é exibida.

  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 ignorar o prompt de confirmação usando a flag --quiet opcional.

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 está salvo.
  • CONNECTION_PROFILE_ID com o 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 um prompt interativo 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 os prompts de confirmação interativa da Google Cloud CLI usando a sinalização opcional --quiet.