Um die API MongoDB 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

Um jetzt die Oracle Database-API für MongoDB zu verwenden, konfigurieren Sie den sicheren Zugriff, indem Sie einen der folgenden Netzwerkzugriffstypen auswählen und konfigurieren:

• 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 die Oracle Database-API für MongoDB zu verwenden, muss das Netzwerk konfiguriert sein, und der Zugriffstyp muss entweder: Nur sicherer Zugriff 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 Detailseite von Autonomous Database die Registerkarte Toolkonfiguration aus.
2. Klicken Sie auf Toolkonfiguration bearbeiten.
3. Wählen Sie in der API-Zeile MongoDB in der Spalte Tool aktivieren die Option Aktiviert aus.
4. Klicken Sie auf Apply.

1. Wählen Sie auf der Detailseite von Autonomous Database die Registerkarte Toolkonfiguration 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 URI-Prozentcodierung, 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 und Ihr Kennwort @least1/2#? lautet, könnte die MongoDB-Verbindungszeichenfolge zum Server <server> wie folgt aussehen:

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

   Je nach den Tools oder Treibern, die Sie verwenden, können Sie einen Benutzernamen und ein Kennwort als separate Parameter statt als Teil einer URI-Verbindungszeichenfolge angeben. In diesem Fall müssen Sie wahrscheinlich keine darin enthaltenen reservierten Zeichen codieren.

   Siehe auch:

   • Prozentcodierung - reservierte Zeichen

   • Uniform Resource Identifier (URI): Allgemeine Syntax

2. Eine Collection erstellen und Dokumente in die Collection einfügen

   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 wie Database Actions ab.

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

1. Laden Sie Node.js herunter. Wenn Sie Node.js bereits für Ihre Umgebung 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 bereits für Ihre Umgebung 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 bereits für Ihre Umgebung 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 mongodb- 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 URI-Prozentcodierung, 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 und Ihr Kennwort @least1/2#? lautet, könnte die MongoDB-Verbindungszeichenfolge zum Server <server> wie folgt aussehen:

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

      Je nach den Tools oder Treibern, die Sie verwenden, können Sie einen Benutzernamen und ein Kennwort als separate Parameter statt als Teil einer URI-Verbindungszeichenfolge angeben. In diesem Fall müssen Sie wahrscheinlich keine darin enthaltenen reservierten Zeichen codieren.

      Siehe auch:

      • Prozentcodierung - reservierte Zeichen

      • Uniform Resource Identifier (URI): Allgemeine Syntax

   4. Beispiel ausführen. Die Ausgabe sollte wie folgt aussehen:

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