Gerenciar perfis de conexão

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

Ver um perfil de conexão

É possível ver 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.

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

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

Para ver 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 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 comando gcloud database-migration connection-profiles list para listar todos os perfis em uma determinada região e conferir 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
  • Para perfis de conexão de origem: nome do host ou endereço IP, porta, nome de usuário, senha, nome do banco de dados e certificados SSL/TLS
  • Para perfis de conexão de destino (somente cluster atual): identificador do cluster de destino do AlloyDB para PostgreSQL

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

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

gcloud

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 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 por humanos para o perfil de conexão. Esse valor é exibido no console do Google Cloud .
  • Para perfis de conexão de origem: também é possível transmitir flags como --host, --port, --username e --password para atualizar os detalhes de conexão do banco de dados de origem. Para ver a lista completa de flags compatíveis, consulte a referência de gcloud database-migration connection-profiles update.
  • Para perfis de conexão de destino (somente cluster atual): ALLOYDB_CLUSTER_ID com o identificador do cluster de destino do AlloyDB para PostgreSQL. Para saber como ver os detalhes do cluster do AlloyDB para PostgreSQL, consulte Ver detalhes do cluster na documentação do AlloyDB para PostgreSQL.
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 \
update CONNECTION_PROFILE_ID \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME \
  --alloydb-cluster=ALLOYDB_CLUSTER_ID

Windows (PowerShell)

gcloud database-migration connection-profiles `
update CONNECTION_PROFILE_ID `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME `
  --alloydb-cluster=ALLOYDB_CLUSTER_ID

Windows (cmd.exe)

gcloud database-migration connection-profiles ^
update CONNECTION_PROFILE_ID ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME ^
  --alloydb-cluster=ALLOYDB_CLUSTER_ID

Resultado

A ação é realizada de maneira assíncrona. Assim, esse comando retorna uma entidade Operation que representa uma operação de longa duração: 

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: CONNECTION_PROFILE_ID
  verb: update
name: OPERATION_ID

Para ver se a operação foi bem-sucedida, consulte o objeto de operação retornado ou verifique os detalhes do perfil de conexão:

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 utilizem. 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 um prompt de confirmação interativo que requer sua entrada para ser concluído. É 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 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 comando gcloud database-migration connection-profiles list para listar todos os perfis em uma determinada região e conferir 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 comando 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 as solicitações de confirmação interativas da Google Cloud CLI usando a flag opcional --quiet.