Para usar a API MongoDB, você pode criar e configurar um novo Autonomous Database ou modificar a configuração de um Autonomous Database existente configurando ACLs ou definindo um ponto final privado.

Configurar um Novo Autonomous Database para MongoDB

Siga as etapas em Provisionar ou Clonar um Autonomous Database, até o ponto em que você seleciona o Tipo de Acesso à Rede.

Descrição da ilustração adb_network_access_acl_provision.png

Neste ponto, para usar a API do Oracle Database para MongoDB, configure o acesso seguro selecionando e configurando um destes tipos de acesso à rede:

• Acesso seguro somente de IPS e VCNs permitidos

• Acesso somente de ponto final privado

  Consulte Configurar o Acesso à Rede com Pontos Finais Privados para obter informações sobre como configurar uma instância do Autonomous Database com um ponto final privado.

Configurar um Autonomous Database for MongoDB Existente

Abra a Console do Oracle Cloud Infrastructure para sua instância do Autonomous Database.

Descrição da ilustração adb_ajd_console_details.png

Observação

Para usar a API do Oracle Database para MongoDB, a Rede deve ser configurada e o Tipo de acesso deve ser: Acesso seguro somente de IPs e VCNs permitidos ou Somente acesso de ponto final privado.

Depois de configurar o acesso à rede para a instância do Autonomous Database, ative a API MongDB.

1. Na página de detalhes do Autonomous Database, selecione a guia Configuração da ferramenta.
2. Clique em Editar configuração de ferramenta.
3. Na linha da API MongoDB, selecione na coluna Ativar ferramenta para mostrar Ativado.
4. Clique em Aplicar.

1. Na página de detalhes do Autonomous Database, selecione a guia Configuração da ferramenta.
2. Na linha da API MongoDB, em URL de Acesso, clique em Copiar.

Descrição da ilustração adb_tools_mongo_connect_string.png

• Recuperar a String de Conexão do Autonomous Database do Database Actions
  

1. Faça log-in como usuário de teste. Consulte Criar um Usuário de Teste do Autonomous Database para MongoDB para obter mais informações.

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

   Observação
   
   

   Use a codificação percentual de URI para substituir quaisquer caracteres reservados no URI da string de conexão - particularmente, no seu nome de usuário e senha. Estes são os caracteres reservados e suas codificações percentuais:

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

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

   Por exemplo, se seu nome de usuário for RUTH e sua senha for @least1/2#?, sua string de conexão MongoDB com o servidor <server> poderá ter esta aparência:

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

   Dependendo das ferramentas ou dos drivers usados, talvez você possa fornecer um nome de usuário e uma senha como parâmetros distintos, em vez de como parte de uma string de conexão do URI. Nesse caso, você provavelmente não precisará codificar os caracteres reservados que eles contêm.

   Consulte:

   • Codificação Percentual - Caracteres Reservados

   • URI (Uniform Resource Identifier): sintaxe genérica

2. Crie uma coleção e insira documentos nela.

   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. Consulte a coleção usando um cliente SQL, como o Database Actions.

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

   
   Descrição da ilustração database_actions_sql_for_mongodb_use.png

1. Faça download do Node.js. Se você já tiver feito download ou instalado Node.js para seu ambiente, poderá ignorar esta etapa.

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

2. Extraia o conteúdo do arquivo Node,js. Se você já tiver feito download ou instalado Node.js para seu ambiente, poderá ignorar esta etapa.

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

3. Configure a variável de ambiente PATH. Se você já tiver feito download ou instalado Node.js para seu ambiente, poderá ignorar esta etapa.

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

4. Teste sua conexão com um exemplo de Javascript.
   1. Criar um novo diretório.

      $ mkdir autonomous_mongodb
      $ cd autonomous_mongodb
      $ npm init –y

   2. Instale a dependência mongodb.

      $ npm install mongodb

   3. Crie um aplicativo JavaScript chamado 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);
      

      Observação
      
      

      Use a codificação percentual de URI para substituir quaisquer caracteres reservados no URI da string de conexão - particularmente, no seu nome de usuário e senha. Estes são os caracteres reservados e suas codificações percentuais:

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

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

      Por exemplo, se seu nome de usuário for RUTH e sua senha for @least1/2#?, sua string de conexão MongoDB com o servidor <server> poderá ter esta aparência:

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

      Dependendo das ferramentas ou dos drivers usados, talvez você possa fornecer um nome de usuário e uma senha como parâmetros distintos, em vez de como parte de uma string de conexão do URI. Nesse caso, você provavelmente não precisará codificar os caracteres reservados que eles contêm.

      Consulte:

      • Codificação Percentual - Caracteres Reservados

      • URI (Uniform Resource Identifier): sintaxe genérica

   4. Executar o exemplo. A saída deve ser semelhante à seguinte:

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