Usando a API do Oracle Database para MongoDB

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

Configurar um Novo Autonomous AI Database para MongoDB

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

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

Neste ponto, para usar a Oracle Database API for 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 AI Database com um ponto final privado.

Configurar um Autonomous AI Database Existente para MongoDB

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

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

Observação

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

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

1. Na página de detalhes do Autonomous AI Database, selecione a guia Configuração da ferramenta.
2. Clique em Editar configuração da 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 AI 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 AI Database do Database Actions
  

1. Faça log-in como o usuário de teste. Consulte Criar um Usuário do Autonomous Database de Teste 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 de porcentagem de URI para substituir quaisquer caracteres reservados em seu URI de string de conexão — em particular, caracteres em seu nome de usuário e senha. Estes são os caracteres reservados e sua porcentagem de codificação:

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

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

   Por exemplo, se o seu nome de usuário for RUTH e a sua senha for @least1/2#?, a 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 drivers usados, você poderá fornecer um nome de usuário e uma senha como parâmetros separados, em vez de como parte de uma string de conexão URI. Nesse caso, você provavelmente não precisará codificar nenhum caractere reservado que ele contenha.

   Consulte também:

   • Codificação Percentual - Caracteres Reservados

   • Uniform Resource Identifier (URI): Sintaxe Genérica

2. Crie uma coleção e insira documentos em sua coleção.

   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 coleta 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 baixado ou instalado o Node.js para o 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 baixado ou instalado o Node.js para o seu ambiente, poderá ignorar esta etapa.

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

3. Configure a variável do ambiente PATH. Se você já tiver baixado ou instalado o Node.js para o 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 do 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 de porcentagem de URI para substituir quaisquer caracteres reservados em seu URI de string de conexão — em particular, caracteres em seu nome de usuário e senha. Estes são os caracteres reservados e sua porcentagem de codificação:

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

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

      Por exemplo, se o seu nome de usuário for RUTH e a sua senha for @least1/2#?, a 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 drivers usados, você poderá fornecer um nome de usuário e uma senha como parâmetros separados, em vez de como parte de uma string de conexão URI. Nesse caso, você provavelmente não precisará codificar nenhum caractere reservado que ele contenha.

      Consulte também:

      • Codificação Percentual - Caracteres Reservados

      • Uniform Resource Identifier (URI): Sintaxe Genérica

   4. Execute o exemplo. A saída deve ser semelhante a esta:

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