Creazione di profili di connessione
Questa pagina descrive la parte di preparazione del processo di migrazione in cui crei profili di connessione Datastream che verranno utilizzati in un secondo momento per importare i dati dal database di origine compatibile con MongoDB al bucket Cloud Storage.
A questo punto, devi:
- Crea un profilo di connessione Cloud Storage per il bucket Cloud Storage che hai creato in precedenza.
- Crea un profilo di connessione per il database di origine compatibile con MongoDB.
Accedi a gcloud CLI
La procedura di migrazione descritta nelle sezioni successive utilizza gcloud CLI per configurare e attivare i passaggi di migrazione. Inizia accedendo a Google Cloud e selezionando il progetto che ospiterà la pipeline di migrazione.
gcloud auth login
gcloud config set project "$PROJECT_ID"
Crea un profilo di connessione per il database di origine
MongoDB su Compute Engine
Esegui il comando seguente per creare un profilo di connessione Datastream al database MongoDB ospitato su Compute Engine.
Ometti il flag --mongodb-replica-set dal comando seguente quando
ti connetti a un cluster partizionato.
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 su SSH
Questo esempio presuppone che tu abbia già configurato la connettività SSH alla tua rete privata, direttamente alla macchina che ospita il server compatibile con MongoDB o tramite un host bastione.
Esegui il comando seguente per creare un profilo di connessione Datastream al database MongoDB ospitato su Compute Engine.
Ometti il flag --mongodb-replica-set dal comando seguente quando
ti connetti a un cluster partizionato.
Se vuoi connetterti con una password SSH, passa il
flag --forward-ssh-password anziché il flag --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
Abilita esplicitamente modifiche in tempo reale per MongoDB nell'API di Azure Cosmos DB per abilitare l'avvio dei flussi Datastream.
Questo passaggio richiede l'installazione dell'interfaccia a riga di comando di 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\"]}"
Sostituisci subscription_id, resource_group_name e vCore_cluster_name con i valori corrispondenti alla tua implementazione di Azure Cosmos DB.
Esegui questo comando per creare un profilo di connessione Datastream all'origine Azure Cosmos DB.
Questo esempio presuppone che l'origine sia accessibile tramite un DNS pubblico o un indirizzo IP che può essere espresso nel formato di connessione SRV MongoDB. Le istruzioni presuppongono inoltre che il server Azure Cosmos DB utilizzi una combinazione di nome utente e password per l'autenticazione.
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
Esegui questo comando per creare un profilo di connessione Datastream al database MongoDB Atlas di origine.
Questo esempio presuppone che l'origine sia accessibile tramite un DNS pubblico o un indirizzo IP che può essere espresso nel formato di connessione SRV MongoDB. Le istruzioni presuppongono inoltre che il server MongoDB Atlas utilizzi una combinazione di nome utente e password per l'autenticazione.
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
Per ulteriori informazioni sul monitoraggio della creazione del profilo di connessione, vedi Risoluzione dei problemi.
Crea un profilo di connessione Cloud Storage
Configura il profilo di connessione Datastream per la destinazione Cloud Storage, ovvero il bucket che hai creato in precedenza.
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"
Per ulteriori informazioni sul monitoraggio della creazione del profilo di connessione, vedi Risoluzione dei problemi.
Passaggi successivi
Vai a Importa dal database di origine.