Gestione dei profili di connessione

Questa pagina descrive come eseguire operazioni di visualizzazione, aggiornamento ed eliminazione per i profili di connessione.

Visualizza un profilo di connessione

Puoi visualizzare le seguenti informazioni sui tuoi profili di connessione:

  • Tutti i dettagli di configurazione forniti durante la creazione del profilo. Per saperne di più, consulta la panoramica dei profili di connessione.

  • Data e ora di creazione e dell'ultima modifica del profilo di connessione.

  • Un elenco di job di migrazione che utilizzano questo profilo di connessione.

Per visualizzare i dettagli del profilo di connessione, segui questi passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Profili di connessione.

    Vai a Profili di connessione

  2. Fai clic sul nome visualizzato del profilo di connessione che vuoi visualizzare.

    Viene visualizzata una pagina di riepilogo del profilo di connessione.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • REGION con l'identificatore della regione in cui è salvato il profilo di connessione.
  • CONNECTION_PROFILE_ID con l'identificatore del tuo profilo di connessione.

    Se non conosci l'identificatore, puoi utilizzare il comando gcloud database-migration connection-profiles list per elencare tutti i profili in una determinata regione e visualizzare i relativi identificatori.

Per saperne di più su questi valori, consulta la panoramica dei profili di connessione.

Esegui questo comando:

Linux, macOS o 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

Aggiorna un profilo di connessione

Puoi modificare i seguenti dettagli del profilo di connessione:

  • Nome visualizzato
  • Per i profili di connessione di origine: nome host o indirizzo IP, porta, nome utente, password, nome del database e certificati SSL/TLS
  • Per i profili di connessione di destinazione (solo cluster esistente): identificatore del cluster AlloyDB per PostgreSQL di destinazione

Per aggiornare un profilo di connessione, segui questi passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Profili di connessione.

    Vai a Profili di connessione

  2. Fai clic sul nome visualizzato del profilo di connessione che vuoi modificare.

    Viene visualizzata una pagina di riepilogo del profilo di connessione.

  3. Fai clic su Modifica e aggiorna il profilo di connessione.
  4. Fai clic su Salva.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • CONNECTION_PROFILE_ID con l'identificatore del tuo profilo di connessione.

    Se non conosci l'identificatore, puoi utilizzare il comando gcloud database-migration connection-profiles list per elencare tutti i profili in una determinata regione e visualizzare i relativi identificatori.

  • REGION con l'identificatore della regione in cui è salvato il profilo di connessione.
  • (Facoltativo) CONNECTION_PROFILE_NAME con un nome leggibile per il profilo di connessione. Questo valore viene visualizzato nella console Google Cloud .
  • Per i profili di connessione di origine: puoi anche passare flag come --host, --port, --username e --password per aggiornare i dettagli di connessione al database di origine. Per l'elenco completo dei flag supportati, consulta il riferimento gcloud database-migration connection-profiles update.
  • Per i profili di connessione di destinazione (solo cluster esistente): ALLOYDB_CLUSTER_ID con l'identificatore del cluster AlloyDB per PostgreSQL di destinazione. Per informazioni su come visualizzare i dettagli del cluster AlloyDB per PostgreSQL, consulta Visualizza i dettagli del cluster nella documentazione di AlloyDB per PostgreSQL.
Per saperne di più su questi valori, consulta la panoramica dei profili di connessione.

Esegui questo comando:

Linux, macOS o 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

Risultato

L'azione viene eseguita in modo asincrono. Pertanto, questo comando restituisce un' entità Operation che rappresenta un'operazione a lunga esecuzione: 

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

Per verificare se l'operazione è andata a buon fine, puoi eseguire una query sull'oggetto operazione restituito o controllare i dettagli del profilo di connessione:

Eliminazione di un profilo di connessione

Puoi eliminare un profilo di connessione solo se non sono presenti job di migrazione che utilizzano quel profilo. Se vuoi eliminare un profilo di connessione utilizzato da un job di migrazione, devi prima eliminare tutti i job di migrazione collegati al profilo di connessione.

Per eliminare un profilo di connessione, segui questi passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Profili di connessione.

    Vai a Profili di connessione

  2. Fai clic sul nome visualizzato del profilo di connessione che vuoi eliminare.

    Viene visualizzata una pagina di riepilogo del profilo di connessione.

  3. Fai clic su Elimina.
  4. Nella finestra di dialogo, fai clic su Elimina.

gcloud

Questo comando restituisce un prompt di conferma interattivo che richiede il tuo input per essere completato. Puoi saltare la richiesta di conferma utilizzando il flag facoltativo --quiet.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • REGION con l'identificatore della regione in cui è salvato il profilo di connessione.
  • CONNECTION_PROFILE_ID con l'identificatore del tuo profilo di connessione.

    Se non conosci l'identificatore, puoi utilizzare il comando gcloud database-migration connection-profiles list per elencare tutti i profili in una determinata regione e visualizzare i relativi identificatori.

Per saperne di più su questi valori, consulta la panoramica dei profili di connessione.

Esegui questo comando:

Linux, macOS o 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
 Risultato

Il comando delete restituisce un prompt interattivo in cui confermi l'azione. Inserisci Y per rimuovere il profilo di connessione: 

You are about to delete connection_profile [CONNECTION_PROFILE_ID]

Do you want to continue (Y/n)?
Puoi saltare i prompt di conferma interattivi di Google Cloud CLI utilizzando il flag facoltativo --quiet.