Python を使用して Neptune DB インスタンスに接続する

可能であれば、使用しているエンジンバージョンがサポートする最新バージョンの Apache TinkerPop Python Gremlin クライアント gremlinpython を必ず使用してください。新しいバージョンには、クライアントの安定性、パフォーマンス、使いやすさを向上させる多数のバグ修正が含まれています。gremlinpython使用するバージョンは、通常 Java Gremlin TinkerPop クライアントの表に記載されているバージョンと一致します。

注記

作成する gremlinpython Gremlin クエリで TinkerPop 3.4.x の機能のみを使用する限り、3.5.x バージョンは 3.4.x バージョンと互換性があります。

次のセクションでは、Amazon Neptune DB インスタンスに接続し、Gremlin トラバーサルを実施する Python サンプル実行方法について説明します。

Neptune DB インスタンスと同じ仮想プライベートクラウド (VPC) の Amazon EC2 インスタンスからこれらの手順を実行してください。

開始する前に、以下を実行します。

• Python.org ウェブサイトから Python 3.6 以降をダウンロードしてインストールします。

• pip がインストールされていることを確認します。pip がインストールされていないか、または不明な場合は、pip ドキュメンテーション内のpip をインストールする必要がありますか?を参照してください。

• Python のインストールにない場合は、次に示すように futures をダウンロードします。pip install futures

Python を使用して Neptune に接続するには

1. gremlinpython パッケージをインストールするには、次のように入力します。

   pip install --user gremlinpython

2. gremlinexample.py という名前のファイルを作成して、テキストエディタで開きます。

3. gremlinexample.py ファイルに次の内容をコピーします。Neptune DB your-neptune-endpointインスタンスのアドレスに置き換えます。

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

   from __future__  import print_function  # Python 2/3 compatibility
   
   from gremlin_python import statics
   from gremlin_python.structure.graph import Graph
   from gremlin_python.process.graph_traversal import __
   from gremlin_python.process.strategies import *
   from gremlin_python.driver.driver_remote_connection import DriverRemoteConnection
   
   graph = Graph()
   
   remoteConn = DriverRemoteConnection('wss://your-neptune-endpoint:8182/gremlin','g')
   g = graph.traversal().withRemote(remoteConn)
   
   print(g.V().limit(2).toList())
   remoteConn.close()

4. サンプルを実行するには、次のコマンドを入力します。

   python gremlinexample.py

   この例の最後にある Gremlin クエリは、リストの頂点 (g.V().limit(2)) を返します。次に、このリストは標準の Python print 関数で表示されます。

   注記

   Gremlin クエリの最後の部分、toList() では、評価のためにトラバーサルをサーバーに送信する必要があります。そのメソッドまたは別の同等のメソッドを含めない場合、クエリは Neptune DB インスタンスに送信されません。

   以下のメソッドは Neptune DB インスタンスにクエリを送信します。

   • toList()

   • toSet()

   • next()

   • nextTraverser()

   • iterate()

   前述の例では、g.V().limit(2).toList() トラバーサルを使用してグラフの最初の 2 つの頂点を返します。その他の対象にクエリを実行するには、いずれかの適切な終了メソッドを持つ Gremlin トラバーサルで置き換えます。