Estabelecer Conexão com o MongoDB

Aprenda a criar uma conexão com MongoDB para uso como origem ou destino do OCI GoldenGate.

Tópicos Relacionados

Antes de começar

Antes de criar a conexão, certifique-se de:
  • Verifique como o OCI GoldenGate se conecta à sua origem e aos seus destinos.
  • Configure as políticas necessárias para permitir o acesso seguro ao Vault e aos Segredos, como usar segredos, usar vaults e ler pacotes de segredos. Para obter mais informações, consulte Políticas mínimas recomendadas.
  • Configure um conjunto de replicados MongoDB:
    • O OCI GoldenGate para Big Data usa o log de operações (plog) para ler registros do Change Data Capture (CDC). O oplog é uma coleção limitada no MongoDB que mantém um registro incremental de todas as operações que modificam o banco de dados. Os arquivos Oplog são criados quando um conjunto de réplicas é ativado em MongoDB.
    • MongoDB O Atlas vem pré-configurado com um conjunto Replicat. Para implantações MongoDB on-premises, configure e implante manualmente um conjunto Replicat para ativar a funcionalidade oplog e CDC. Para o MongoDB on-premises, você precisa implantar um conjunto de Réplicas.
  • Ter o MongoDB versão 3.6 ou posterior.
  • Ter suporte ao OCI GoldenGate para capturar as seguintes operações: INSERT, UPDATE, DELETE.

Criar a conexão

Para criar uma MongoDB conexão:
  1. Na página Visão Geral do OCI GoldenGate, clique em Conexões.
    Você também pode clicar em Criar Conexão na seção Conceitos Básicos e ir direto para a etapa 3.
  2. Na página Conexões, clique em Criar Conexão.
  3. Na página Criar Conexão, preencha os campos da seguinte forma:
    1. Para Nome, digite um nome para a conexão.
    2. (Opcional) Para Descrição, informe uma descrição que ajude a distinguir essa conexão de outras.
    3. (Somente para GoldenGate em Multinuvem) Selecione sua Assinatura e preencha os campos a seguir.
      1. Na lista drop-down Compartimento, selecione o compartimento no qual reside a Âncora de Recursos.
      2. Selecione a região de parceiros multicloud.
      3. Selecione sua Zona de disponibilidade do parceiro. As opções disponíveis são preenchidas com base na região de parceiro Multinuvem selecionada.
    4. Para Compartimento, selecione o compartimento no qual a conexão será criada.
    5. Para Tipo, selecione MongoDB.
    6. Para String de conexão, informe um URI válido da string de conexão MongoDB sem o nome de usuário e a senha. Por exemplo, mongodb://mongodb1.example.com:27017.
    7. Para Nome do Usuário, informe o nome do usuário deste banco de dados.
    8. Selecione o Segredo da senha. Se estiver localizado em outro compartimento, use a lista drop-down para alterar compartimentos.

      Observação:

      • Segredos são credenciais como senhas, certificados, chaves SSH ou tokens de autenticação usados nos serviços do OCI. Para criar um segredo, consulte Criando um segredo. Verifique se:
        • Selecione Geração de segredo manual.
        • Cole as credenciais no conteúdo do segredo.
      • Se preferir não usar segredos de senha, certifique-se de desmarcar Usar segredos no vault na guia Definições em Opções Avançadas, localizada na parte inferior deste formulário.
    9. Para Protocolo de segurança, selecione o protocolo de segurança:
      • Simples: autenticação de nome de usuário e senha.
      • TLS: TLS com nome de usuário e senha.
      • MTLS: MTLS com nome de usuário e senha.
    10. Expanda Mostrar opções avançadas. Você pode configurar as seguintes opções;
      • Segurança
        • Desmarque Usar segredos do vault para que você prefira não usar segredos de senha para esta conexão. Caso não esteja selecionado:
          • Selecione Usar chave de criptografia gerenciada pela Oracle para deixar para a Oracle todo o gerenciamento de chaves de criptografia.
          • Selecione Usar chave de criptografia gerenciada pelo cliente para selecionar uma chave de criptografia específica armazenada no OCI Vault para criptografar suas credenciais de conexão.
      • Conectividade de rede
        • Ponto final compartilhado, para compartilhar um ponto final com a implantação atribuída. Você deve permitir conectividade com base no IP de entrada da implantação.
        • Ponto final dedicado, para tráfego de rede por meio de um ponto final dedicado na sub-rede designada na sua VCN. Você deve permitir conectividade dos IPs de entrada dessa conexão.

          Observação:

          • Se uma conexão dedicada permanecer não designada por sete dias, o serviço a converterá em uma conexão compartilhada.
          • Saiba mais sobre a conectividade do Oracle GoldenGate.
      • Atributos de segurança: Adicione atributos de segurança para controlar o acesso a essa conexão usando o ZPR (Zero Trust Packet Routing).
      • Tags: Adicione tags para organizar seus recursos.
  4. Clique em Criar.
Depois que a conexão é criada, ela aparece na lista Conexões. Certifique-se de designar a conexão a uma implantação para usá-la como origem ou destino em uma replicação.

Problemas conhecidos

A conexão MongoDB do OCI GoldenGate não suporta strings de conexão mongdb+srv.

Solução alternativa: use strings de conexão MongoDB.

  1. Em MongoDB Atlas, clique em Conectar.
  2. Selecionar Drivers.
  3. Selecione Java.
  4. Para Versão, selecione 3.4 ou posterior.
  5. Você pode usar a string mongodb fornecida. Por exemplo:
    mongodb://<user_name>:<db_password>@cluster0-shard-00-00.abc.mongodb.net:27017,cluster0-shard-00-01.abc.mongodb.net:27017,cluster0-shard-00-02.abc.mongodb.net:27017/?ssl=true&replicaSet=atlas-3grqh1-shard-0&authSource=admin&retryWrites=true&w=majority&appName=Cluster0

Problema com a conexão de teste MongoDB

Você pode encontrar um erro ao usar Test connection com conexões MongoDB. Você pode ignorar esse erro e testar conexões MongoDB na console de implantação do OCI GoldenGate. Na console de implantação, abra o menu de navegação do Administration Service e clique em Configuração. Sua conexão MongoDB deve ser listada como uma credencial, na qual você pode clicar em Estabelecer Conexão com <alias> para testar a conexão.