HTTPS REST エンドポイントを使用して Neptune DB インスタンスに接続する

Amazon Neptune は、Gremlin クエリ用のHTTPSエンドポイントを提供します。REST インターフェイスは、DB クラスターが使用している Gremlin バージョンと互換性があります (実行中の Neptune エンジンバージョンのエンジンリリースページを参照して、サポートしている Gremlin リリースを確認してください）。

注記

で説明したようにSSL/ を使用した Amazon Neptune データベースへの接続の暗号化HTTPS、Neptune では HTTPSの代わりに を使用して接続する必要があるようになりましたHTTP。

次の手順では、 curl コマンド と を使用して Gremlin エンドポイントに接続する手順を説明しますHTTPS。Neptune DB EC2インスタンスと同じ仮想プライベートクラウド (VPC) の Amazon インスタンスから、これらの指示に従う必要があります。

Neptune DB インスタンスへの Gremlin クエリのHTTPSエンドポイントは ですhttps://your-neptune-endpoint:port/gremlin。

注記

Neptune DB インスタンスのホスト名を見つける方法については、Amazon Neptune エンドポイントに接続する を参照してください。

HTTP REST エンドポイントを使用して Neptune に接続するには

次の例では、 curlを使用して Gremlin クエリを HTTP 経由で送信しますPOST。クエリは、 gremlin プロパティとして投稿の本文にJSON形式で送信されます。

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

この例では、g.V().limit(1) トラバーサルを使用してグラフの最初の頂点を返します。その他の対象にクエリを実行するには、別の Gremlin トラバーサルで置き換えます。

重要

デフォルトでは、RESTエンドポイントはすべての結果を 1 つのJSON結果セットで返します。この結果セットが大きすぎる場合、Neptune DB インスタンスでOutOfMemoryError 例外が発生する可能性があります。

これを回避するには、チャンク化応答 (結果は一連の個別の応答で返される) を有効にします。「オプションのHTTP末尾ヘッダーを使用してマルチパート Gremlin レスポンスを有効にする」を参照してください。

HTTP POST リクエストは Gremlin クエリの送信に推奨されますが、HTTPGETリクエストを使用することもできます。

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

注記

Neptune は、bindings プロパティをサポートしていません。