翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Gremlin コンソールをセットアップして Neptune DB インスタンスに接続する
Gremlin Console により、REPL (read-eval-print loop) 環境で TinkerPop グラフおよびクエリを試してみることができます。
Gremlin コンソールをインストールし、通常の方法で接続する
Gremlin Console を使用して、リモートグラフデータベースに接続できます。次のセクションでは、Neptune DB インスタンスにリモートで接続するための Gremlin Console のインストールと設定について説明します。Neptune DB インスタンスと同じ仮想プライベートクラウド (VPC) の Amazon EC2 インスタンスからこれらの手順を実行してください。
SSL/TLS (必須) で Neptune に接続する方法については、「SSL/TLS 設定」を参照してください。
注記
IAM 認証の有効化を Neptune DB クラスターで行った場合、ここでの手順ではなく Gremlin コンソールでの IAM 認証を使用した Amazon Neptune データベースへの接続 の手順に従い、Gremlin Console をインストールします。
Gremlin Console をインストールして Neptune に接続するには
-
Gremlin Console バイナリには Java 8 または Java 11 が必要です。これらの手順は Java 11 の使用を前提としています。次のように EC2 インスタンスに Java 11 をインストールできます。
-
Amazon Linux 2 (AL2)
を使用している場合: sudo amazon-linux-extras install java-openjdk11
-
Amazon Linux 2023 (AL2023) を使用している場合:
sudo yum install java-11-amazon-corretto-devel
-
他のディストリビューションでは、以下のうち適切なものを使用してください。
sudo yum install java-11-openjdk-devel
または
sudo apt-get install openjdk-11-jdk
-
-
次のように入力して、EC2 インスタンスで Java 11 をデフォルトのランタイムとして設定します。
sudo /usr/sbin/alternatives --config java
プロンプトが表示されたら、Java 11 の数を入力します。
-
Apache ウェブサイトから該当するバージョンの Gremlin コンソールをダウンロードします。現在実行している Neptune エンジンのバージョンに関する java gremlin クライアントページを確認して、サポートしている Gremlin バージョンを確認できます。たとえば、バージョン 3.7.2 では、次のように Apache Tinkerpop3
ウェブサイトから EC2 インスタンスに Gremlin コンソール をダウンロードできます。 wget https://archive.apache.org/dist/tinkerpop/3.7.2/apache-tinkerpop-gremlin-console-3.7.2-bin.zip
-
Gremlin Console zip ファイルを解凍します。
unzip apache-tinkerpop-gremlin-console-3.7.2-bin.zip
-
ディレクトリを解凍ディレクトリに変更します。
cd apache-tinkerpop-gremlin-console-3.7.2
-
抽出されたディレクトリにある
conf
サブディレクトリで、以下のテキストを含むneptune-remote.yaml
という名前のファイルを作成します。your-neptune-endpoint
を Neptune DB インスタンスのホスト名または IP アドレスで置き換えます。角括弧 ([ ]
) が必要です。注記
Neptune DB インスタンスのホスト名を見つける方法については、Amazon Neptune エンドポイントに接続する セクションを参照してください。
hosts: [
your-neptune-endpoint
] port: 8182 connectionPool: { enableSsl: true } serializer: { className: org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1, config: { serializeResultToString: true }}注記
バージョン 3.7.0 では、シリアライザーが
gremlin-driver
モジュールから新しいgremlin-util
モジュールに移動されました。パッケージが org.apache.tinkerpop.gremlin.driver.ser から org.apache.tinkerpop.gremlin.util.ser に変更されました。 -
ターミナルで Gremlin コンソールディレクトリ (
apache-tinkerpop-gremlin-console-3.7.2
) に移動し、次のコマンドを入力して Gremlin コンソールを実行します。bin/gremlin.sh
以下の出力が表示されます。
\,,,/ (o o) -----oOOo-(3)-oOOo----- plugin activated: tinkerpop.server plugin activated: tinkerpop.utilities plugin activated: tinkerpop.tinkergraph gremlin>
gremlin>
プロンプトが表示されます。このプロンプトで残りのステップを入力します。 -
gremlin>
プロンプトで、次のように入力して Neptune DB インスタンスに接続します。:remote connect tinkerpop.server conf/neptune-remote.yaml
-
gremlin>
プロンプトで、次のように入力してリモートモードに切り替えます。これにより、すべての Gremlin クエリがリモート接続に送信されます。:remote console
-
Gremlin グラフにクエリを送信するには、次のように入力します。
g.V().limit(1)
-
完了したら、次のように入力して Gremlin コンソールを終了します。
:exit
注記
各ステートメントを区切るには、セミコロン (;
) または改行文字 (\n
) を使用します。
最終的なトラバーサルに先行する各トラバーサルは、next()
を実行して終わる必要があります。最終的なトラバーサルからのデータのみが返されます。
Gremlin の Neptune 実装の詳細については、Amazon Neptune の Gremlin 標準への準拠を参照してください。