Uso di Oracle Database API for MongoDB

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 for 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 for MongoDB, la rete deve essere configurata e il tipo di accesso deve essere: Accesso sicuro solo 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 strumento.
2. Fare clic su Modifica configurazione strumento.
3. Nella riga API MongoDB, selezionare la colonna Abilita strumento per visualizzare Abilitato.
4. Fare clic su Applica.

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

Descrizione dell'immagine adb_tools_mongo_connect_string.png

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

1. Eseguire il login come utente di test. Per ulteriori informazioni, vedere Crea un utente di test di Autonomous Database 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 dell'URI per sostituire eventuali caratteri riservati nell'URI della stringa di connessione, in particolare i caratteri nel nome utente e nella password. Questi sono i caratteri riservati e la loro percentuale di codifiche:

   !	#	$	%	&	'	(	)	*	+
   %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, potrebbe essere possibile fornire un nome utente e una password come parametri separati, anziché come parte di una stringa di connessione URI. In questo 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, ad esempio Database Actions.

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

   
   Descrizione dell'immagine database_actions_sql_for_mongodb_use.png

1. Scaricare Node.js. Se è già stato scaricato o installato Node.js 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 è già stato scaricato o installato Node.js per l'ambiente in uso, è possibile saltare questo passaggio.

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

3. Configurare la variabile d'ambiente PATH. Se è già stato scaricato o installato Node.js 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 dell'URI per sostituire eventuali caratteri riservati nell'URI della stringa di connessione, in particolare i caratteri nel nome utente e nella password. Questi sono i caratteri riservati e la loro percentuale di codifiche:

      !	#	$	%	&	'	(	)	*	+
      %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, potrebbe essere possibile fornire un nome utente e una password come parametri separati, anziché come parte di una stringa di connessione URI. In questo caso probabilmente non sarà necessario codificare i caratteri riservati che contengono.

      Vedere anche:

      • Codifica percentuale - Caratteri riservati

      • URI (Uniform Resource Identifier): sintassi generica

   4. Eseguire l'esempio. L'output dovrebbe essere simile al seguente.

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