Utilisation de .NET 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 .NET pour se connecter à une instance de base de données Neptune

Si vous pouvez, utilisez toujours la dernière version d'Apache TinkerPop Un client .NET Gremlin,Gremlin.Net, que la version de votre moteur prend en charge. Les nouvelles versions contiennent de nombreuses corrections de bogues qui améliorent la stabilité, les performances et la convivialité du client. Dans laGremlin.Netla version à utiliser sera généralement alignée sur la TinkerPopversions décrites danstable pour le client Java Gremlin.

La section suivante contient un exemple de code écrit en C# qui se connecte à une instance de base de données Neptune et effectue une traversée Gremlin.

Les connexions à Amazon Neptune doivent provenir d'une instance Amazon EC2 dans le même Virtual Cloud (VPC) que votre instance de bases de données Neptune. Cet exemple de code a été testé sur une instance Amazon EC2 exécutant Ubuntu.

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

  • Installation de .NET sur l'instance Amazon EC2. Pour obtenir des instructions sur la façon d'installer .NET sur plusieurs systèmes d'exploitation, notamment Windows, Linux et macOS, consultez Mise en route avec .NET.

  • Installez Gremlin.NET en exécutant dotnet add package gremlin.net pour votre package. Pour plus d'informations, veuillez consulter la rubriqueGremlin.netdans le TinkerPop .

Pour vous connecter à Neptune à l'aide de Gremlin.net

  1. Crée un projet .NET.

    dotnet new console -o gremlinExample
  2. Modifiez les répertoires vers le nouveau répertoire de projet.

    cd gremlinExample
  3. Copiez ce qui suit dans le fichier Program.cs. Remplaceryour-neptune-endpointavec l'adresse de votre instance de base de données Neptune.

    Pour plus d'informations sur la recherche de l'adresse de votre instance de base de données Neptune, consultez leConnexion aux points de terminaison Amazon NeptuneSection Disses.

    using System; using System.Threading.Tasks; using System.Collections.Generic; using Gremlin.Net; using Gremlin.Net.Driver; using Gremlin.Net.Driver.Remote; using Gremlin.Net.Structure; using static Gremlin.Net.Process.Traversal.AnonymousTraversalSource; namespace gremlinExample { class Program { static void Main(string[] args) { try { var endpoint = "your-neptune-endpoint"; // This uses the default Neptune and Gremlin port, 8182 var gremlinServer = new GremlinServer(endpoint, 8182, enableSsl: true ); var gremlinClient = new GremlinClient(gremlinServer); var remoteConnection = new DriverRemoteConnection(gremlinClient, "g"); var g = Traversal().WithRemote(remoteConnection); g.AddV("Person").Property("Name", "Justin").Iterate(); g.AddV("Custom Label").Property("name", "Custom id vertex 1").Iterate(); g.AddV("Custom Label").Property("name", "Custom id vertex 2").Iterate(); var output = g.V().Limit<Vertex>(3).ToList(); foreach(var item in output) { Console.WriteLine(item); } } catch (Exception e) { Console.WriteLine("{0}", e); } } } }
  4. Pour exécuter l'exemple, entrez la commande suivante :

    dotnet run

    La requête Gremlin à la fin de cet exemple renvoie le nombre d'un seul vertex à des fins de test. Elle est ensuite imprimée sur la console.

    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 n'est 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()

    Utilisernext()si vous avez besoin que les résultats de la requête soient sérialisés et renvoyés, ouiterate()si tu ne le fais pas.

    L'exemple précédent renvoie une liste à l'aide deg.V().Limit(3).ToList()Traversal. 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.