Menggunakan titik akhir HTTPS REST untuk menyambung ke instans DB Neptune

Amazon Neptune menyediakan titik akhir HTTPS untuk kueri Gremlin. Antarmuka REST kompatibel dengan apa pun versi Gremlin yang digunakan klaster DB Anda (lihat halaman rilis mesin dari versi mesin Neptune yang Anda jalankan untuk menentukan rilis Gremlin yang didukungnya).

catatan

Sebagaimana dibahas dalam Enkripsi dalam Transit: Menghubungkan ke Neptune Menggunakan SSL/HTTPS, Neptune sekarang mengharuskan Anda terhubung menggunakan HTTPS dan bukan HTTP.

Petunjuk berikut memandu Anda menyambung ke titik akhir Gremlin menggunakan perintah curl dan HTTPS. Anda harus mengikuti petunjuk ini dari instans Amazon EC2 di virtual private cloud (VPC) yang sama seperti instans DB Neptune Anda.

Titik akhir HTTPS untuk kueri Gremlin ke instans DB Neptune adalah https://your-neptune-endpoint:port/gremlin.

catatan

Untuk informasi tentang menemukan nama host instans DB Neptune Anda, lihat Menghubungkan ke Titik Akhir Amazon Neptune..

Untuk menyambung ke Neptune menggunakan titik akhir HTTP REST

Contoh berikut menggunakan curl untuk mengirimkan kueri Gremlin melalui POST HTTP. Kueri dikirimkan dalam format JSON dalam tubuh posting sebagai properti gremlin.

curl -X POST -d '{"gremlin":"g.V().limit(1)"}' https://your-neptune-endpoint:port/gremlin

Contoh ini mengembalikan vertex pertama dalam grafik menggunakan traversal g.V().limit(1). Anda dapat mengajukan kueri untuk sesuatu yang lain dengan menggantinya dengan traversal Gremlin lain.

penting

Secara default, titik akhir REST mengembalikan semua hasil dalam satu set hasil JSON. Jika set hasil ini terlalu besar, pengecualian OutOfMemoryError dapat terjadi pada instans DB Neptune.

Anda dapat menghindari hal ini dengan mengaktifkan respons bongkahan (hasil dikembalikan dalam serangkaian respons terpisah). Lihat Gunakan header jejak HTTP opsional untuk mengaktifkan respons multi-bagian Gremlin.

Meskipun permintaan POST HTTP direkomendasikan untuk mengirim kueri Gremlin, tetapi memungkinkan juga untuk menggunakan permintaan GET HTTP:

curl -G "https://your-neptune-endpoint:port?gremlin=g.V().count()"

catatan

Neptune tidak mendukung properti bindings.