使用 HTTP REST 端點連線至 Neptune 資料庫執行個體

Amazon Neptune 會提供 HTTP 端點進行 Gremlin 查詢。REST 介面與您的資料庫叢集正在使用的任何 Gremlin 版本相容 (請參閱您正在使用之 Neptune 引擎版本的引擎版本頁面，以確定其支援哪個 Gemlin 版本)。

注意

如 使用 SSL/HTTPS 加密 Amazon Neptune 資料庫的連線 中所討論，Neptune 現在要求您使用 HTTPS 而不是 HTTP 進行連線。

以下說明引導您使用 curl 命令和 HTTPS 連接到 Gremlin 端點。您必須從與您的 Neptune 資料庫執行個體位於同一虛擬私有雲端 (VPC) 的 Amazon EC2 執行個體依照以下指示進行。

對 Neptune 資料庫執行個體進行 Gremlin 查詢時所用的 HTTPS 端點為 https://your-neptune-endpoint:port/gremlin。

注意

如需尋找 Neptune 資料庫執行個體主機名稱的相關資訊，請參閱 連線至 Amazon Neptune 端點。

使用 HTTP REST 端點連線至 Neptune

以下範例使用 curl 透過 HTTP POST 提交 Gremlin 查詢。查詢是以 POST 本文中的 JSON 格式做為 gremlin 屬性提交。

curl -X POST -d '{"gremlin":"g.V().limit(1)"}' https://your-neptune-endpoint:port/gremlin

此範例會使用 g.V().limit(1) 周遊傳回圖形中的第一個頂點。您可以查詢其他項目，方法是將其取代為另一個 Gremlin 周遊。

重要

根據預設，REST 端點會以單一 JSON 結果集傳回所有結果。如果此結果集太大，Neptune 資料庫執行個體上可能會發生 OutOfMemoryError 例外狀況。

您可以啟用區塊回應 (以一系列個別回應傳回的結果) 來避免這種情況。請參閱 使用選用的 HTTP 結尾標頭來啟用多部分 Gremlin 回應。

雖然建議使用 HTTP POST 請求來傳送 Gremlin 查詢，但也可以使用 HTTP GET 請求：

curl -G "https://your-neptune-endpoint:port?gremlin=g.V().count()"

注意

Neptune 不支援 bindings 屬性。