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 Neptunus

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

Menggunakan AWS CLI

aws neptunedataPerintah memungkinkan Anda menjalankan kueri Gremlin dan OpenCypher, memeriksa status mesin, mengelola beban massal, dan banyak lagi. Untuk referensi perintah lengkap, lihat neptunedatadi AWS CLI Command Reference.

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 Command Reference. 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 Command Reference. AWS CLI

Menggunakan AWS SDK

Anda dapat menggunakan Neptunus Data API melalui SDK untuk menjalankan kueri AWS 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 baris perintah curl mengirimkan permintaan HTTP langsung ke titik akhir Neptunus. Jika autentikasi IAM diaktifkan, gunakan awscurl atau curl 7.75.0+ dengan opsi untuk menandatangani permintaan. --aws-sigv4 Untuk informasi selengkapnya, lihat Menggunakan awscurl dengan kredensyal 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 ke dalam 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 lebih lanjut tentang alat ini, lihat halaman manual curl, dan buku Everything 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 jika autentikasi 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 jika autentikasi IAM tidak diaktifkan di cluster Anda.

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