翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Node.js を使用して Neptune DB インスタンスに接続する
重要
Neptune エンジンバージョンとの互換性を保つには、正しい Apache TinkerPop Gremlin ドライバーバージョンを選択することが重要です。互換性のないバージョンを使用すると、接続の失敗や予期しない動作が発生する可能性があります。バージョンの互換性の詳細については、「」を参照してくださいGremlin を使用した Neptune グラフへのアクセス。
次のセクションでは、Amazon Neptune DB インスタンスに接続し、Gremlin トラバーサルを実施する Node.js サンプル実行方法について説明します。
Neptune DB インスタンスと同じ仮想プライベートクラウド (VPC) の Amazon EC2 インスタンスからこれらの手順を実行してください。
開始する前に、以下を実行します。
Node.js バージョン 8.11 以降がインストールされていることを確認します。そうでない場合、Nodejs.org ウェブサイト
から Node.js をダウンロードしてインストールします。
Node.js を使用して Neptune に接続するには
-
gremlin-javascriptパッケージをインストールするには、次のように入力します。npm install gremlin -
gremlinexample.jsという名前のファイルを作成して、テキストエディタで開きます。 -
gremlinexample.jsファイルに次の内容をコピーします。your-neptune-endpointを Neptune DB インスタンスのアドレスで置き換えます。Neptune DB インスタンスのアドレスを見つける方法については、Amazon Neptune エンドポイントに接続する セクションを参照してください。
const gremlin = require('gremlin'); const DriverRemoteConnection = gremlin.driver.DriverRemoteConnection; const Graph = gremlin.structure.Graph; dc = new DriverRemoteConnection('wss://your-neptune-endpoint:8182/gremlin',{}); const graph = new Graph(); const g = graph.traversal().withRemote(dc); g.V().limit(1).count().next(). then(data => { console.log(data); dc.close(); }).catch(error => { console.log('ERROR', error); dc.close(); }); -
サンプルを実行するには、次のコマンドを入力します。
node gremlinexample.js
前述の例では、g.V().limit(1).count().next() トラバーサルを使用してグラフの単一の頂点の数を返します。その他の対象にクエリを実行するには、いずれかの適切な終了メソッドを持つ Gremlin トラバーサルで置き換えます。
注記
Gremlin クエリの最後の部分、next() では、評価のためにトラバーサルをサーバーに送信する必要があります。そのメソッドまたは別の同等のメソッドを含めない場合、クエリは Neptune DB インスタンスに送信されません。
以下のメソッドは Neptune DB インスタンスにクエリを送信します。
toList()toSet()next()nextTraverser()iterate()
クエリ結果をシリアル化して返す必要がある場合、next() を、そうでない場合は iterate() を使用します。
重要
これは、スタンドアロンの Node.js 例です。 AWS Lambda 関数でこのようなコードを実行する予定がある場合は、Neptune Lambda 関数で JavaScript を効率的に使用する方法の詳細については、Lambda 関数の例「」を参照してください。
IAM 認証
Neptune は、DB クラスターへのアクセスを制御するための IAM 認証をサポートしています。IAM 認証が有効になっている場合は、署名バージョン 4 の署名を使用してリクエストを認証する必要があります。JavaScript クライアントから接続するための詳細な手順とコード例については、「」を参照してくださいGremlin JavaScript による IAM 認証を使用した Amazon Neptune データベースへの接続。