

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
<a name="get-started-cli-tools"></a>

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
<a name="get-started-cli-tools-cli"></a>

`aws neptunedata`Perintah memungkinkan Anda menjalankan kueri Gremlin dan OpenCypher, memeriksa status mesin, mengelola beban massal, dan banyak lagi. Untuk referensi perintah lengkap, lihat [https://docs.aws.amazon.com/cli/latest/reference/neptunedata/](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/)di 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](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/execute-gremlin-query.html). 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](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/execute-open-cypher-query.html) di Command Reference. AWS CLI 

------

## Menggunakan AWS SDK
<a name="get-started-cli-tools-sdk"></a>

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, lihat[AWS SDK](access-graph-gremlin-sdk.md).

------
#### [ 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, lihat[AWS SDK](access-graph-opencypher-sdk.md).

------

## `Menggunakan curl dan awscurl`
<a name="get-started-cli-tools-curl"></a>

Alat baris perintah [curl](https://curl.haxx.se/) mengirimkan permintaan HTTP langsung ke titik akhir Neptunus. Jika autentikasi IAM diaktifkan, gunakan [awscurl](https://github.com/okigan/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](iam-auth-connect-command-line.md#iam-auth-connect-awscurl).

### Menyiapkan `curl` untuk HTTPS
<a name="get-started-cli-tools-curl-setup"></a>

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](https://curl.haxx.se/docs/sslcerts.html) 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](https://curl.haxx.se/docs/sslcerts.html).

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,](https://curl.haxx.se/docs/manpage.html) dan buku *[Everything curl](https://ec.haxx.se/)*.

### Contoh kueri
<a name="get-started-cli-tools-curl-examples"></a>

Contoh berikut menunjukkan cara menjalankan kueri dasar menggunakan `curl` dan`awscurl`:

------
#### [ 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](access-graph-gremlin-rest.md) Untuk contoh HTTP OpenCypher lainnya, lihat. [Titik akhir HTTPS](access-graph-opencypher-queries.md)