

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Verwenden von Befehlszeilentools für den Zugriff auf Amazon Neptune
<a name="get-started-cli-tools"></a>

Sie können die AWS CLI AWS SDKs und HTTP-Tools wie `curl` und verwenden, `awscurl` um Anfragen an Ihren Neptune-DB-Cluster zu senden. In den folgenden Abschnitten wird gezeigt, wie Sie die einzelnen Tools einrichten und grundlegende Gremlin- und OpenCypher-Abfragen ausführen.

## Verwendung der AWS CLI
<a name="get-started-cli-tools-cli"></a>

Mit den `aws neptunedata` Befehlen können Sie Gremlin- und OpenCypher-Abfragen ausführen, den Engine-Status überprüfen, Massenladungen verwalten und vieles mehr. Die vollständige Befehlsreferenz finden [https://docs.aws.amazon.com/cli/latest/reference/neptunedata/](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/)Sie in der Befehlsreferenz. AWS CLI 

Die folgenden Beispiele zeigen, wie eine einfache Abfrage ausgeführt wird:

------
#### [ Gremlin ]

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

Weitere Informationen finden Sie unter [execute-gremlin-query](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/execute-gremlin-query.html) in der Befehlsreferenz. 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"
```

[Weitere Informationen finden Sie unter execute-open-cypher-query in der Befehlsreferenz.](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/execute-open-cypher-query.html) AWS CLI 

------

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

Sie können die Neptune Data API über die AWS SDKs verwenden, um Abfragen programmgesteuert auszuführen. Die folgenden Python-Beispiele zeigen, wie eine einfache Abfrage ausgeführt wird:

------
#### [ 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))
```

 AWS SDK-Beispiele in anderen Sprachen finden Sie unter[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))
```

 AWS SDK-Beispiele in anderen Sprachen finden Sie unter[AWS SDK](access-graph-opencypher-sdk.md).

------

## `Verwenden von curl und awscurl`
<a name="get-started-cli-tools-curl"></a>

Das [curl-Befehlszeilentool](https://curl.haxx.se/) sendet HTTP-Anfragen direkt an die Neptune-Endpunkte. Wenn die IAM-Authentifizierung aktiviert ist, verwenden Sie [awscurl](https://github.com/okigan/awscurl) oder 7.75.0\+ mit der Option, Anfragen zu signieren. `curl` `--aws-sigv4` Weitere Informationen finden Sie unter [Verwenden von `awscurl` mit temporären Anmeldeinformationen, um eine sichere Verbindung zu einem DB-Cluster mit aktivierter IAM-Authentifizierung herzustellen](iam-auth-connect-command-line.md#iam-auth-connect-awscurl).

### `Curl für HTTPS einrichten`
<a name="get-started-cli-tools-curl-setup"></a>

Um eine Verbindung über HTTPS herzustellen (wie es Neptune in den meisten Regionen erfordert), `curl` ist Zugriff auf entsprechende Zertifikate erforderlich. Informationen zum Abrufen von Zertifikaten und deren Formatierung in einen Zertifizierungsstellenspeicher (CA) finden Sie in der `curl` Dokumentation unter [SSL-Zertifikatsverifizierung](https://curl.haxx.se/docs/sslcerts.html).

Sie können den Speicherort dieses CA-Zertifikatsspeichers mithilfe der `CURL_CA_BUNDLE` Umgebungsvariablen angeben. Unter Windows sucht `curl` automatisch in einer Datei mit dem Namen `curl-ca-bundle.crt` danach. Es sucht zunächst in demselben Verzeichnis wie `curl.exe` und anschließend an anderer Stelle im Pfad. Weitere Informationen finden Sie unter [SSL Certificate Verification](https://curl.haxx.se/docs/sslcerts.html).

Solange `curl` die entsprechenden Zertifikate finden kann, werden HTTPS-Verbindungen wie HTTP-Verbindungen behandelt, ohne dass zusätzliche Parameter angegeben werden müssen. Die Beispiele in dieser Dokumentation basieren auf diesem Szenario.

Weitere Informationen über das Tool finden Sie in der [curl-Manpage und im Buch *[Everything curl](https://ec.haxx.se/)*](https://curl.haxx.se/docs/manpage.html).

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

Die folgenden Beispiele zeigen, wie eine einfache Abfrage mit `curl` und ausgeführt wird: `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
```

**Anmerkung**  
Plain `curl` funktioniert nur, wenn die IAM-Authentifizierung auf Ihrem Cluster nicht aktiviert ist.

------
#### [ 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
```

**Anmerkung**  
Plain `curl` funktioniert nur, wenn die IAM-Authentifizierung auf Ihrem Cluster nicht aktiviert ist.

------

Weitere Gremlin-HTTP-Beispiele finden Sie unter. [HTTPS REST](access-graph-gremlin-rest.md) Weitere OpenCypher-HTTP-Beispiele finden Sie unter. [HTTPS-Endpunkt](access-graph-opencypher-queries.md)