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 ú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
  • (Somente perfil de destino) Identificador da instância de destino do Cloud SQL para PostgreSQL, 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 é 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 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. É possível 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 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 .
  • Somente para perfis de conexão de destino: CLOUDSQL_INSTANCE_ID com o identificador da instância do Cloud SQL de destino. Para saber como ver detalhes da instância do Cloud SQL, consulte Ver informações da instância na documentação do Cloud SQL.
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 postgresql \
  CONNECTION_PROFILE_ID \
  --no-async \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME \
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID

Windows (PowerShell)

gcloud database-migration connection-profiles update postgresql `
  CONNECTION_PROFILE_ID `
  --no-async `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME `
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID

Windows (cmd.exe)

gcloud database-migration connection-profiles update postgresql ^
  CONNECTION_PROFILE_ID ^
  --no-async ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME ^
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID

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.

Updated 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 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 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.