Oracle Database-API für MongoDB verwenden

Um die MongoDB-API zu verwenden, können Sie eine neue Autonomous Database erstellen und konfigurieren oder die Konfiguration einer vorhandenen Autonomous Database ändern, indem Sie ACLs konfigurieren oder einen privaten Endpunkt definieren.

Neue Autonomous Database für MongoDB konfigurieren

Befolgen Sie die Schritte unter Autonomous Database bereitstellen oder klonen bis zu dem Punkt, an dem Sie Ihren Netzwerkzugriffstyp auswählen.

Beschreibung der Abbildung adb_network_access_acl_provision.png

Wenn Sie jetzt mit Oracle Database API for MongoDB sicheren Zugriff konfigurieren möchten, wählen und konfigurieren Sie einen der folgenden Netzwerkzugriffstypen:

• Sicherer Zugriff nur von zulässigen IPs und VCNs

• Nur Zugriff über privaten Endpunkt

  Informationen zum Konfigurieren einer Autonomous Database-Instanz mit einem privaten Endpunkt finden Sie unter Netzwerkzugriff mit privaten Endpunkten konfigurieren.

Vorhandene Autonomous Database für MongoDB konfigurieren

Öffnen Sie die Oracle Cloud Infrastructure-Konsole für Ihre Autonomous Database-Instanz.

Beschreibung der Abbildung adb_ajd_console_details.png

Hinweis

Um Oracle Database API for MongoDB zu verwenden, muss das Netzwerk konfiguriert sein, und der Zugriffstyp muss entweder Sicherer Zugriff nur von zulässigen IPs und VCNs oder Nur Zugriff auf privaten Endpunkt lauten.

Nachdem Sie den Netzwerkzugriff für die Autonomous Database-Instanz konfiguriert haben, aktivieren Sie die MongDB-API.

1. Wählen Sie auf der Seite "Autonomous Database details" die Registerkarte Tool configuration aus.
2. Klicken Sie auf Toolkonfiguration bearbeiten.
3. Wählen Sie in der API-Zeile MongoDB die Option Tool aktivieren aus, um Aktiviert anzuzeigen.
4. Klicken Sie auf Anwenden.

1. Wählen Sie auf der Seite "Autonomous Database details" die Registerkarte Tool configuration aus.
2. Klicken Sie in der API-Zeile MongoDB unter "Zugriffs-URL" auf Kopieren.

Beschreibung der Abbildung adb_tools_mongo_connect_string.png

• Autonomous Database-Verbindungszeichenfolge aus Database Actions abrufen
  

1. Melden Sie sich als Testbenutzer an. Weitere Informationen finden Sie unter Autonomous Database-Testbenutzer für MongoDB erstellen.

   $ 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
   > 

   Hinweis
   
   

   Verwenden Sie die prozentuale URI-Kodierung, um reservierte Zeichen in Ihrer Verbindungszeichenfolge-URI zu ersetzen – insbesondere Zeichen in Ihrem Benutzernamen und Kennwort. Dies sind die reservierten Zeichen und ihre Prozentcodierungen:

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

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

   Beispiel: Wenn Ihr Benutzername RUTH lautet und Ihr Kennwort @least1/2#? lautet, könnte die Verbindungszeichenfolge MongoDB für Server <server> wie folgt aussehen:

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

   Abhängig von den Tools oder Treibern, die Sie verwenden, können Sie einen Benutzernamen und ein Passwort als separate Parameter anstelle einer URI-Verbindungszeichenfolge angeben. In diesem Fall müssen Sie wahrscheinlich keine reservierten Zeichen codieren, die sie enthalten.

   Siehe auch:

   • Prozentcodierung - Reservierte Zeichen

   • Uniform Resource Identifier (URI): Allgemeine Syntax

2. Erstellen Sie eine Sammlung, und fügen Sie Dokumente in Ihre Sammlung ein.

   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. Fragen Sie die Collection mit einem SQL-Client ab, wie Database Actions.

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

   
   Beschreibung der Abbildung database_actions_sql_for_mongodb_use.png

1. Laden Sie Node.js herunter. Wenn Sie Node.js für Ihre Umgebung bereits heruntergeladen oder installiert haben, können Sie diesen Schritt überspringen.

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

2. Extrahieren Sie den Inhalt des Node,js-Archivs. Wenn Sie Node.js für Ihre Umgebung bereits heruntergeladen oder installiert haben, können Sie diesen Schritt überspringen.

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

3. Konfigurieren Sie die Umgebungsvariable PATH. Wenn Sie Node.js für Ihre Umgebung bereits heruntergeladen oder installiert haben, können Sie diesen Schritt überspringen.

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

4. Testen Sie Ihre Verbindung mit einem Javascript-Beispiel.
   1. Neues Verzeichnis erstellen.

      $ mkdir autonomous_mongodb
      $ cd autonomous_mongodb
      $ npm init –y

   2. Installieren Sie die Mangodb-Abhängigkeit.

      $ npm install mongodb

   3. Erstellen Sie eine JavaScript-Anwendung namens 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);
      

      Hinweis
      
      

      Verwenden Sie die prozentuale URI-Kodierung, um reservierte Zeichen in Ihrer Verbindungszeichenfolge-URI zu ersetzen – insbesondere Zeichen in Ihrem Benutzernamen und Kennwort. Dies sind die reservierten Zeichen und ihre Prozentcodierungen:

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

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

      Beispiel: Wenn Ihr Benutzername RUTH lautet und Ihr Kennwort @least1/2#? lautet, könnte die Verbindungszeichenfolge MongoDB für Server <server> wie folgt aussehen:

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

      Abhängig von den Tools oder Treibern, die Sie verwenden, können Sie einen Benutzernamen und ein Passwort als separate Parameter anstelle einer URI-Verbindungszeichenfolge angeben. In diesem Fall müssen Sie wahrscheinlich keine reservierten Zeichen codieren, die sie enthalten.

      Siehe auch:

      • Prozentcodierung - Reservierte Zeichen

      • Uniform Resource Identifier (URI): Allgemeine Syntax

   4. Führen Sie das Beispiel aus. Die Ausgabe sollte der folgenden ähneln.

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