Uso de Node.js para conectarse a una instancia de base de datos de Neptune - Amazon Neptune

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de Node.js para conectarse a una instancia de base de datos de Neptune

Si puede, utilice siempre la última versión del cliente Apache TinkerPop JavaScript Gremlin, compatible con la versión de su motor. Las versiones más recientes contienen numerosas correcciones de errores que mejoran la estabilidad, el rendimiento y la facilidad de uso del cliente. La versión gremlin que se utilizará normalmente coincidirá con las TinkerPop versiones descritas en la tabla del cliente Java Gremlin.

En la siguiente sección se indica cómo ejecutar una muestra de Node.js que se conecta a una instancia de base de datos de Amazon Neptune y realiza un recorrido de Gremlin.

Debe seguir estas instrucciones desde una EC2 instancia de Amazon en la misma nube privada virtual (VPC) que su instancia de base de datos de Neptune.

Antes de comenzar, haga lo siguiente:

  • Compruebe que esté instalado Node.js versión 8.11 o superior. Si no lo está, descargue e instale Node.js desde el sitio web de Nodejs.org.

Para conectarse a Neptune mediante Node.js
  1. Escriba lo siguiente para instalar el paquete gremlin-javascript:

    npm install gremlin
  2. Cree un archivo con el nombre gremlinexample.js y ábralo en un editor de texto.

  3. Copie lo siguiente en el archivo gremlinexample.js. Reemplazar your-neptune-endpoint con la dirección de su instancia de base de datos Neptune.

    Para obtener información acerca de cómo encontrar la dirección de la instancia de base de datos de Neptune, consulte la sección Conexión a los puntos de conexión de 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. Escriba el comando siguiente para ejecutar el ejemplo:

    node gremlinexample.js

El ejemplo anterior devuelve el recuento de un único vértice en el gráfico utilizando el recorrido g.V().limit(1).count().next(). Para otras consultas, sustitúyalo por otro recorrido de Gremlin con uno de los métodos de finalización adecuados.

nota

La parte final de la consulta de Gremlin, next(), es necesaria para enviar el recorrido al servidor para su evaluación. Si no incluye ese método u otro equivalente, la consulta no se envía a la instancia de base de datos de Neptune.

Los siguientes métodos envían la consulta a la instancia de base de datos de Neptune:

  • toList()

  • toSet()

  • next()

  • nextTraverser()

  • iterate()

Utilice next() si necesita que los resultados de la consulta se serialicen y devuelvan, o iterate() si no es así.

importante

Se trata de un ejemplo aislado de Node.js. Si planea ejecutar código como este en una AWS Lambda función, consulte Ejemplos de funciones de Lambda para obtener más información sobre el uso JavaScript eficiente de una función de Neptune Lambda.