本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
您可以使用 AWS CLI、 AWS 软件开发工具包和 HTTP 工具（例如curl和awscurl）向您的 Neptune 数据库集群提交查询。以下各节介绍如何设置每个工具以及如何运行基本的 Gremlin 和 OpenCypher 查询。
这些aws neptunedata命令允许你运行 Gremlin 和 OpenCypher 查询、检查引擎状态、管理批量加载等。有关完整的命令参考，请参阅《 AWS CLI 命令参考》neptunedata中的。
以下示例说明如何运行基本查询：
- Gremlin
-
aws neptunedata execute-gremlin-query \
--endpoint-url https://your-neptune-endpoint:port \
--region us-east-1 \
--gremlin-query "g.V().limit(1)"
有关更多信息，请参阅《命令参考》中的 execute-gremlin- query。 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"
有关更多信息，请参阅《命令参考》中的 execute-open-cypher-query。 AWS CLI
您可以通过软件开发工具包使用 Neptune AWS Data API 以编程方式运行查询。以下 Python 示例演示了如何运行基本查询：
- 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 示例，请参阅AWS 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))
有关其他语言 AWS 的 SDK 示例，请参阅AWS SDK。
curl 命令行工具将 HTTP 请求直接提交到 Neptune 端点。如果启用了 IAM 身份验证，请使用 awscurl 或 curl 7.75.0+ 以及签署请求的选项。--aws-sigv4有关更多信息，请参阅 使用带有临时证书的 awscurl 安全地连接到启用 IAM 身份验证的数据库集群。
要使用 HTTPS 进行连接（正如 Neptune 在大多数地区所要求的那样），curl需要访问相应的证书。有关如何获取证书并将其格式化为证书颁发机构 (CA) 存储的信息，请参阅curl文档中的 SSL 证书验证。
您可以使用CURL_CA_BUNDLE环境变量指定此 CA 证书存储的位置。在 Windows 上，curl 自动在名为 curl-ca-bundle.crt 的文件中查找它。首先在与 curl.exe 相同的目录中查找，然后在路径的其他位置查找。有关更多信息，请参阅 SSL 证书验证。
只要 curl 可以找到相应的证书，它即可像处理 HTTP 连接一样处理 HTTPS 连接，而无需额外的参数。本文档中的示例基于该场景。
有关该工具的更多信息，请参阅 curl 手册页和《Everything curl》一书。
以下示例说明如何使用curl和运行基本查询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
只有在您的集群上未启用 IAM 身份验证时，Plain 才起curl作用。
- 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
只有在您的集群上未启用 IAM 身份验证时，Plain 才起curl作用。
有关更多 Gremlin HTTP 示例，请参阅。HTTPS REST有关更多 OpenCypher HTTP 示例，请参阅。HTTPS 端点
