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

Menggunakan alat baris perintah untuk mengakses Amazon Neptune

Anda dapat menggunakan AWS CLI, AWS SDK, dan alat HTTP seperti curl dan awscurl untuk mengirimkan kueri ke cluster Neptune DB Anda. Bagian berikut menunjukkan cara mengatur setiap alat dan menjalankan permintaan dasar Gremlin dan OpenCypher.

Menggunakan AWS CLI

Per aws neptunedata intah memungkinkan Anda menjalankan kueri Gremlin dan OpenCypher, memeriksa status mesin, mengelola beban massal, dan banyak lagi. Untuk referensi perintah lengkap, lihat neptunedata di Referensi AWS CLI Perintah.

Contoh berikut menunjukkan cara menjalankan kueri dasar:

Gremlin

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

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

openCypher

aws neptunedata execute-open-cypher-query \
  --endpoint-url https://your-neptune-endpoint:port \
  --region us-east-1 \
  --open-cypher-query "MATCH (n) RETURN n LIMIT 1"

Untuk informasi selengkapnya, lihat execute-open-cypher- query di Referensi Perintah. AWS CLI

Menggunakan AWS SDK

Anda dapat menggunakan Neptune Data API melalui AWS SDK untuk menjalankan kueri secara terprogram. Contoh Python berikut menunjukkan cara menjalankan kueri dasar:

Gremlin

import boto3
import json
from botocore.config import Config

# Disable the client-side read timeout and retries so that
# Neptune's server-side neptune_query_timeout controls query duration.
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, lihatAWS SDK.

openCypher

import boto3
import json
from botocore.config import Config

# Disable the client-side read timeout and retries so that
# Neptune's server-side neptune_query_timeout controls query duration.
client = boto3.client(
    'neptunedata',
    endpoint_url='https://your-neptune-endpoint:port',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.execute_open_cypher_query(
    openCypherQuery='MATCH (n) RETURN n LIMIT 1'
)

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

Untuk contoh AWS SDK dalam bahasa lain, lihatAWS SDK.

Menggunakan curl dan awscurl

Alat https://curl.haxx.se/ baris perintah curl mengirimkan permintaan HTTP langsung ke titik akhir Neptunus. Jika otentikasi IAM diaktifkan, gunakan awscurl atau curl 7.75.0+ dengan opsi untuk menandatangani permintaan. --aws-sigv4 Untuk informasi selengkapnya, lihat Menggunakan awscurl dengan kredenSIAL sementara untuk terhubung dengan aman ke cluster DB dengan otentikasi IAM diaktifkan.

Menyiapkan curl untuk HTTPS

Untuk terhubung menggunakan HTTPS (seperti yang dibutuhkan Neptunus di sebagian besar Wilayah), curl perlu akses ke sertifikat yang sesuai. Untuk informasi tentang cara mendapatkan sertifikat dan memformatnya menjadi penyimpanan otoritas sertifikat (CA), lihat Verifikasi Sertifikat SSL dalam curl dokumentasi.

Anda dapat menentukan lokasi penyimpanan sertifikat CA ini menggunakan variabel CURL_CA_BUNDLE lingkungan. Pada Windows, curl secara otomatis mencarinya dalam sebuah file bernama curl-ca-bundle.crt. Ia pertama mencari dalam direktori yang sama dengan curl.exe dan kemudian di tempat lain di jalurnya. Untuk informasi lebih lanjut, lihat Verifikasi Sertifikat SSL.

Selama curl dapat menemukan sertifikat yang sesuai, ia menangani koneksi HTTPS seperti koneksi HTTP, tanpa parameter tambahan. Contoh dalam dokumentasi ini didasarkan pada skenario tersebut.

Untuk informasi selengkapnya tentang alat ini, lihat halaman manual curl, dan buku Every thing curl .

Contoh kueri

Contoh berikut menunjukkan cara menjalankan kueri dasar menggunakan curl danawscurl:

Gremlin (awscurl)

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

Gremlin (curl)

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

catatan

Plain hanya curl berfungsi ketika otentikasi IAM tidak diaktifkan di cluster Anda.

openCypher (awscurl)

awscurl https://your-neptune-endpoint:port/openCypher \
  --region us-east-1 \
  --service neptune-db \
  -X POST \
  -d "query=MATCH (n) RETURN n LIMIT 1"

openCypher (curl)

curl -X POST \
  -d "query=MATCH (n) RETURN n LIMIT 1" \
  https://your-neptune-endpoint:port/openCypher

catatan

Plain hanya curl berfungsi ketika otentikasi IAM tidak diaktifkan di cluster Anda.

Untuk contoh Gremlin HTTP lainnya, lihat. HTTPS REST Untuk contoh OpenCypher HTTP selengkapnya, lihat. Titik akhir HTTPS