Crear perfiles de conexión

En esta página se describe la parte de preparación del proceso de migración, en la que se crean perfiles de conexión de Datastream que se usarán más adelante para importar datos de la base de datos de origen compatible con MongoDB al segmento de Cloud Storage.

En esta fase, debes hacer lo siguiente:

  1. Crea un perfil de conexión de Cloud Storage para el segmento de Cloud Storage que has creado anteriormente.
  2. Crea un perfil de conexión para la base de datos de origen compatible con MongoDB.

Iniciar sesión en la CLI de gcloud

El procedimiento de migración que se describe en las secciones siguientes usa la CLI de gcloud para configurar y activar los pasos de la migración. Para empezar, inicia sesión Google Cloud y selecciona el proyecto que alojará la canalización de migración.

gcloud auth login
gcloud config set project "$PROJECT_ID"

Crear un perfil de conexión para la base de datos de origen

MongoDB en Compute Engine

Ejecuta el siguiente comando para crear un perfil de conexión de Datastream a la base de datos de MongoDB alojada en Compute Engine.

Omite la marca --mongodb-replica-set del siguiente comando cuando te conectes a un clúster fragmentado. 

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 a través de SSH

En este ejemplo se da por hecho que ya has configurado la conectividad SSH a tu red privada, ya sea directamente a la máquina que aloja el servidor compatible con MongoDB o a través de un host bastión.

Ejecuta el siguiente comando para crear un perfil de conexión de Datastream a la base de datos de MongoDB alojada en Compute Engine.

Omite la marca --mongodb-replica-set del siguiente comando cuando te conectes a un clúster fragmentado.

Si quieres conectarte con una contraseña SSH, pasa la marca --forward-ssh-password en lugar de la marca --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

Amazon DocumentDB

En este ejemplo se da por hecho que has obtenido los parámetros y los certificados necesarios para la conectividad de Amazon DocumentDB.

Antes de crear un perfil de conexión, habilita explícitamente los flujos de cambios en la base de datos de Amazon DocumentDB. Consulta la guía de Change Streams de Amazon DocumentDB para obtener instrucciones sobre cómo habilitar esta función.

Ejecuta el siguiente comando para crear un perfil de conexión de Datastream a tu base de datos 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

Habilita explícitamente los flujos de cambios de MongoDB en la API de Azure Cosmos DB para poder iniciar flujos de Datastream.

Para completar este paso, debes instalar la CLI de 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\"]}"

Sustituye subscription_id, resource_group_name y vCore_cluster_name por los valores correspondientes a tu implementación de Azure Cosmos DB.

Ejecuta el siguiente comando para crear un perfil de conexión de Datastream a la fuente de Azure Cosmos DB.

En este ejemplo se da por hecho que se puede acceder al origen a través de un DNS público o una dirección IP que se puede expresar en el formato de conexión SRV de MongoDB. En las instrucciones también se da por hecho que el servidor de Azure Cosmos DB usa una combinación de nombre de usuario y contraseña para la autenticación.

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

Ejecuta el siguiente comando para crear un perfil de conexión de Datastream a la base de datos de origen de MongoDB Atlas.

En este ejemplo se da por hecho que se puede acceder al origen a través de un DNS público o una dirección IP que se puede expresar en el formato de conexión SRV de MongoDB. En las instrucciones también se da por hecho que el servidor de MongoDB Atlas usa una combinación de nombre de usuario y contraseña para la autenticación.

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

Para obtener más información sobre cómo monitorizar la creación de perfiles de conexión, consulta Solución de problemas.

Crear un perfil de conexión de Cloud Storage

Configura el perfil de conexión de Datastream para el destino de Cloud Storage, que es el segmento que has creado anteriormente.

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"

Para obtener más información sobre cómo monitorizar la creación de perfiles de conexión, consulta Solución de problemas.

Siguientes pasos

Vaya a Importar desde la base de datos de origen.