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 allez effectuer les opérations suivantes :
- Créez un profil de connexion Cloud Storage pour le bucket Cloud Storage que vous avez créé précédemment.
- Créez un profil de connexion pour la base de données source compatible avec MongoDB.
Se connecter à gcloud CLI
La procédure de migration décrite dans les sections suivantes utilise la gcloud CLI pour configurer et effectuer les étapes de 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é.
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 via SSH
Cet exemple suppose que vous avez déjà configuré la connectivité SSH à votre réseau privé, soit directement à la machine hébergeant le serveur compatible MongoDB, soit 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é.
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
Azure Cosmos DB
Activez explicitement les flux de modifications pour MongoDB dans l'API Azure Cosmos DB afin de pouvoir lancer des flux Datastream.
Cette étape nécessite l'installation de la CLI Azure.
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 à la base de données Azure Cosmos DB source.
Cet exemple suppose que la source est accessible via une adresse IP ou DNS publique pouvant être exprimée au format de connexion SRV MongoDB. 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 une adresse IP ou DNS publique pouvant être exprimée au format de connexion SRV MongoDB. 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
Pour en savoir plus sur la surveillance de la création de profils de connexion, consultez la section Dépannage.
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 de profils de connexion, consultez la section Dépannage.
Étapes suivantes
Passez à Importer à partir de la base de données source.