View a markdown version of this page

Menggunakan Node.js untuk terhubung ke instans DB Neptunus - Amazon Neptune
Autentikasi IAM

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

Menggunakan Node.js untuk terhubung ke instans DB Neptunus

penting

Memilih versi driver Apache TinkerPop Gremlin yang benar sangat penting untuk kompatibilitas dengan versi mesin Neptunus Anda. Menggunakan versi yang tidak kompatibel dapat mengakibatkan kegagalan koneksi atau perilaku yang tidak terduga. Untuk informasi kompatibilitas versi terperinci, lihatMengakses grafik Neptune dengan Gremlin.

Bagian berikut memandu Anda melalui menjalankan Node.js sampel yang terhubung ke instans Amazon Neptunus DB dan melakukan traversal Gremlin.

Anda harus mengikuti petunjuk ini dari instans Amazon EC2 di virtual private cloud (VPC) yang sama seperti instans DB Neptune Anda.

Sebelum memulai, lakukan hal berikut:

  • Verifikasi bahwa Node.js versi 8.11 atau lebih tinggi diinstal. Jika tidak, unduh dan instal Node.js dari situs Nodejs.org web.

Untuk terhubung ke Neptunus menggunakan Node.js

  1. Masukkan hal berikut untuk menginstal paket gremlin-javascript:

    npm install gremlin

  2. Buat file bernama gremlinexample.js, lalu buka file tersebut dalam editor teks.

  3. Salin hal berikut ke dalam file gremlinexample.js. 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..

    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. Masukkan perintah berikut untuk menjalankan sampel:

    node gremlinexample.js

Contoh sebelumnya mengembalikan jumlah vertex tunggal dalam grafik menggunakan traversal g.V().limit(1).count().next(). Untuk mengajukan kueri untuk sesuatu yang lain, ganti dengan traversal Gremlin lain dengan salah satu metode ending yang tepat.

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.

Berikut ini adalah contoh metode yang mengirimkan kueri ke instance DB Neptunus:

  • toList()

  • toSet()

  • next()

  • iterate()

Langkah-langkah terminal ini berperilaku berbeda dalam mode skrip dan mode bytecode. Untuk daftar kanonik langkah-langkah terminal dan detail tentang bagaimana pengaruhnya terhadap transaksi, lihat. Uji kode Gremlin dalam konteks Anda akan menyebarkannya

Gunakan iterate() saat Anda tidak membutuhkan hasil kueri Anda (misalnya mutasi) karena menghemat biaya serialisasi.

penting

Ini adalah Node.js contoh mandiri. Jika Anda berencana untuk menjalankan kode seperti ini dalam suatu AWS Lambda fungsi, lihat Contoh fungsi Lambda detail tentang penggunaan JavaScript secara efisien dalam fungsi Lambda Neptunus.

Autentikasi IAM

Neptunus mendukung otentikasi IAM untuk mengontrol akses ke cluster DB Anda. Jika autentikasi IAM diaktifkan, Anda harus menggunakan penandatanganan Signature Version 4 untuk mengautentikasi permintaan Anda. Untuk instruksi terperinci dan contoh kode untuk menghubungkan dari JavaScript klien, lihatMenghubungkan ke database Amazon Neptunus menggunakan otentikasi IAM dengan Gremlin JavaScript.