View a markdown version of this page

使用命令行工具访问亚马逊 Neptune - Amazon Neptune
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

使用命令行工具访问亚马逊 Neptune

你可以使用 Amazon CLI, Amazon 软件开发工具包和 HTTP 工具,例如 curl 和 awscurl 向您的 Neptune 数据库集群提交查询。以下部分介绍如何设置每个工具和运行基本查询。你可以使用所有这些工具运行 Gremlin 和 OpenCypher 查询。您向 HTTP 提交 SPARQL 查询 /sparql 端点使用 curl 要么 awscurl。

使用 Amazon CLI

这个 aws neptunedata 命令允许你运行 Gremlin 和 OpenCypher 查询、检查引擎状态、管理批量加载等。有关完整的命令参考,请参见 neptunedata 在 Amazon CLI 命令参考。

以下示例显示如何运行基本查询:

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

欲了解更多信息,请参阅 执行gremlin查询 在 Amazon 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"

欲了解更多信息,请参阅 执行打开密码查询 在 Amazon CLI 命令参考。

注意

这个 aws neptunedata 命令不包含 SPARQL 查询操作。要运行 SPARQL 查询,请将其提交到 HTTP /sparql 端点使用 curl 要么 awscurl。有关更多信息,请参阅 使用 卷曲 和 awscurl。

使用 Amazon SDK

您可以通过以下方式使用海王星数据 API Amazon 用于以编程方式运行查询的 SDK。以下 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))

对于 Amazon 其他语言的 SDK 示例,请参阅 Amazon 软件开发套件。

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))

对于 Amazon 其他语言的 SDK 示例,请参阅 Amazon 软件开发套件。

注意

海王星数据 API 不包含 SPARQL 查询操作。要运行 SPARQL 查询,请将其提交到 HTTP /sparql 端点使用 curl 要么 awscurl。有关更多信息,请参阅 使用 卷曲 和 awscurl。

使用 卷曲 和 awscurl

这个 卷曲 命令行工具直接向海王星端点提交 HTTP 请求。如果启用了 IAM 身份验证,请使用 awscurl 要么 curl 7.75.0+ 使用 --aws-sigv4 签署请求的选项。有关更多信息,请参阅 使用 awscurl 使用临时证书安全地连接到启用了 IAM 身份验证的数据库集群。

正在设置 卷曲 用于HTTPS

要使用 HTTPS 进行连接(正如海王星在大多数地区所要求的那样), curl 需要访问相应的证书。有关如何获取证书并将其格式化为证书颁发机构 (CA) 存储的信息,请参阅 SSL 证书验证 在 curl 文档。

您可以使用指定此 CA 证书存储库的位置 CURL_CA_BUNDLE 环境变量。在 Windows 上,curl 自动在名为 curl-ca-bundle.crt 的文件中查找它。首先在与 curl.exe 相同的目录中查找,然后在路径的其他位置查找。有关更多信息,请参阅 SSL 证书验证。

只要 curl 可以找到相应的证书,它即可像处理 HTTP 连接一样处理 HTTPS 连接,而无需额外的参数。本文档中的示例基于该场景。

有关该工具的更多信息,请参阅 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
注意

平原 curl 仅在您的集群上未启用 IAM 身份验证时才有效。

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
注意

平原 curl 仅在您的集群上未启用 IAM 身份验证时才有效。

SPARQL (awscurl)
awscurl https://your-neptune-endpoint:port/sparql \ --region us-east-1 \ --service neptune-db \ -X POST \ -d "query=SELECT ?s ?p ?o WHERE { ?s ?p ?o } LIMIT 1"
SPARQL (curl)
curl -X POST \ -d "query=SELECT ?s ?p ?o WHERE { ?s ?p ?o } LIMIT 1" \ https://your-neptune-endpoint:port/sparql
注意

平原 curl 仅在您的集群上未启用 IAM 身份验证时才有效。

有关更多 Gremlin HTTP 示例,请参阅 HTTPS REST。有关更多 OpenCypher HTTP 示例,请参阅 HTTPS 端点。有关更多 SPARQL HTTP 示例,请参阅 SPARQL HTTP API。