本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
您可以使用 AWS CLI、 AWS SDKs和 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)"
如需詳細資訊，請參閱《 AWS CLI 命令參考》中的 execute-gremlin-query。
- 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"
如需詳細資訊，請參閱《 AWS CLI 命令參考》中的 execute-open-cypher-query。
您可以透過 AWS SDKs 使用 Neptune 資料 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 開發套件。
- 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 開發套件。
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 Certificate Verification。
只要 curl 可以找到適當的憑證，它處理 HTTPS 連線的方式就跟 HTTP 連線一樣，無需額外參數。此文件的範例是以該案例為基礎。
如需工具的詳細資訊，請參閱 curl man 頁面和書籍 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 端點。
