Per utilizzare l'API MongoDB, è possibile creare e configurare un nuovo Autonomous Database o modificare la configurazione di un Autonomous Database esistente configurando le ACL o definendo un endpoint privato.

Configurare un nuovo Autonomous Database per MongoDB

Attenersi alla procedura descritta in Esegui provisioning o copia di un Autonomous Database, fino al punto in cui si seleziona il tipo di accesso alla rete.

Descrizione dell'immagine adb_network_access_acl_provision.png

A questo punto, per utilizzare Oracle Database API per MongoDB, configurare l'accesso sicuro selezionando e configurando uno dei seguenti tipi di accesso alla rete:

• Accesso sicuro solo da IP e VCN consentiti

• Solo accesso endpoint privato

  Per informazioni sulla configurazione di un'istanza di Autonomous Database con un endpoint privato, vedere Configura accesso di rete con endpoint privati.

Configurare un Autonomous Database esistente per MongoDB

Aprire la console di Oracle Cloud Infrastructure per l'istanza di Autonomous Database.

Descrizione dell'immagine adb_ajd_console_details.png

Nota

Per utilizzare Oracle Database API per MongoDB è necessario configurare la rete e il tipo di accesso deve essere uno dei seguenti: Solo accesso sicuro da IP e VCN consentiti o Solo accesso endpoint privato.

Dopo aver configurato l'accesso di rete per l'istanza di Autonomous Database, abilitare l'API MongDB.

1. Nella pagina dei dettagli di Autonomous Database, selezionare la scheda Configurazione degli strumenti.
2. Fare clic su Modifica configurazione strumento.
3. Nella riga dell'API MongoDB selezionare Abilita strumento nella colonna per visualizzare Abilitato.
4. Fare clic su Applica.

1. Nella pagina dei dettagli di Autonomous Database, selezionare la scheda Configurazione degli strumenti.
2. Nella riga dell'API MongoDB, in URL di accesso fare clic su Copia.

Descrizione dell'immagine adb_tools_mongo_connect_string.png

• Recuperare la stringa di connessione a Autonomous Database da Database Actions
  

1. Eseguire il login come utente di test. Per ulteriori informazioni, vedere Creare un utente di Autonomous Database di test per MongoDB.

   $ mongosh --tls --tlsAllowInvalidCertificates 'mongodb://TESTUSER:<PASSWORD>@<database URL>.
   <OCI region>.oraclecloudapps.com:27017/admin?authMechanism=PLAIN&authSource=$external&ssl=true&loadBalanced=false'
   Current Mongosh Log ID: 614c9e2a01e3575c8c0b2ec7
   Connecting to:         mongodb://TESTUSER:<PASSWORD>@<database URL>.<OCIregion>.oraclecloudapps.com:27017/admin?
   authMechanism=PLAIN&authSource=$external&tls=true&loadBalanced=false
   Using MongoDB:                   3.6.2
   Using Mongosh:                   1.0.7
   For mongosh info see: https://docs.mongodb.com/mongodb-shell/admin
   > show dbs
   testuser    0 B
   > 

   Nota
   
   

   Utilizzare la codifica percentuale URI per sostituire qualsiasi carattere riservato nell'URI della stringa di connessione, in particolare i caratteri nel nome utente e nella password. Questi sono i caratteri riservati e le relative codifiche percentuali:

   !	#	$	%	&	'	(	)	*	+
   %21	%23	%24	%25	%26	%27	%28	%29	%2A	%2B

   ,	/	:	;	=	?	@	[	]
   %2C	%2F	%3A	%3B	%3D	%3F	%40	%5B	%5D

   Ad esempio, se il nome utente è RUTH e la password è @least1/2#?, la stringa di connessione MongoDB al server <server> potrebbe essere simile alla seguente:

   'mongodb://RUTH:%40least1%2F2%23%3F@<server>:27017/ruth/ ...'

   A seconda degli strumenti o dei driver utilizzati, è possibile fornire un nome utente e una password come parametri separati, anziché come parte di una stringa di connessione URI. In tal caso, probabilmente non sarà necessario codificare i caratteri riservati che contengono.

   Vedere anche:

   • Codifica percentuale - Caratteri riservati

   • URI (Uniform Resource Identifier): sintassi generica

