View a markdown version of this page

Menggunakan titik akhir HTTPS REST untuk menyambung ke instans DB Neptune - Amazon Neptune
Contoh Koneksi

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

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 Mengenkripsi koneksi ke database Amazon Neptunus Anda dengan SSL/HTTPS, Neptune sekarang mengharuskan Anda terhubung menggunakan HTTPS dan bukan HTTP. Selain itu, Neptunus saat ini tidak mendukung HTTP/2 untuk permintaan REST API. Klien harus menggunakan HTTP/1.1 saat menghubungkan ke titik akhir.

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 menunjukkan cara mengirimkan query Gremlin ke endpoint REST. Anda dapat menggunakan AWS SDK, yang AWS CLI, ataucurl.

AWS CLI
aws neptunedata execute-gremlin-query \
  --endpoint-url https://your-neptune-endpoint:port \
  --gremlin-query "g.V().limit(1)"

Untuk informasi selengkapnya, lihat execute-gremlin-querydi Referensi AWS CLI Perintah.

SDK
import boto3
import json
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://your-neptune-endpoint:port',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.execute_gremlin_query(
    gremlinQuery='g.V().limit(1)',
    serializer='application/vnd.gremlin-v3.0+json;types=false'
)

print(json.dumps(response['result'], indent=2))

Untuk contoh AWS SDK dalam bahasa lain seperti Java, .NET, dan lainnya, lihatAWS SDK.

awscurl
awscurl https://your-neptune-endpoint:port/gremlin \
  --region us-east-1 \
  --service neptune-db \
  -X POST \
  -d '{"gremlin":"g.V().limit(1)"}'
catatan

Contoh ini mengasumsikan bahwa AWS kredenal Anda dikonfigurasi di lingkungan Anda. Ganti us-east-1 dengan Wilayah cluster Neptunus Anda.

Untuk informasi selengkapnya tentang menggunakan awscurl autentikasi IAM, lihat. Menggunakan awscurl dengan kredensyal sementara untuk terhubung dengan aman ke cluster DB dengan otentikasi IAM diaktifkan

curl

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

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()"

Contoh-contoh ini mengembalikan simpul pertama dalam grafik dengan menggunakan g.V().limit(1) traversal. 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.

catatan

Neptune tidak mendukung properti bindings.