Gérer les profils de connexion

Cette page explique comment effectuer des opérations d'affichage, de mise à jour et de suppression pour les 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 section 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 Google Cloud console, 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 afficher.

    Une 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 dans laquelle 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 gcloud database-migration connection-profiles list commande pour afficher la liste de tous les profils d'une région donnée et afficher leurs identifiants.

Pour en savoir plus sur ces valeurs, consultez la section 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 source uniquement) Nom du bucket Cloud Storage
  • (Profil de destination uniquement) Identifiant de l'instance Cloud SQL pour MySQL 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 Google Cloud console, 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 du profil de connexion s'affiche.

  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 les commandes de manière asynchrone. Si vous le faites, vous devez utiliser la gcloud database-migration operations describe commande pour vérifier si votre 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 gcloud database-migration connection-profiles list commande pour afficher la liste de tous les profils d'une région donnée et afficher leurs identifiants.

  • REGION par l'identifiant de la région dans laquelle votre profil de connexion est enregistré.
  • Facultatif : CONNECTION_PROFILE_NAME par un nom lisible par l'humain pour votre profil de connexion. Cette valeur s'affiche dans la Google Cloud console.
  • Pour les profils de connexion de destination uniquement: CLOUDSQL_INSTANCE_ID par l'identifiant d'instance de votre instance Cloud SQL de destination. Pour savoir comment afficher les détails d'une instance Cloud SQL, consultez la section Afficher les informations sur les instances dans la documentation Cloud SQL.
Pour en savoir plus sur ces valeurs, consultez la section Présentation des profils de connexion.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud database-migration connection-profiles \
create sqlserver CONNECTION_PROFILE_ID \
  --no-async
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME \
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID \
  --username=CLOUD_SQL_DB_USERNAME \
  --password=CLOUD_SQL_DB_USER_PASSWORD

Windows (PowerShell)

gcloud database-migration connection-profiles `
create sqlserver CONNECTION_PROFILE_ID `
  --no-async
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME `
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID `
  --username=CLOUD_SQL_DB_USERNAME `
  --password=CLOUD_SQL_DB_USER_PASSWORD

Windows (cmd.exe)

gcloud database-migration connection-profiles ^
create sqlserver CONNECTION_PROFILE_ID ^
  --no-async
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME ^
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID ^
  --username=CLOUD_SQL_DB_USERNAME ^
  --password=CLOUD_SQL_DB_USER_PASSWORD

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.

Created 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 qui est utilisé par un job de migration, supprimez d'abord 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 Google Cloud console, 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.

    Une 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 saisie pour être exécutée. Vous pouvez ignorer l'invite de confirmation à l'aide de l' option facultative --quietflag.

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

  • REGION par l'identifiant de la région dans laquelle 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 gcloud database-migration connection-profiles list commande pour afficher la liste de tous les profils d'une région donnée et afficher leurs identifiants.

Pour en savoir plus sur ces valeurs, consultez la section 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

Le 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 la Google Cloud CLI à l'aide de l' option facultative --quiet flag.