Gérer les profils de connexion

Cette page explique comment afficher, mettre à jour et supprimer des profils de connexion.

Afficher un profil de connexion

Vous pouvez afficher les informations suivantes sur vos profils de connexion :

  • Tous les détails de configuration fournis lors de la création du profil. Pour en savoir plus, consultez Présentation des profils de connexion.

  • Date et heure de création et de dernière modification du profil de connexion.

  • Liste des jobs de migration qui utilisent ce profil de connexion.

Pour afficher les détails d'un profil de connexion, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Profils de connexion.

    Accéder à la page "Profils de connexion"

  2. Cliquez sur le nom à afficher du profil de connexion que vous souhaitez consulter.

    La page de présentation du profil de connexion s'affiche.

gcloud

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • REGION par l'identifiant de la région où votre profil de connexion est enregistré.
  • CONNECTION_PROFILE_ID par l'identifiant de votre profil de connexion.

    Si vous ne connaissez pas l'identifiant, vous pouvez utiliser la commande gcloud database-migration connection-profiles list pour lister tous les profils d'une région donnée et afficher leurs identifiants.

Pour en savoir plus sur ces valeurs, consultez Présentation des profils de connexion.

Exécutez la commande suivante :

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

Mettre à jour un profil de connexion

Vous pouvez modifier les détails suivants du profil de connexion :

  • Nom à afficher
  • Pour les profils de connexion source : nom d'hôte ou adresse IP, port, nom d'utilisateur, mot de passe, nom de la base de données et certificats SSL/TLS
  • Pour les profils de connexion de destination (cluster existant uniquement) : identifiant du cluster AlloyDB pour PostgreSQL de destination

Pour mettre à jour un profil de connexion, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Profils de connexion.

    Accéder à la page "Profils de connexion"

  2. Cliquez sur le nom à afficher du profil de connexion que vous souhaitez modifier.

    Une page de présentation s'affiche pour le profil de connexion.

  3. Cliquez sur Modifier et mettez à jour votre profil de connexion.
  4. Cliquez sur Enregistrer.

gcloud

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • CONNECTION_PROFILE_ID par l'identifiant de votre profil de connexion.

    Si vous ne connaissez pas l'identifiant, vous pouvez utiliser la commande gcloud database-migration connection-profiles list pour lister tous les profils d'une région donnée et afficher leurs identifiants.

  • REGION par l'identifiant de la région où votre profil de connexion est enregistré.
  • (Facultatif) CONNECTION_PROFILE_NAME : nom lisible par l'humain de votre profil de connexion. Cette valeur s'affiche dans la console Google Cloud .
  • Pour les profils de connexion source : vous pouvez également transmettre des options telles que --host, --port, --username et --password pour mettre à jour les informations de connexion de votre base de données source. Pour obtenir la liste complète des options acceptées, consultez la documentation de référence sur gcloud database-migration connection-profiles update.
  • Pour les profils de connexion de destination (cluster existant uniquement) : ALLOYDB_CLUSTER_ID avec l'identifiant de votre cluster AlloyDB pour PostgreSQL de destination. Pour savoir comment afficher les détails d'un cluster AlloyDB pour PostgreSQL, consultez Afficher les détails d'un cluster dans la documentation AlloyDB pour PostgreSQL.
Pour en savoir plus sur ces valeurs, consultez Présentation des profils de connexion.

Exécutez la commande suivante :

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

Résultat

L'action est effectuée de manière asynchrone. Cette commande renvoie donc une entité Operation qui représente une opération de longue durée : 

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

Pour vérifier si l'opération a réussi, vous pouvez interroger l'objet d'opération renvoyé ou consulter les détails du profil de connexion :

Supprimer un profil de connexion

Vous ne pouvez supprimer un profil de connexion que si aucun job de migration ne l'utilise. Si vous souhaitez supprimer un profil de connexion utilisé par un job de migration, commencez par supprimer tous les jobs de migration associés au profil de connexion.

Pour supprimer un profil de connexion, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Profils de connexion.

    Accéder à la page "Profils de connexion"

  2. Cliquez sur le nom à afficher du profil de connexion que vous souhaitez supprimer.

    La page de présentation du profil de connexion s'affiche.

  3. Cliquez sur Supprimer.
  4. Dans la boîte de dialogue, cliquez sur Supprimer.

gcloud

Cette commande renvoie une invite de confirmation interactive qui nécessite votre intervention pour se terminer. Vous pouvez ignorer l'invite de confirmation en utilisant l' option facultative --quiet.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • REGION par l'identifiant de la région où votre profil de connexion est enregistré.
  • CONNECTION_PROFILE_ID par l'identifiant de votre profil de connexion.

    Si vous ne connaissez pas l'identifiant, vous pouvez utiliser la commande gcloud database-migration connection-profiles list pour lister tous les profils d'une région donnée et afficher leurs identifiants.

Pour en savoir plus sur ces valeurs, consultez Présentation des profils de connexion.

Exécutez la commande suivante :

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
 Résultat

La commande delete renvoie une invite interactive dans laquelle vous confirmez l'action. Saisissez Y pour supprimer le profil de connexion : 

You are about to delete connection_profile [CONNECTION_PROFILE_ID]

Do you want to continue (Y/n)?
Vous pouvez ignorer les invites de confirmation interactives de Google Cloud CLI en utilisant l' option facultative --quiet.