Utilisation de Node.js pour se connecter à une instance de base de données Neptune - Amazon Neptune

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation de Node.js pour se connecter à une instance de base de données Neptune

Dans la mesure du possible, utilisez toujours la dernière version du client Apache TinkerPop JavaScript Gremlin, gremlin, prise en charge par la version de votre moteur. Les versions plus récentes contiennent de nombreux correctifs de bogues qui améliorent la stabilité, les performances et l'ergonomie du client. La version de gremlin à utiliser s'aligne généralement sur les TinkerPop versions décrites dans le tableau du client Java Gremlin.

La section suivante vous accompagne dans l'exécution d'un exemple Node.js qui se connecte à une instance de base de données Amazon Neptune et effectue une traversée Gremlin.

Vous devez suivre ces instructions depuis une EC2 instance Amazon située dans le même cloud privé virtuel (VPC) que votre instance de base de données Neptune.

Avant de commencer, vous devez exécuter les actions suivantes :

  • Vérifiez que la version 8.11 ou ultérieure de Node.js est installée. Dans le cas contraire, téléchargez et installez Node.js à partir du site web Nodejs.org.

Pour se connecter à Neptune à l'aide de Node.js

  1. Entrez ce qui suit pour installer le package gremlin-javascript :

    npm install gremlin

  2. Créez un fichier nommé gremlinexample.js et ouvrez-le dans un éditeur de texte.

  3. Copiez ce qui suit dans le fichier gremlinexample.js. Remplacez your-neptune-endpoint avec l'adresse de votre instance de base de données Neptune.

    Consultez la section Connexion aux points de terminaison Amazon Neptune pour découvrir comment trouver l'adresse de votre instance de base de données 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. Pour exécuter l'exemple, entrez la commande suivante :

    node gremlinexample.js

L'exemple précédent renvoie le nombre d'un seul sommet dans le graphique en utilisant la traversée g.V().limit(1).count().next(). Pour interroger quelque chose d'autre, remplacez la traversée par une autre traversée Gremlin avec l'une des méthodes de fin appropriées.

Note

La partie finale de la requête Gremlin, next(), est obligatoire pour soumettre la traversée au serveur à des fins d'évaluation. Si vous n'incluez pas cette méthode ou une autre méthode équivalente, la requête ne sera pas soumise à l'instance de base de données Neptune.

Les méthodes suivantes soumettent la requête à l'instance de base de données Neptune :

  • toList()

  • toSet()

  • next()

  • nextTraverser()

  • iterate()

Utilisez next() si vous avez besoin que les résultats de la requête soient sérialisés et renvoyés, ou iterate() dans le cas contraire.

Important

Il s'agit d'un exemple Node.js autonome. Si vous envisagez d'exécuter un code de ce type dans une AWS Lambda fonction, consultez Exemples de fonctions Lambda pour plus de détails sur l'utilisation JavaScript efficace dans une fonction Neptune Lambda.