翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Neptune の Gremlin 標準への準拠
以下のセクションでは、GremlinのNeptune 実装の概要と、それがApacheの実装とどのように異なるかを説明します。 TinkerPop
Neptune では、一部の Gremlin ステップをエンジンにネイティブに実装し、Apache TinkerPop Gremlin 実装を使用して他のステップを処理しています (を参照)。Amazon Neptune でのネイティブ Gremlin ステップサポート
注記
Gremlin コンソールと Amazon Neptune における実装の違いの具体的な例については、クイックスタートの Gremlin を使用して Amazon Neptune のグラフにアクセスする セクションを参照してください。
トピック
Gremlin に適用される標準
Gremlin 言語は、正式な仕様ではなく、Apache TinkerPop ドキュメンテーションと Apache
の Gremlin 実装によって定義されています。 TinkerPop 数値の形式については、Gremlin は IEEE 754 標準に従っています (IEEE 754-2019 - IEEE Standard for Floating-Point Arithmetic
/Wikipedia IEEE 754 ページ も参照してください)。
スクリプト内の変数とパラメータ
事前にバインドされた変数に関しては、トラバーサルオブジェクト g
はNeptune では事前にバインドされており、graph
オブジェクトはサポートされていません。
Neptune は Gremlin 変数やスクリプト内のパラメータ化をサポートしていませんが、インターネット上では、次のような変数宣言を含む Gremlin Server 用のサンプルスクリプトをよく目にすることがあります。
String query = "x = 1; g.V(x)"; List<Result> results = client.submit(query).all().get();
また、クエリの送信時にパラメータ化
Map<String,Object> params = new HashMap<>(); params.put("x",1); String query = "g.V(x)"; List<Result> results = client.submit(query).all().get();
パラメータの例は通常、可能であればパラメータ化しないことによるパフォーマンス上のペナルティに関する警告と関連付けられます。このような例はたくさんありますが、 TinkerPop どれもパラメータ化の必要性について説得力があるように思えます。
ただし、変数宣言機能とパラメータ化機能 (および警告) はどちらも、の Gremlin Server がを使用している場合にのみ適用されます。 TinkerPop GremlinGroovyScriptEngine
Gremlin Server が Gremlin の gremlin-language
ANTLR 文法を使用してクエリを解析する場合には適用されません。ANTLR 文法は変数宣言もパラメータ化もサポートしていないため、ANTLR を使用するときにはパラメータ化の失敗を心配する必要はありません。ANTLR 文法は、インターネット上で目にする古いコンテンツの新しいコンポーネントであるため TinkerPop、一般的にこの区別は反映されません。
Neptune は、クエリ処理エンジンでは GremlinGroovyScriptEngine
ではなく ANTLR 文法を使用するため、変数、パラメータ化、または bindings
プロパティをサポートしません。その結果、パラメータ化の失敗に関連する問題は、Neptune には当てはまりません。Neptune を使用すると、通常はパラメータ化するようなクエリをそのまま送信しても完全に安全です。そのため、前の例を次のように簡略化しても、パフォーマンスを低下させずに済みます。
String query = "g.V(1)"; List<Result> results = client.submit(query).all().get();
TinkerPop 列挙
Neptune では、列挙値の完全修飾クラス名はサポートしていません。たとえば、Groovy リクエストでは org.apache.tinkerpop.gremlin.structure.VertexProperty.Cardinality.single
ではなく single
を使用する必要があります。
列挙型は、パラメータタイプによって決定されます。
次の表は、使用できる列挙値とそれに関連する完全修飾名を示しています。 TinkerPop
許可された値 | Class |
---|---|
id , キー , ラベル , value |
|
T.id , T.key , T.label , T.value |
|
セット , single |
org.apache.tinkerpop.gremlin.structure。 VertexProperty.カーディナリティ |
asc , desc , shuffle |
|
Order.asc , Order.desc , Order.shuffle |
|
グローバル , ローカル |
|
Scope.global , Scope.local |
|
すべて , first , last , mixed |
|
normSack |
org.apache.tinkerpop.gremlin.process.traversal。 SackFunctions.Barrier |
AddAll , また、 , assign , div ,
max , min , minus , mult ,
または , sum , SumLong |
|
キー , 値 |
|
BOTH , IN , OUT |
|
すべて , なし |
org.apache.tinkerpop.gremlin.process.traversal.step。 TraversalOptionParent.ピック |
Java コード
Neptune は、サポートされている Gremlin API 以外の、任意の Java または Java ライブラリ呼び出しにより定義されるメソッドへの呼び出しをサポートしていません。たとえば、java.lang.*
、Date()
、および g.V().tryNext().orElseGet()
は許可されていません。
スクリプトの実行
すべてのクエリは、トラバーサルオブジェクト g
で始まる必要があります。
文字列クエリの送信で、複数のトラバーサルは、セミコロン (;
) または改行文字 (\n
) で区切って発行することができます。実行されるように、最終以外の各ステートメントは、.iterate()
ステップで終わる必要があります。最終的なトラバーサルデータのみが返されます。これは GLV ByteCode クエリの送信には適用されないことに注意してください。
セッション
Neptune のセッションは、長さが 10 分のみに制限されます。詳細についてはGremlin スクリプトベースのセッション、TinkerPopおよびセッションリファレンスを参照してください
トランザクション
Neptune は、各 Gremlin トラバーサルの開始時に新しいトランザクションを開き、トラバーサルが正常に完了したときにトランザクションを閉じます。エラーが発生すると、トランザクションはロールバックされます。
セミコロン (;
) または改行文字 (\n
) で区切られた複数のステートメントは、単一のトランザクションに含まれています。最後のもの以外の各ステートメントは、next()
ステップの実行で終わる必要があります。最終的なトラバーサルデータのみが返されます。
tx.commit()
および tx.rollback()
を使用した手動トランザクションロジックはサポートされていません。
重要
これは Gremlin クエリをテキスト文字列として送信するメソッドのみに当てはまります (「Gremlin トランザクション」を参照)。
頂点およびエッジ ID
Neptune Gremlin 頂点およびエッジ ID は、タイプ String
である必要があります。これらの ID 文字列は Unicode 文字をサポートし、サイズは 55 MB を超えることはできません。
ユーザーが指定した ID はサポートされますが、通常の使用ではオプションとなります。頂点やエッジを追加するときに ID を指定しなかった場合、Neptune は UUID を生成し、次のような形式の文字列に変換します。これらの UUID は RFC 標準に準拠していないため、標準 UUID が必要な場合は、外部で生成し、頂点やエッジを追加するときに指定する必要があります。
注記
Neptune Load
コマンドでは、~id フィールドを使用して、Neptune CSV 形式で ID を指定する必要があります。
ユーザーによって指定された ID
ユーザーにより提供される ID は、以下の規定により Neptune Gremlin で許可されます。
指定 ID はオプションです。
頂点とエッジのみがサポートされています。
タイプ
String
のみがサポートされます。
カスタム ID で新しい頂点を作成するには、id
キーワードで property
ステップを使用します。g.addV().property(id, 'customid')
。
注記
id
キーワードを引用符で囲むことはできません。T.id
を指します。
すべての頂点 ID およびすべてのエッジ ID は、一意である必要があります。ただし、Neptune では、頂点とエッジで同じ ID を持つことができます。
g.addV()
を使用して新しい頂点を作成しようとする場合、すでにその ID を持つ頂点が存在すると、オペレーションは失敗します。この例外として、頂点に新しいラベルを指定するとオペレーションは成功しますが、新しいラベルおよび既存の頂点に指定されたすべての追加のプロパティが追加されます。Nothing は上書きされます。新しい頂点は作成されません。頂点 ID は変更せず、一意のままになります。
たとえば、次の Gremlin コンソールコマンドは成功します。
gremlin> g.addV('label1').property(id, 'customid') gremlin> g.addV('label2').property(id, 'customid') gremlin> g.V('customid').label() ==>label1::label2
頂点プロパティ ID
頂点プロパティ ID は自動的に生成され、クエリを実行したときに、正または負の数値で表示されます。
頂点プロパティのカーディナリティ
Neptune は、セット濃度と単一濃度をサポートしています。指定されていない場合は、セット濃度が選択されます。つまり、プロパティ値を設定した場合、値のセットにすでに表示されていない場合にのみ、プロパティに新しい値が追加されます。これは、セット
List
はサポートされていません。プロパティカーディナリティについて詳しくは、Gremlin の Vertex
頂点プロパティの更新
値のセットに追加の値を追加せずにプロパティ値を更新するには、property
ステップで single
濃度を指定します。
g.V('exampleid01').property(single, 'age', 25)
これにより、既存のプロパティの値はすべて削除されます。
ラベル
Neptune は、頂点の複数のラベルをサポートしています。ラベルを作成する際、::
で区切ることで複数のラベルを指定できます。たとえば、g.addV("Label1::Label2::Label3")
は頂点に 3 つの異なるラベルを追加します。hasLabel
ステップでは、この頂点を hasLabel("Label1")
、hasLabel("Label2")
、および hasLabel("Label3")
の 3 つのラベルのいずれかと一致させます。
重要
::
区切り記号は、この使用のみに予約されます。hasLabel
ステップで複数のラベルを指定することはできません。たとえば、hasLabel("Label1::Label2")
はいずれにも一致しません。
エスケープ文字
Neptune は、Apache Groovy 言語ドキュメントの 特殊文字のエスケープ セクションで説明されているすべてのエスケープ文字
Groovy の制限
Neptune は、g
以外で始まる Groovy コマンドをサポートしていません。これには、算術 (1+1
など)、システム呼び出し (System.nanoTime()
など)、および変数の定義 (1+1
など) が含まれます。
重要
Neptune では、完全修飾クラス名はサポートしていません。たとえば、Groovy リクエストでは org.apache.tinkerpop.gremlin.structure.VertexProperty.Cardinality.single
ではなく single
を使用する必要があります。
シリアル化
Neptune は、リクエストされた MIME タイプに基づいて、以下のシリアル化をサポートしています。
MIME type | Serialization | Configuration |
|
GryoMessageSerializerv1d0 |
IORegistries: [org.apache.tinkerpop.gremlin.tinkergraph.structure。 TinkerIoRegistryv1d0] |
|
GryoMessageSerializervD/0 |
serializeResultTo文字列:true} |
application/vnd.gremlin-v3.0+gryo |
GryoMessageSerializerv3D0 |
IORegistries: [org.apache.tinkerpop.gremlin.tinkergraph.structure。 TinkerIoRegistryv3D0] |
|
GryoMessageSerializerv3D |
serializeResultTo文字列:true |
|
GraphSON MessageSerializerGremlin v1d0 |
IO レジストリ:[org.apache.tinkerpop.gremlin.tinkergraph.structure。 TinkerIoRegistryv1d0] |
|
GraphSON v2d0 MessageSerializer (only works with WebSockets) |
IO レジストリ:[org.apache.tinkerpop.gremlin.tinkergraph.structure。 TinkerIoRegistryv2d0] |
|
|
|
|
GraphSON v3D0 MessageSerializer |
IORegistries: [org.apache.tinkerpop.gremlin.tinkergraph.structure。 TinkerIoRegistryv3D0] |
|
GraphBinaryMessageSerializerV1 |
|
Lambda ステップ
Neptune では、Lambda ステップはサポートされていません。
サポートされていない Gremlin メソッド
Neptune は、以下の Gremlin メソッドをサポートしていません。
org.apache.tinkerpop.gremlin.process.traversal.dsl.graph.GraphTraversal.program(org.apache.tinkerpop.gremlin.process.computer.VertexProgram)
org.apache.tinkerpop.gremlin.process.traversal.dsl.graph.GraphTraversal.sideEffect(java.util.function.Consumer)
org.apache.tinkerpop.gremlin.process.traversal.dsl.graph.GraphTraversal.from(org.apache.tinkerpop.gremlin.structure.Vertex)
org.apache.tinkerpop.gremlin.process.traversal.dsl.graph.GraphTraversal.to(org.apache.tinkerpop.gremlin.structure.Vertex)
たとえば、以下のトラバーサルは許可されません。g.V().addE('something').from(__.V().next()).to(__.V().next())
。
重要
これは Gremlin クエリをテキスト文字列として送信するメソッドのみに当てはまります。
サポートされていない Gremlin ステップ
Neptune は、以下の Gremlin ステップをサポートしていません。
Gremlin io( ) ステップ
は、Neptune では部分的にしかサポートされていません。 g.io(
のように読み取りコンテキストでは使用できますが、書き込みには使用できません。(url)
).read()
Neptune での Gremlin グラフ機能
Gremlin の Neptune 実装には、graph
オブジェクトは表示されません。次の表は、Gremlin の機能と、Neptune がそれらをサポートしているかどうかを示しています。
Neptune の graph
機能のサポート
Neptune グラフ機能は、サポートされている場合、graph.features()
コマンドによって返されるものと同じです。
グラフ機能 | 有効? |
---|---|
トランザクション |
true |
ThreadedTransactions |
false |
[コンピュータ] |
false |
永続的 |
true |
ConcurrentAccess |
true |
Neptune の変数機能のサポート
変数機能 | 有効? |
---|---|
可変 |
false |
SerializableValues |
false |
UniformListValues |
false |
BooleanArrayValues |
false |
DoubleArrayValues |
false |
IntegerArrayValues |
false |
StringArrayValues |
false |
BooleanValues |
false |
ByteValues |
false |
DoubleValues |
false |
FloatValues |
false |
IntegerValues |
false |
LongValues |
false |
MapValues |
false |
MixedListValues |
false |
StringValues |
false |
ByteArrayValues |
false |
FloatArrayValues |
false |
LongArrayValues |
false |
Neptune の頂点機能のサポート
頂点機能 | 有効? |
---|---|
MetaProperties |
false |
DuplicateMultiProperties |
false |
AddVertices |
true |
RemoveVertices |
true |
MultiProperties |
true |
UserSuppliedIds |
true |
AddProperty |
true |
RemoveProperty |
true |
NumericIds |
false |
StringIds |
true |
UuidIds |
false |
CustomIds |
false |
AnyIds |
false |
Neptune の頂点プロパティ機能のサポート
頂点プロパティ機能 | 有効? |
---|---|
UserSuppliedIds |
false |
AddProperty |
true |
RemoveProperty |
true |
NumericIds |
true |
StringIds |
true |
UuidIds |
false |
CustomIds |
false |
AnyIds |
false |
プロパティ |
true |
SerializableValues |
false |
UniformListValues | false |
BooleanArrayValues |
false |
DoubleArrayValues |
false |
IntegerArrayValues |
false |
StringArrayValues |
false |
BooleanValues |
true |
ByteValues |
true |
DoubleValues |
true |
FloatValues |
true |
IntegerValues |
true |
LongValues |
true |
MapValues |
false |
MixedListValues |
false |
StringValues |
true |
ByteArrayValues |
false |
FloatArrayValues |
false |
LongArrayValues |
false |
Neptune のエッジ機能のサポート
エッジ機能 | 有効? |
---|---|
AddEdges |
true |
RemoveEdges |
true |
UserSuppliedIds |
true |
AddProperty |
true |
RemoveProperty |
true |
NumericIds |
false |
StringIds |
true |
UuidIds |
false |
CustomIds |
false |
AnyIds |
false |
Neptune のエッジプロパティ機能のサポート
エッジプロパティ機能 | 有効? |
---|---|
プロパティ |
true |
SerializableValues |
false |
UniformListValues |
false |
BooleanArrayValues |
false |
DoubleArrayValues |
false |
IntegerArrayValues |
false |
StringArrayValues |
false |
BooleanValues |
true |
ByteValues |
true |
DoubleValues |
true |
FloatValues |
true |
IntegerValues |
true |
LongValues |
true |
MapValues |
false |
MixedListValues |
false |
StringValues |
true |
ByteArrayValues |
false |
FloatArrayValues |
false |
LongArrayValues |
false |