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 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 source uniquement) Nom du bucket Cloud Storage
  • (Profil de destination uniquement) Identifiant de l'instance Cloud SQL pour SQL Server 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 par un nom lisible par l'humain pour votre profil de connexion. Cette valeur s'affiche dans la console Google Cloud .
  • (Facultatif, pour les profils de connexion source uniquement) SOURCE_STORAGE_BUCKET_NAME par le nom du bucket Cloud Storage contenant le dossier de base de données parent dans lequel vous créez les dossiers full, diff et logs (qui contiennent la sauvegarde complète, la sauvegarde différentielle et les fichiers journaux de transactions).
  • (Facultatif, pour les profils de connexion de destination uniquement)
    • CLOUDSQL_INSTANCE_ID par l'identifiant de votre instance Cloud SQL pour SQL Server 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.
    • Détails de l'utilisateur de migration : fournissez les détails du compte utilisateur de base de données dédié dans votre instance de destination. Pour en savoir plus sur ce compte utilisateur, consultez Créer et configurer l'instance de destination Cloud SQL pour SQL Server.
      • CLOUD_SQL_DB_USERNAME avec le nom d'utilisateur de migration.
      • CLOUD_SQL_DB_USER_PASSWORD par le mot de passe du compte de migration.
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 \
create sqlserver CONNECTION_PROFILE_ID \
  --no-async \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME \
  --gcs-bucket=SOURCE_STORAGE_BUCKET_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 `
  --gcs-bucket=SOURCE_STORAGE_BUCKET_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 ^
  --gcs-bucket=SOURCE_STORAGE_BUCKET_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 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.