Amazon Neptune
ユーザーガイド (API バージョン 2017-11-29)

Gremlin コンソールをセットアップして Neptune DB インスタンスに接続する

Gremlin コンソールにより、REPL (read-eval-print loop) 環境で TinkerPop グラフおよびクエリを試してみることができます。

Gremlin コンソールを使用して、リモートグラフデータベースに接続できます。次のセクションでは、Neptune DB インスタンス にリモートで接続するための Gremlin コンソールのインストールと設定について説明します。Neptune DB インスタンス と同じ仮想プライベートクラウド (VPC) の Amazon EC2 インスタンスからこれらの手順を実行してください。

Gremlin コンソールをインストールして Neptune に接続するには

  1. Gremlin コンソールバイナリには Java 8 が必要です。EC2 インスタンスで Java 8 をインストールするには、次のように入力します。

    sudo yum install java-1.8.0-devel
  2. EC2 インスタンスで Java 8 をデフォルトランタイムとして設定するには、次のように入力します。

    sudo /usr/sbin/alternatives --config java

    プロンプトが表示されたら、Java 8 の数を入力します。

  3. Apache Tinkerpop3 ウェブサイトから、Gremlin コンソール (バージョン 3.4.1+) を EC2 インスタンスにダウンロードします。

    wget https://archive.apache.org/dist/tinkerpop/3.4.1/apache-tinkerpop-gremlin-console-3.4.1-bin.zip
  4. Gremlin コンソール zip ファイルを解凍します。

    unzip apache-tinkerpop-gremlin-console-3.4.1-bin.zip
  5. ディレクトリを解凍ディレクトリに変更します。

    cd apache-tinkerpop-gremlin-console-3.4.1
  6. CA 証明書をダウンロードします。Gremlin コンソールには、リモート証明書を検証する証明書が必要です。

    wget https://www.amazontrust.com/repository/SFSRootCAG2.pem
  7. 抽出されたディレクトリにある conf サブディレクトリで、以下のテキストを含む neptune-remote.yaml という名前のファイルを作成します。your-neptune-endpoint を Neptune DB インスタンス のホスト名または IP アドレスで置き換えます。角括弧 ([ ]) が必要です。

    注記

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

    hosts: [your-neptune-endpoint] port: 8182 connectionPool: { enableSsl: true, trustCertChainFile: "SFSRootCAG2.pem"} serializer: { className: org.apache.tinkerpop.gremlin.driver.ser.GryoMessageSerializerV3d0, config: { serializeResultToString: true }}
  8. ターミナルで Gremlin コンソールディレクトリ (apache-tinkerpop-gremlin-console-3.4.1) に移動し、次のコマンドを入力して Gremlin コンソールを実行します。

    bin/gremlin.sh

    次のような出力が表示されます。

    \,,,/ (o o) -----oOOo-(3)-oOOo----- plugin activated: tinkerpop.server plugin activated: tinkerpop.utilities plugin activated: tinkerpop.tinkergraph gremlin>

    gremlin> プロンプトが表示されます。このプロンプトで残りのステップを入力します。

  9. gremlin> プロンプトで、次のように入力して Neptune DB インスタンス に接続します。

    :remote connect tinkerpop.server conf/neptune-remote.yaml
  10. gremlin> プロンプトで、次のように入力してリモートモードに切り替えます。これにより、すべての Gremlin クエリがリモート接続に送信されます。

    :remote console
  11. Gremlin グラフにクエリを送信するには、次のように入力します。

    g.V().limit(1)
  12. 完了したら、次のように入力して Gremlin コンソールを終了します。

    :exit

注記

各ステートメントを区切るには、セミコロン (;) または改行文字 (\n) を使用します。

最終的なトラバーサルに先行する各トラバーサルは、next() を実行して終わる必要があります。最終的なトラバーサルからのデータのみが返されます。

Gremlin の Neptune 実装の詳細については、「Neptune Gremlin 実装の相違点」を参照してください。