Gunakan .NET untuk terhubung ke instans DB Neptune - Amazon Neptune

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Gunakan .NET untuk terhubung ke instans DB Neptune

Jika Anda bisa, selalu gunakan versi terbaru dari klien Apache TinkerPop .NET Gremlin, Gremlin.Net, yang didukung versi mesin Anda. Versi yang lebih baru berisi banyak perbaikan bug yang meningkatkan stabilitas, kinerja, dan kegunaan klien. Gremlin.NetVersi yang digunakan biasanya akan sejajar dengan TinkerPop versi yang dijelaskan dalam tabel untuk klien Java Gremlin.

Bagian berikut berisi contoh kode yang ditulis dalam C# yang menyambung ke instans DB Neptune dan melakukan traversal Gremlin.

Koneksi ke Amazon Neptunus harus dari instans EC2 Amazon di cloud pribadi virtual (VPC) yang sama dengan instans DB Neptunus Anda. Kode contoh ini diuji pada EC2 instance Amazon yang menjalankan Ubuntu.

Sebelum memulai, lakukan hal berikut:

  • Instal .NET di EC2 instans Amazon. Untuk mendapatkan petunjuk cara menginstal .NET di beberapa sistem operasi, termasuk Windows, Linux, dan macOS, lihat Memulai dengan .NET.

  • Instal Gremlin.NET dengan menjalankan dotnet add package gremlin.net untuk paket Anda. Untuk informasi selengkapnya, lihat Gremlin.net di dokumentasi. TinkerPop

Untuk menyambung ke Neptune menggunakan Gremlin.NET

  1. Buat proyek .NET baru.

    dotnet new console -o gremlinExample

  2. Ubah direktori ke direktori proyek baru.

    cd gremlinExample

  3. Salin hal berikut ke dalam file Program.cs. Ganti your-neptune-endpoint dengan alamat instans DB Neptunus Anda.

    Untuk informasi tentang menemukan alamat instans DB Neptune Anda, lihat bagian Menghubungkan ke Titik Akhir 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. Masukkan perintah berikut untuk menjalankan sampel:

    dotnet run

    Kueri Gremlin pada akhir contoh ini mengembalikan jumlah vertex tunggal untuk tujuan pengujian. Ini kemudian dicetak ke konsol.

    catatan

    Bagian akhir dari kueri Gremlin, Next(), diperlukan untuk mengirimkan traversal ke server untuk evaluasi. Jika Anda tidak menyertakan metode tersebut atau metode setara lain, kueri tidak diserahkan ke instans DB Neptune.

    Metode berikut mengirimkan kueri ke instans DB Neptune:

    • ToList()

    • ToSet()

    • Next()

    • NextTraverser()

    • Iterate()

    Gunakan Next() jika Anda membutuhkan hasil kueri agar diserialkan dan dikembalikan, atau Iterate() jika tidak.

    Contoh sebelumnya mengembalikan daftar dengan menggunakan traversal. g.V().Limit(3).ToList() Untuk mengajukan kueri untuk sesuatu yang lain, ganti dengan traversal Gremlin lain dengan salah satu metode ending yang tepat.