Créer des profils de connexion

Cette page décrit la partie préparatoire du processus de migration au cours de laquelle vous créez des profils de connexion Datastream qui seront utilisés ultérieurement pour importer des données de la base de données source compatible avec MongoDB vers le bucket Cloud Storage.

À ce stade, vous procédez comme suit :

  1. Créez un profil de connexion Cloud Storage pour le bucket Cloud Storage que vous avez créé précédemment.
  2. Créez un profil de connexion pour la base de données source compatible avec MongoDB.

Se connecter à la gcloud CLI

La procédure de migration décrite dans les sections suivantes utilise la gcloud CLI pour configurer et activer les étapes de la migration. Commencez par vous connecter Google Cloud et sélectionnez le projet qui hébergera le pipeline de migration.

gcloud auth login
gcloud config set project "$PROJECT_ID"

Créer un profil de connexion pour la base de données source

MongoDB sur Compute Engine

Exécutez la commande suivante pour créer un profil de connexion Datastream à la base de données MongoDB hébergée sur Compute Engine.

  • Omettez l'indicateur --mongodb-replica-set de la commande suivante lorsque vous vous connectez à un cluster fragmenté.
  • N'omettez l'indicateur --mongodb-additional-options=readPreference=secondary que lorsque vous vous connectez à une instance autonome sans secondaires d'ensemble d'instances dupliquées. 
gcloud datastream connection-profiles create "$SRC_CONNECTION_PROFILE_NAME" \
--display-name="$SRC_CONNECTION_PROFILE_NAME" \
--location="$LOCATION" \
--mongodb-username="$MONGODB_USERNAME" \
--mongodb-password="$MONGODB_PASSWORD" \
--mongodb-host-addresses="$MONGODB_IP_ADDRESS" \
--mongodb-replica-set="$REPLICA_SET" \
--private-connection="$PRIVATE_CONNECTION_NAME" \
--mongodb-standard-connection-format \
--type=mongodb \
--mongodb-direct-connection \
--mongodb-additional-options=readPreference=secondary

MongoDB via SSH

Cet exemple suppose que vous avez déjà configuré la connectivité SSH à votre réseau privé, directement à la machine hébergeant le serveur compatible avec MongoDB ou via un hôte bastion.

Exécutez la commande suivante pour créer un profil de connexion Datastream à la base de données MongoDB hébergée sur Compute Engine.

  • Omettez l'indicateur --mongodb-replica-set de la commande suivante lorsque vous vous connectez à un cluster fragmenté.
  • N'omettez l'indicateur --mongodb-additional-options=readPreference=secondary que lorsque vous vous connectez à une instance autonome sans secondaires d'ensemble d'instances dupliquées.

Si vous souhaitez vous connecter avec un mot de passe SSH, transmettez l'indicateur --forward-ssh-password au lieu de l'indicateur --forward-ssh-private-key.

gcloud datastream connection-profiles create "$SRC_CONNECTION_PROFILE_NAME" \
--display-name="$SRC_CONNECTION_PROFILE_NAME" \
--location="$LOCATION" \
--mongodb-username="$MONGODB_USERNAME" \
--mongodb-password="$MONGODB_PASSWORD" \
--mongodb-host-addresses="$MONGODB_IP_ADDRESS" \
--mongodb-replica-set="$REPLICA_SET" \
--forward-ssh-hostname="$BASTION_IP_ADDRESS" \
--forward-ssh-port="$BASTION_SSH_PORT" \
--forward-ssh-username="$BASTION_SSH_USERNAME" \
--forward-ssh-private-key="$BASTION_SSH_PRIVATE_KEY" \
--mongodb-standard-connection-format \
--type=mongodb \
--mongodb-direct-connection \
--mongodb-additional-options=readPreference=secondary

Amazon DocumentDB

Cet exemple suppose que vous avez obtenu les paramètres et les certificats requis pour la connectivité Amazon DocumentDB.

Avant de créer un profil de connexion, activez explicitement les flux de modifications dans la base de données Amazon DocumentDB. Pour savoir comment activer cette fonctionnalité, consultez le guide Flux de modifications Amazon DocumentDB.

Exécutez la commande suivante pour créer un profil de connexion Datastream à votre base de données DocumentDB :

