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 a seguir usa a CLI gcloud para configurar e executar as etapas de migração. Comece fazendo login no 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 com 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 por SSH

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

Execute o comando a seguir para criar um perfil de conexão do Datastream com 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 quiser se conectar com uma senha SSH, transmita a flag --forward-ssh-password em vez de --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

Neste exemplo, presumimos que você tenha obtido 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 Amazon DocumentDB Change Streams (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 com seu 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 do MongoDB na API do Azure Cosmos DB para iniciar fluxos do Datastream.

Essa 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 a origem do Azure Cosmos DB.

Este exemplo pressupõe que a origem esteja acessível por um DNS público ou um 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 com o banco de dados de origem do MongoDB Atlas.

Este exemplo pressupõe que a origem esteja acessível por um DNS público ou um 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 criado 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

Acesse Importar do banco de dados de origem.