2. Creare una raccolta e inserire documenti nella raccolta.

   testuser> show collections
   
   testuser> db.createCollection( 'fruit' )
   { ok: 1 }
   testuser> show collections
   fruit
   testuser> db.fruit.insertOne( {name:"orange", count:42} )
   {
     acknowledged: true,
     insertedId: ObjectId("614ca31fdab254f63e4c6b47")
   }
   testuser> db.fruit.insertOne( {name:"apple", count:12, color: "red"} )
   {
     acknowledged: true,
     insertedId: ObjectId("614ca340dab254f63e4c6b48")
   }
   testuser> db.fruit.insertOne( {name:"pear", count:5} )
   {
     acknowledged: true,
     insertedId: ObjectId("614ca351dab254f63e4c6b49")
   }
   testuser>

3. Eseguire una query sulla raccolta utilizzando un client SQL come Database Actions.

   SELECT
        f.json_document.name, 
        f.json_document.count, 
        f.json_document.color
   FROM fruit f;

1. Scarica Node.js. Se Node.js è già stato scaricato o installato per l'ambiente in uso, è possibile saltare questo passaggio.

   $ wget https://nodejs.org/dist/latest-v14.x/node-v14.17.5-linux-x64.tar.xz

2. Estrarre il contenuto dell'archivio Node,js. Se Node.js è già stato scaricato o installato per l'ambiente in uso, è possibile saltare questo passaggio.

   $ tar -xf node-v14.17.5-linux-x64.tar.xz

3. Configurare la variabile di ambiente PATH. Se Node.js è già stato scaricato o installato per l'ambiente in uso, è possibile saltare questo passaggio.

   $ export PATH="`pwd`"/node-v14.17.5-linux-x64/bin:$PATH

4. Prova la tua connessione con un esempio di Javascript.
   1. Crea una nuova directory.

      $ mkdir autonomous_mongodb
      $ cd autonomous_mongodb
      $ npm init –y

   2. Installare la dipendenza mongodb.

      $ npm install mongodb

   3. Creare un'applicazione JavaScript denominata connect.js.

      const { MongoClient } = require("mongodb");
      const uri =
         "mongodb://TESTUSER:<PASSWORD>@<Database URI>.<OCI region>.oraclecloudapps.com:27017/admin?authMechanism=PLAIN&authSource=$external&ssl=true&loadBalanced=false";
      
      const client = new MongoClient(uri);
      
      async function run() {
        try {
              await client.connect();
      
              const database = client.db('admin');
              const movies = database.collection('movies');
      
              // Insert a movie
              const doc = { title: 'Back to the Future', 
                            year: 1985, genres: ['Adventure', 'Comedy', 'Sci-Fi'] }
              const result = await movies.insertOne(doc);
      
              // Query for a movie that has the title 'Back to the Future' :)
              const query = { title: 'Back to the Future' };
              const movie = await movies.findOne(query);
      
              console.log(movie);
        } finally {
           // Ensures that the client will close when you finish/error
           await client.close();
        }
      }
      run().catch(console.dir);
      

      Nota
      
      

      Utilizzare la codifica percentuale URI per sostituire qualsiasi carattere riservato nell'URI della stringa di connessione, in particolare i caratteri nel nome utente e nella password. Questi sono i caratteri riservati e le relative codifiche percentuali:

      !	#	$	%	&	'	(	)	*	+
      %21	%23	%24	%25	%26	%27	%28	%29	%2A	%2B

      ,	/	:	;	=	?	@	[	]
      %2C	%2F	%3A	%3B	%3D	%3F	%40	%5B	%5D

      Ad esempio, se il nome utente è RUTH e la password è @least1/2#?, la stringa di connessione MongoDB al server <server> potrebbe essere simile alla seguente:

      'mongodb://RUTH:%40least1%2F2%23%3F@<server>:27017/ruth/ ...'

      A seconda degli strumenti o dei driver utilizzati, è possibile fornire un nome utente e una password come parametri separati, anziché come parte di una stringa di connessione URI. In tal caso, probabilmente non sarà necessario codificare i caratteri riservati che contengono.

      Vedere anche:

      • Codifica percentuale - Caratteri riservati

      • URI (Uniform Resource Identifier): sintassi generica

   4. Esegui l'esempio. L'output deve essere simile al seguente.

      $ node connect
      {
        _id: new ObjectId("611e3266005202371acf27c1"),
        title: 'Back to the Future',
        year: 1985,
        genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ]
      }