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 la 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 la 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
  • (Profil de destination uniquement) Identifiant de l'instance Cloud SQL pour PostgreSQL de destination, nom d'utilisateur et mot de passe de la base de données

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

Cet exemple utilise l'option facultative --no-async pour que toutes les opérations soient effectuées de manière synchrone. Cela signifie que l'exécution de certaines commandes peut prendre un certain temps. Vous pouvez ignorer l'option --no-async pour exécuter des commandes de manière asynchrone. Si vous le faites, vous devez utiliser la commande gcloud database-migration operations describe pour vérifier si l'opération a réussi.

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 de destination uniquement : CLOUDSQL_INSTANCE_ID avec l'identifiant d'instance de votre instance Cloud SQL de destination. Pour savoir comment afficher les détails d'une instance Cloud SQL, consultez Afficher les informations sur les instances dans la documentation Cloud SQL.
Pour en savoir plus sur ces valeurs, consultez la présentation des profils de connexion.

Exécutez la commande suivante :

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

Vous devriez obtenir un résultat semblable à celui-ci :

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]

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 à l'aide de 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 la 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

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.