使用。 NET连接到 Neptune 数据库实例 - Amazon Neptune

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用。 NET连接到 Neptune 数据库实例

如果可以，请始终使用最新版本的 Apache TinkerPop 。 NET你的引擎版本支持的 Gremlin 客户端 Gremlin.Net。更新的版本包含大量错误修复，可以提升客户端的稳定性、性能和可用性。要使用的Gremlin.Net版本通常与 Java Gremlin 客户端表中描述的 TinkerPop版本保持一致。

以下部分包含采用 C# 编写的代码示例，该示例连接到 Neptune 数据库实例并执行 Gremlin 遍历。

与 Amazon Neptune 的连接必须来自与您的 Neptune EC2 数据库实例位于同一个虚拟私有云 (VPC) 中的亚马逊实例。此示例代码已在运行 Ubuntu 的 Amazon EC2 实例上进行了测试。

开始之前，请执行以下操作：

  • 安装。 NET在 Amazon EC2 实例上。获取安装说明。 NET在包括 Windows、Linux 和 macOS 在内的多个操作系统上，请参阅入门。 NET。

  • 安装 Gremlin。 NET通过运行dotnet add package gremlin.net获取您的包裹。有关更多信息，请参阅 Gremlin。 NET在 TinkerPop 文档中。

使用 Gremlin 连接到 Neptune。 NET

  1. 创建一个新的。 NET项目。

    dotnet new console -o gremlinExample

  2. 将目录更改为新项目目录。

    cd gremlinExample

  3. 将以下内容复制到 Program.cs 文件中。Replace（替换） your-neptune-endpoint 以及您的 Neptune 数据库实例的地址。

    有关查找 Neptune 数据库实例的地址的信息，请参阅连接到 Amazon Neptune 端点部分。

    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. 输入以下命令以运行示例：

    dotnet run

    此示例结尾处的 Gremlin 查询将返回用于测试目的的单个顶点的计数。然后，它将输出到控制台。

    注意

    要将遍历提交到服务器进行评估，需要 Gremlin 查询的最后一部分 Next()。如果您未包含该方法或其它等效方法，该查询将不会提交到 Neptune 数据库实例。

    以下方法将查询提交到 Neptune 数据库实例：

    • ToList()

    • ToSet()

    • Next()

    • NextTraverser()

    • Iterate()

    如果您需要序列化并返回查询结果，请使用 Next()，否则请使用 Iterate()。

    上述示例通过使用 g.V().Limit(3).ToList() 遍历返回一个列表。要查询其他内容，请将其替换为具有其中一种适当的结尾方法的其他 Gremlin 遍历。