View a markdown version of this page

Menggunakan Node.js untuk menyambung ke instance Neptune DB - 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 menyambung ke instance Neptune DB

penting

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

Bagian berikut memandu Anda melalui menjalankan Node.js sampel yang terhubung ke instance Amazon Neptune 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 instance Neptune DB 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 Neptune DB:

  • 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 mereka mempengaruhi transaksi, lihatUji kode Gremlin dalam konteks Anda akan menyebarkannya.

Gunakan iterate() saat Anda tidak memerlukan 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 menggunakan JavaScript secara efisien dalam fungsi Neptunus Lambda.

Autentikasi IAM

Neptune mendukung otentikasi IAM untuk mengontrol akses ke cluster DB Anda. Jika Anda mengaktifkan otentikasi IAM, Anda perlu menggunakan penandatanganan Signature Version 4 untuk mengotentikasi permintaan Anda. Untuk petunjuk terperinci dan contoh kode untuk menghubungkan dari JavaScript klien, lihatMenghubungkan ke database Amazon Neptune menggunakan otentikasi IAM dengan Gremlin JavaScript.