Criar perfis de conexão

Esta página descreve a parte de preparação do processo de migração em que você cria perfis de conexão do Datastream que serão usados mais tarde para importar dados do banco de dados de origem compatível com o MongoDB para o bucket do Cloud Storage.

Nesta etapa, faça o seguinte:

  1. Crie um perfil de conexão do Cloud Storage para o bucket do Cloud Storage que você criou anteriormente.
  2. Crie um perfil de conexão para o banco de dados de origem compatível com o MongoDB.

Fazer login na CLI gcloud

O procedimento de migração descrito nas seções subsequentes usa a CLI gcloud para configurar e ativar as etapas de migração. Comece fazendo login Google Cloud e selecionando o projeto que vai hospedar o pipeline de migração.

gcloud auth login
gcloud config set project "$PROJECT_ID"

Criar um perfil de conexão para o banco de dados de origem

MongoDB no Compute Engine

Execute o comando a seguir para criar um perfil de conexão do Datastream para o banco de dados do MongoDB hospedado no Compute Engine.

Omita a flag --mongodb-replica-set do comando a seguir ao se conectar a um cluster 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 via SSH

Este exemplo pressupõe que você já tenha configurado a conectividade SSH à sua rede particular, diretamente na máquina que hospeda o servidor compatível com o MongoDB ou por um host bastion.

Execute o comando a seguir para criar um perfil de conexão do Datastream para o banco de dados do MongoDB hospedado no Compute Engine.

Omita a flag --mongodb-replica-set do comando a seguir ao se conectar a um cluster fragmentado.

Se você quiser se conectar com uma senha SSH, transmita a flag --forward-ssh-password em vez da 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

Amazon DocumentDB

Este exemplo pressupõe que você tenha recebido os parâmetros e certificados necessários para a conectividade do Amazon DocumentDB.

Antes de criar um perfil de conexão, ative explicitamente os fluxo de alterações no banco de dados do Amazon DocumentDB. Consulte o guia de fluxos de mudança do Amazon DocumentDB (em inglês) para instruções sobre como ativar esse recurso.

Execute o comando a seguir para criar um perfil de conexão do Datastream para o banco de dados do 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

Ative explicitamente os fluxo de alterações para o MongoDB na API do Azure Cosmos DB para iniciar streams do Datastream.

Esta etapa exige a instalação da CLI do 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\"]}"

Substitua subscription_id, resource_group_name e vCore_cluster_name por valores correspondentes à sua implantação do Azure Cosmos DB.

Execute o comando a seguir para criar um perfil de conexão do Datastream para o Azure Cosmos DB de origem.

Este exemplo pressupõe que a origem seja acessível por um DNS público ou endereço IP que possa ser expresso no formato de conexão SRV do MongoDB. As instruções também pressupõem que o servidor do Azure Cosmos DB use uma combinação de nome de usuário e senha para autenticação.

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

Execute o comando a seguir para criar um perfil de conexão do Datastream para o banco de dados de origem do MongoDB Atlas.

Este exemplo pressupõe que a origem seja acessível por um DNS público ou endereço IP que possa ser expresso no formato de conexão SRV do MongoDB. As instruções também pressupõem que o servidor do MongoDB Atlas use uma combinação de nome de usuário e senha para autenticação.

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 mais informações sobre como monitorar a criação do perfil de conexão, consulte Solução de problemas.

Criar um perfil de conexão do Cloud Storage

Configure o perfil de conexão do Datastream para o destino do Cloud Storage, que é o bucket que você criou 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 mais informações sobre como monitorar a criação do perfil de conexão, consulte Solução de problemas.

A seguir

Prossiga para Importar do banco de dados de origem.