gcloud datastream connection-profiles create "$SRC_CONNECTION_PROFILE_NAME" \
--display-name="$SRC_CONNECTION_PROFILE_NAME" \
--location="$LOCATION" \
--mongodb-username="$MONGODB_USERNAME" \
--mongodb-password="$MONGODB_PASSWORD" \
--mongodb-host-addresses="$MONGODB_HOST_ADDRESS" \
--mongodb-replica-set="$REPLICA_SET" \
--forward-ssh-hostname="$BASTION_IP_ADDRESS" \
--forward-ssh-port="$BASTION_SSH_PORT" \
--forward-ssh-username="$BASTION_SSH_USERNAME" \
--forward-ssh-private-key="$BASTION_SSH_PRIVATE_KEY" \
--mongodb-ca-certificate="$DOCUMENT_DB_CA_CERTIFICATE" \
--mongodb-tls \
--mongodb-standard-connection-format \
--type=mongodb \
--mongodb-direct-connection

Azure Cosmos DB

Activez explicitement les flux de modifications pour MongoDB dans l'API d'Azure Cosmos DB afin de pouvoir lancer des flux Datastream.

Cette étape nécessite l'installation d'Azure CLI.

az resource patch --ids "/subscriptions/subscription_id/resourceGroups/resource_group_name/providers/Microsoft.DocumentDB/mongoClusters/vCore_cluster_name" \
--api-version 2024-10-01-preview \
--properties "{\"previewFeatures\": [ \"ChangeStreams\"]}"

Remplacez subscription_id, resource_group_name et vCore_cluster_name par des valeurs correspondant à votre déploiement Azure Cosmos DB.

Exécutez la commande suivante pour créer un profil de connexion Datastream à l'instance Azure Cosmos DB source.

Cet exemple suppose que la source est accessible via un DNS public ou une adresse IP pouvant être exprimée au format de connexion MongoDB SRV. Les instructions supposent également que le serveur Azure Cosmos DB utilise une combinaison de nom d'utilisateur et de mot de passe pour l'authentification.

gcloud datastream connection-profiles create "$SRC_CONNECTION_PROFILE_NAME" \
--display-name="$SRC_CONNECTION_PROFILE_NAME" \
--location="$LOCATION" \
--mongodb-username="$MONGODB_USERNAME" \
--mongodb-password="$MONGODB_PASSWORD" \
--mongodb-host-addresses="$MONGODB_HOST_ADDRESS" \
--mongodb-srv-connection-format \
--type=mongodb \
--static-ip-connectivity \
--labels=skip_all_validations=true

MongoDB Atlas

Exécutez la commande suivante pour créer un profil de connexion Datastream à la base de données MongoDB Atlas source.

Cet exemple suppose que la source est accessible via un DNS public ou une adresse IP pouvant être exprimée au format de connexion MongoDB SRV. Les instructions supposent également que le serveur MongoDB Atlas utilise une combinaison de nom d'utilisateur et de mot de passe pour l'authentification.

gcloud datastream connection-profiles create "$SRC_CONNECTION_PROFILE_NAME" \
--display-name="$SRC_CONNECTION_PROFILE_NAME" \
--location="$LOCATION" \
--mongodb-username="$MONGODB_USERNAME" \
--mongodb-password="$MONGODB_PASSWORD" \
--mongodb-host-addresses="$MONGODB_HOST_ADDRESS" \
--mongodb-srv-connection-format \
--type=mongodb \
--static-ip-connectivity \
--mongodb-additional-options=readPreference=secondary

Pour en savoir plus sur la surveillance de la création du profil de connexion, consultez la section Résoudre les problèmes.

Créer un profil de connexion Cloud Storage

Configurez le profil de connexion Datastream pour la destination Cloud Storage, qui correspond au bucket que vous avez créé précédemment.

gcloud datastream connection-profiles create "$DST_CONNECTION_PROFILE_NAME" \
--display-name="$DST_CONNECTION_PROFILE_NAME" \
--location="$LOCATION" \
--type=google-cloud-storage \
--bucket="$GCS_BUCKET_NAME" \
--root-path="/$GCS_BUCKET_ROOT_PATH"

Pour en savoir plus sur la surveillance de la création du profil de connexion, consultez la section Résoudre les problèmes.

Étape suivante

Passez à Importer à partir de la base de données source.