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 page Présentation des profils de connexion.

  • Date et heure de création ou 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 répertorier tous les profils d'une région donnée et afficher leurs identifiants.

Pour en savoir plus sur ces valeurs, consultez la page 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 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 certaines commandes peuvent 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 répertorier 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 pour votre profil de connexion. Cette valeur s'affiche dans la Google Cloud console.
  • (Facultatif, pour les profils de connexion source uniquement) SOURCE_STORAGE_BUCKET_NAME par le nom du bucket Cloud Storage qui contient le dossier de la base de données parent dans lequel vous créez les dossiers complets, 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 d'instance de votre instance Cloud SQL pour SQL Server 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.
    • 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 la section Créer et configurer l'instance Cloud SQL pour SQL Server de destination.
      • CLOUD_SQL_DB_USERNAME par 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 page 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 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 terminée. Vous pouvez ignorer l'invite de confirmation à l'aide de l'option facultative --quiet flag.

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 répertorier tous les profils d'une région donnée et afficher leurs identifiants.

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