Crie perfis de ligação

Esta página descreve a parte de preparação do processo de migração em que cria perfis de ligação do Datastream que vão ser usados mais tarde para importar dados da base de dados de origem compatível com o MongoDB para o contentor do Cloud Storage.

Nesta fase, faz o seguinte:

  1. Crie um perfil de ligação do Cloud Storage para o contentor do Cloud Storage que criou anteriormente.
  2. Crie um perfil de associação para a base de dados de origem compatível com o MongoDB.

Inicie sessão na CLI gcloud

O procedimento de migração descrito nas secções seguintes usa a CLI gcloud para configurar e acionar os passos de migração. Comece por iniciar sessão Google Cloud e selecionar o projeto que vai alojar o pipeline de migração.

gcloud auth login
gcloud config set project "$PROJECT_ID"

Crie um perfil de associação para a base de dados de origem

MongoDB no Compute Engine

Execute o seguinte comando para criar um perfil de associação do Datastream à base de dados MongoDB alojada no Compute Engine.

Omita a flag --mongodb-replica-set do seguinte comando quando se ligar a um cluster dividido em partições. 

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

Este exemplo pressupõe que já configurou a conetividade SSH à sua rede privada, diretamente para a máquina que aloja o servidor compatível com o MongoDB ou através de um anfitrião Bastion.

Execute o seguinte comando para criar um perfil de associação do Datastream à base de dados MongoDB alojada no Compute Engine.

Omita a flag --mongodb-replica-set do seguinte comando quando se ligar a um cluster fragmentado.

Se quiser estabelecer ligação com uma palavra-passe SSH, transmita o sinalizador --forward-ssh-password em vez do sinalizador --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 obteve os parâmetros e os certificados necessários para a conetividade do Amazon DocumentDB.

Antes de criar um perfil de associação, ative explicitamente as streams de alterações na base de dados do Amazon DocumentDB. Consulte o guia Amazon DocumentDB Change Streams para ver instruções sobre como ativar esta funcionalidade.

Execute o seguinte comando para criar um perfil de ligação do Datastream à sua base 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 as streams de alterações para o MongoDB na API do Azure Cosmos DB para ativar o início de streams do Datastream.

Este passo requer 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 implementação do Azure Cosmos DB.

Execute o seguinte comando para criar um perfil de associação do fluxo de dados à origem do Azure Cosmos DB.

Este exemplo pressupõe que a origem é acessível através de um DNS público ou de um endereço IP que pode ser expresso no formato de ligação SRV do MongoDB. As instruções também pressupõem que o servidor do Azure Cosmos DB usa uma combinação de um nome de utilizador e uma palavra-passe 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 seguinte comando para criar um perfil de ligação do Datastream à base de dados MongoDB Atlas de origem.

Este exemplo pressupõe que a origem é acessível através de um DNS público ou de um endereço IP que pode ser expresso no formato de ligação SRV do MongoDB. As instruções também partem do princípio de que o servidor do MongoDB Atlas usa uma combinação de um nome de utilizador e uma palavra-passe 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 a monitorização da criação do perfil de associação, consulte a secção Resolução de problemas.

Crie um perfil de associação do Cloud Storage

Configure o perfil de ligação da stream de dados para o destino do Cloud Storage, que é o contentor que 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 a monitorização da criação do perfil de associação, consulte a secção Resolução de problemas.

O que se segue?

Continue para Importar da base de dados de origem.