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

# 使用 .NET 连接到 Neptune 数据库实例
<a name="access-graph-gremlin-dotnet"></a>

**重要**  
选择正确的 Apache TinkerPop Gremlin 驱动程序版本对于与你的 Neptune 引擎版本兼容至关重要。使用不兼容的版本可能会导致连接失败或意外行为。有关版本兼容性的详细信息，请参阅[使用 Gremlin 访问 Neptune 图形](access-graph-gremlin.md)。

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

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

开始之前，请执行以下操作：
+ 在 Amazon EC2 实例上安装 .NET。要获取有关在多个操作系统 (包括 Windows、Linux 和 macOS) 上安装 .NET 的说明，请参阅 [.NET 入门](https://www.microsoft.com/net/learn/get-started/)。
+ 通过为您的程序包运行 `dotnet add package gremlin.net` 来安装 Gremlin.NET。有关更多信息，请参阅文档中的 [Gremlin.net](https://tinkerpop.apache.org/docs/current/reference/#gremlin-DotNet)。 TinkerPop 



**使用 Gremlin.NET 连接到 Neptune**

1. 创建新的 .NET 项目。

   ```
   dotnet new console -o gremlinExample
   ```

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

   ```
   cd gremlinExample
   ```

1. 将以下内容复制到 `Program.cs` 文件中。*your-neptune-endpoint*替换为您的 Neptune 数据库实例的地址。

   有关查找 Neptune 数据库实例的地址的信息，请参阅[连接到 Amazon Neptune 端点](feature-overview-endpoints.md)部分。

   ```
   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);
         }
       }
     }
   }
   ```

1. 输入以下命令以运行示例：

   ```
   dotnet run
   ```

   此示例结尾处的 Gremlin 查询将返回用于测试目的的单个顶点的计数。然后，它将输出到控制台。
**注意**  
要将遍历提交到服务器进行评估，需要 Gremlin 查询的最后一部分 `Next()`。如果您未包含该方法或其它等效方法，该查询将不会提交到 Neptune 数据库实例。

   以下方法将查询提交到 Neptune 数据库实例：
   + `ToList()`
   + `ToSet()`
   + `Next()`
   + `NextTraverser()`
   + `Iterate()`

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

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

## IAM 身份验证
<a name="access-graph-gremlin-dotnet-iam"></a>

Neptune 支持 [IAM 身份验证](iam-auth-enable.md)来控制对数据库集群的访问。如果您启用了 IAM 身份验证，则需要使用签名版本 4 签名来验证您的请求。有关从.NET 客户端进行连接的详细说明和代码示例，请参阅[通过 Gremlin .NET 使用 IAM 身份验证连接到 Amazon Neptune 数据库](gremlin-dotnet-iam-auth.md)。