Estabelecer Conexão com o MongoDB

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

Antes de começar

Verifique se:

Criar a conexão

Para criar uma conexão MongoDB:

  1. Na página Visão Geral do OCI GoldenGate, selecione Conexões.

    Você também pode selecionar Criar Conexão na seção Conceitos básicos e pular para a etapa 3.

  2. Na página Conexões, selecione Criar Conexão.

  3. Na página Criar Conexão, preencha os campos da seguinte forma:

    1. Para Nome, informe 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 o GoldenGate no 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 de string de conexão MongoDB válido sem o nome de usuário e a senha. Por exemplo, mongodb://mongodb1.example.com:27017.

    7. Para Nome de Usuário, informe o nome de usuário para este 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 seção Segurança em Opções Avançadas, localizada na parte inferior deste formulário.

      • Quando precisar atualizar o conteúdo do Segredo, certifique-se de:

    9. Para Protocolo de segurança, selecione o protocolo de Segurança:

      • Sem Formatação: 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 todo o gerenciamento de chaves de criptografia para a Oracle.

          • 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 a conectividade do 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 a 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. Selecione 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.

Próximas etapas

Problemas conhecidos

MongoDB, DocumentDB e Oracle JSON Collection TLS Security Protocol

Se a conexão Replicat do MongoDB, Replicat do DocumentDB ou Coleção do Oracle JSON falhar com o seguinte erro no arquivo de Relatório:

Error: Caused by: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

Solução alternativa: Adicione a seguinte propriedade ao arquivo Properties, atualize <connection_ocid> com o OCID da sua conexão e mantenha o restante como está.

jvm.bootoptions=-Djavax.net.ssl.trustStore=/u02/connections/<connection_ocid>/truststore.pkcs12 -Djavax.net.ssl.trustStorePassword=Welcome123

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

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

  1. No MongoDB Atlas, selecione Connect.

  2. Selecione 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 conexão de Teste do MongoDB

Você pode encontrar um erro ao usar a conexão de Teste 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 selecione Configuração. Sua conexão MongoDB deve ser listada como uma credencial, na qual você pode selecionar **Conectar-se ao ** para testar a conexão.