Usar o Node.js para conectar-se a uma instância de banco de dados do Neptune

Se você puder, sempre use a versão mais recente do cliente Apache TinkerPop JavaScript Gremlin, gremlin, compatível com a versão do seu mecanismo. As versões mais recentes contêm várias correções de erros que melhoram a estabilidade, o desempenho e a usabilidade do cliente. A versão gremlin a ser usada normalmente se alinha às TinkerPop versões descritas na tabela do cliente Java Gremlin.

A seção a seguir descreve a execução de um exemplo do Node.js que se conecta a uma instância de banco de dados do Amazon Neptune e executa um percurso do Gremlin.

Você deve seguir essas instruções de uma EC2 instância da Amazon na mesma nuvem privada virtual (VPC) da sua instância de banco de dados Neptune.

Antes de começar, faça o seguinte:

• Verifique se a versão Node.js 8.11 ou superior está instalada. Se não estiver, faça download e instale o Node.js no site Nodejs.org.

Como conectar-se ao Neptune usando o Node.js

1. Insira o seguinte para instalar o pacote gremlin-javascript:

   npm install gremlin

2. Crie um arquivo denominado gremlinexample.js e abra-o em um editor de texto.

3. Copie o seguinte no arquivo gremlinexample.js. Substituir your-neptune-endpoint com o endereço da sua instância de banco de dados Neptune.

   Para obter informações sobre como localizar o endereço da instância de banco de dados do Neptune, consulte a seção Conectar-se a endpoints do Amazon Neptune.

   const gremlin = require('gremlin');
   const DriverRemoteConnection = gremlin.driver.DriverRemoteConnection;
   const Graph = gremlin.structure.Graph;
   
   dc = new DriverRemoteConnection('wss://your-neptune-endpoint:8182/gremlin',{});
   
   const graph = new Graph();
   const g = graph.traversal().withRemote(dc);
   
   g.V().limit(1).count().next().
       then(data => {
           console.log(data);
           dc.close();
       }).catch(error => {
           console.log('ERROR', error);
           dc.close();
       });

4. Insira o seguinte comando para executar o exemplo:

   node gremlinexample.js

O exemplo anterior retorna a contagem de um único vértice no gráfico usando a travessia g.V().limit(1).count().next(). Para consultar outro elemento, substitua-a por outra travessia do Gremlin com um dos métodos de término adequado.

nota

A parte final da consulta do Gremlin, next(), é necessária para enviar a travessia ao servidor para avaliação. Se você não incluir esse método ou outro método equivalente, a consulta não será enviada à instância de banco de dados do Neptune.

Os seguintes métodos enviam a consulta à instância de banco de dados do Neptune:

• toList()

• toSet()

• next()

• nextTraverser()

• iterate()

Use next() se precisar que os resultados da consulta sejam serializados e gerados, ou iterate() se não precisar.

Importante

Este é um exemplo de Node.js independente. Se você planeja executar um código como esse em uma AWS Lambda função, consulte Exemplos de função do Lambda para obter detalhes sobre o uso JavaScript eficiente em uma função Lambda do Neptune.