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.

Visualizar um perfil de conexão

É possível visualizar 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 visualizar os detalhes do perfil de conexão, siga estas etapas:

Console

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

    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 será exibida.

gcloud

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

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

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

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. Noconsole, acesse a página Perfis de conexão. Google Cloud

    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 será exibida para o perfil de conexão.

  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. É possível pular a flag --no-async para executar comandos de forma assíncrona. Se você fizer isso, será necessário usar o gcloud database-migration operations describe comando 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 gcloud database-migration connection-profiles list comando para listar todos os perfis em uma determinada região e visualizar os identificadores deles.

  • REGION pelo identificador da região em que o perfil de conexão está salvo.
  • (Opcional) CONNECTION_PROFILE_NAME com um nome legível para o perfil de conexão. Esse valor é exibido em o Google Cloud console.
  • (Opcional, somente para perfis de conexão de origem) SOURCE_STORAGE_BUCKET_NAME com o Cloud Storage nome do bucket que contém a pasta do banco de dados pai em que você cria as pastas completas, de diff e de registros (que contêm o backup completo, o backup diferencial e os arquivos de registro de transações).
  • (Opcional, somente 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 informações sobre como visualizar os detalhes da instância do Cloud SQL, consulte Visualizar 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 de 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 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. Noconsole, acesse a página Perfis de conexão. Google Cloud

    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 será exibida.

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

gcloud

Esse comando retorna um prompt de confirmação interativo que exige sua entrada para ser concluído. É possível pular o prompt de confirmação usando a flag --quiet opcional.

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

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

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

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. Insira 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 interativos da Google Cloud CLI usando a flag --quiet opcional.