Connessione all'API Oracle per MongoDB

Utilizza il tipo di connessione Oracle API for MongoDB per replicare i dati da MongoDB a un Oracle AI Database on-premise o cloud gestito dall'utente.

Prima di iniziare

Assicurarsi di disporre di quanto riportato di seguito.

• Oracle AI Database (21c/26ai)

  • Un pluggable database (PDB) in Oracle AI Database.

  • Un utente creato per ORDS.

• ORDS che consente di connettersi a Oracle AI Database utilizzando l'API MongoDB di Oracle AI Database

  • Generare certificati SSL per ORDS. Assicurarsi di configurare i certificati con FQDN.

  • Installare ORDS e configurarlo con SSL.

• Configurare i criteri necessari per abilitare l'accesso sicuro a vault e segreti, ad esempio l'uso di segreti, i vault e la lettura di bundle di segreti. Per ulteriori informazioni, vedere Criteri consigliati minimi.

Crea la connessione

Per connettersi a Oracle API for MongoDB:

1. Nella pagina Panoramica di OCI GoldenGate, selezionare Connessioni.

   È inoltre possibile selezionare Crea connessione nella sezione Introduzione e passare al passo 3.

2. Nella pagina Connessioni selezionare Crea connessione.

3. Nella pagina Crea connessione, completare i campi come indicato di seguito.

   1. In Nome, immettere un nome per la connessione.

   2. (Facoltativo) In Descrizione, immettere una descrizione che consenta di distinguere questa connessione dalle altre.

   3. (Solo per GoldenGate on Multicloud) Selezionare la propria sottoscrizione, quindi completare i campi riportati di seguito.

      1. Nell'elenco a discesa Compartimento selezionare il compartimento in cui risiede l'ancora risorsa.

      2. Selezionare l'area partner multicloud.

      3. Seleziona la tua zona di disponibilità dei partner. Le opzioni disponibili vengono popolate in base all'area partner multicloud selezionata.

   4. In Compartimento selezionare il compartimento in cui creare la connessione.

   5. Per Tipo, in Big Data selezionare Oracle API for MongoDB.

   6. Per la stringa di connessione, immettere l'URI della stringa di connessione MongoDB senza il nome utente e la password. Ad esempio, mongodb://mongodb1.example.com:27017. Assicurarsi che FQDN venga utilizzato nella connessione per stabilire connessioni SSL.

   7. Per Nome utente, immettere il nome utente per il database.

   8. Selezionare il segreto password. Se si trova in un compartimento diverso, utilizzare l'elenco a discesa per modificare i compartimenti.

      Nota:

      • I segreti sono credenziali quali password, certificati, chiavi SSH o token di autenticazione utilizzati con i servizi OCI. Per creare un segreto, vedere Creazione di un segreto. Assicurarsi di effettuare quanto riportato di seguito.

        • Selezionare Generazione manuale segreto.

        • Incollare le credenziali in Contenuto segreto.

      • Se si preferisce non utilizzare i segreti password, assicurarsi di deselezionare Usa segreti nel vault nella sezione Sicurezza in Opzioni avanzate, nella parte inferiore di questo form.

      • Quando è necessario aggiornare il contenuto del segreto, assicurarsi di:

        • Creare una nuova versione del segreto utilizzando il modello Plain-Text e fornire il contenuto aggiornato. Per ulteriori informazioni, vedere Aggiornamento del contenuto di un segreto.

        • Aggiorna la connessione per cancellare il contenuto segreto inserito nella cache.

4. Per Protocollo di sicurezza, selezionare TLS e caricare il certificato CA.

   1. Espandere l'area Mostra opzioni avanzate È possibile configurare le opzioni riportate di seguito.

      • Sicurezza

        • Deselezionare Usa segreti vault per non utilizzare segreti password per questa connessione. Se l'opzione non viene selezionata:

          • Selezionare Usa chiave di cifratura gestita da Oracle per lasciare a Oracle tutta la gestione delle chiavi di cifratura.

          • Selezionare Usa chiave di cifratura gestita dal cliente per selezionare una chiave di cifratura specifica memorizzata nel vault OCI per cifrare le credenziali di connessione.

      • Connettività di rete

        • Endpoint condiviso per condividere un endpoint con la distribuzione assegnata. È necessario consentire la connettività dall'IP in entrata della distribuzione.

        • Endpoint dedicato, per il traffico di rete attraverso un endpoint dedicato nella subnet assegnata nella tua VCN. È necessario consentire la connettività dagli IP in entrata di questa connessione.

          Nota:

          • Se un collegamento dedicato rimane non assegnato per sette giorni, il servizio lo converte in una connessione condivisa.
          • Ulteriori informazioni sulla connettività di Oracle GoldenGate.

      • Attributi di sicurezza: aggiungere attributi di sicurezza per controllare l'accesso a questa connessione utilizzando Zero Trust Packet Routing (ZPR).

      • Tag: Aggiunge tag per organizzare le risorse.

5. Selezionare Crea.

Una volta creata, la connessione viene visualizzata nell'elenco Connessioni. Assicurarsi di assegnare la connessione a una distribuzione, quindi Aggiungere un Replicat per MongoDB.

Passi successivi

• Assegnare una connessione a una distribuzione
• Gestione connessioni

Problemi noti

MongoDB, DocumentDB e Oracle JSON Collection TLS Security Protocol

Se la connessione Replicat MongoDB, Replicat DocumentDB o Raccolta Oracle JSON non riesce con il seguente errore nel file di report:

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

Soluzione: aggiungere la proprietà seguente al file Properties, aggiornare <connection_ocid> con l'OCID della connessione e mantenere il resto invariato.

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