Conformité d'Amazon Neptune avec les normes Gremlin

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Les sections suivantes fournissent un aperçu de l'implémentation Neptune de Gkremlin et de ses différences par rapport à l'implémentation Apache. TinkerPop

Neptune implémente certaines étapes de Gkremlin de manière native dans son moteur et utilise l'implémentation d'Apache TinkerPop Gkremlin pour en traiter d'autres (voir). Prise en charge des étapes Gremlin natives dans Amazon Neptune

Normes applicables pour Gremlin

Variables et paramètres dans les scripts

En ce qui concerne les variables pré-liées, l'objet de traversée g est pré-lié dans Neptune, et l'objet graph n'est pas pris en charge.

Bien que Neptune ne prenne pas en charge les variables Gremlin ni le paramétrage dans des scripts, vous pouvez souvent rencontrer sur Internet des exemples de scripts contenant des déclarations de variables, tels que :

String query = "x = 1; g.V(x)";
List<Result> results = client.submit(query).all().get();

Il existe également de nombreux exemples qui utilisent le paramétrage (ou les liaisons) lors de la soumission de requêtes, tels que :

Map<String,Object> params = new HashMap<>();
params.put("x",1);
String query = "g.V(x)";
List<Result> results = client.submit(query).all().get();

Ces exemples de paramètres sont généralement associés à des avertissements sur les pénalités de performance possibles en cas de non-paramétrage lorsque cela est possible. Il existe de nombreux exemples de ce type TinkerPop que vous pouvez rencontrer, et ils semblent tous assez convaincants quant à la nécessité de paramétrer.

Cependant, les fonctionnalités de déclaration de variables et de paramétrage (ainsi que les avertissements) ne s'appliquent qu'au TinkerPop serveur Gremlin lorsqu'il utilise le. GremlinGroovyScriptEngine Elles ne s'appliquent pas lorsque le serveur Gremlin utilise la grammaire gremlin-language ANTLR de Gremlin pour analyser les requêtes. La grammaire ANTLR ne prend en charge ni les déclarations de variables ni le paramétrage. Ainsi, lorsque vous utilisez ANTLR, vous n'avez rien à craindre en cas de non-paramétrage. La grammaire ANTLR étant une composante plus récente TinkerPop, les anciens contenus que vous pouvez rencontrer sur Internet ne reflètent généralement pas cette distinction.

Neptune utilise la grammaire ANTLR dans son moteur de traitement des requêtes plutôt que le moteur GremlinGroovyScriptEngine. Il ne prend donc pas en charge les variables, le paramétrage ni la propriété bindings. Par conséquent, les problèmes potentiels liés au non-paramétrage ne s'appliquent pas dans Neptune. Avec Neptune, il est parfaitement sûr de soumettre simplement la requête telle quelle, alors que beaucoup la paramétrerait. Par conséquent, l'exemple précédent peut être simplifié sans aucune perte de performance comme suit :

String query = "g.V(1)";
List<Result> results = client.submit(query).all().get();

TinkerPop énumérations

Neptune ne prend pas en charge les noms de classe complets pour les valeurs d'énumération. Par exemple, vous devez utiliser single et non org.apache.tinkerpop.gremlin.structure.VertexProperty.Cardinality.single dans votre demande Groovy.

Le type d'énumération est déterminé par le type de paramètre.

Le tableau suivant indique les valeurs d'énumération autorisées et le nom TinkerPop complet correspondant.

Code Java

Neptune ne prend pas en charge les appels à des méthodes définies par des appels arbitraires de bibliothèque Java ou Java autres que ceux pris en charge par Gremlin. APIs Par exemple, java.lang.*, Date() et g.V().tryNext().orElseGet() ne sont pas autorisés.

Propriétés des éléments

Neptune ne prend pas en charge l'materializePropertiesindicateur introduit dans la TinkerPop version 3.7.0 pour renvoyer les propriétés des éléments. Par conséquent, Neptune ne renverra toujours que les sommets ou les arêtes en tant que références avec uniquement leur et. id label

Exécution de script

Toutes les requêtes doivent commencer par g qui est l'objet de traversée.

Dans les soumissions de requête de type Chaîne, plusieurs traversées peuvent être émises, séparées par un point-virgule (;) ou un caractère de saut de ligne (\n). Pour être exécutée, chaque instruction autre que la dernière doit se terminer par une étape .iterate(). Seules les données de la traversée finale sont renvoyées. Notez que cela ne s'applique pas aux soumissions de ByteCode requêtes GLV.

Séances

Les sessions dans Neptune sont limitées à seulement 10 minutes. Voir Sessions basées sur des scripts Gremlin et la référence de TinkerPop session pour plus d'informations.

Transactions

Neptune ouvre une nouvelle transaction au début de chaque traversée Gremlin et ferme la transaction lors de la réussite complète de la traversée. La transaction est annulée lorsqu'il y a une erreur.

Plusieurs instructions séparées par un point-virgule (;) ou un caractère de nouvelle ligne (\n) sont incluses dans une seule transaction. Chaque instruction autre que la dernière doit se terminer par une étape next() à exécuter. Seules les données de la traversée finale sont renvoyées.

La logique de transaction manuelle utilisant tx.commit() et tx.rollback() n'est pas prise en charge.

Vertex et arête IDs

Neptune Gremlin Vertex and Edge IDs doivent être de type. String Ces chaînes d'ID prennent en charge les caractères Unicode et ne peuvent pas dépasser 55 Mo.

Les informations fournies par l'utilisateur IDs sont prises en charge, mais elles sont facultatives dans le cadre d'une utilisation normale. Si vous ne fournissez pas d'ID lorsque vous ajoutez un sommet ou une arête, Neptune génère un UUID et le convertit en chaîne, sous une forme similaire à celle-ci : "48af8178-50ce-971a-fc41-8c9a954cea62". Ils UUIDs ne sont pas conformes à la norme RFC, donc si vous avez besoin d'un standard, UUIDs vous devez les générer en externe et les fournir lorsque vous ajoutez des sommets ou des arêtes.

Fourni par l'utilisateur IDs

Les informations fournies par l'utilisateur IDs sont autorisées dans Neptune Gkremlin sous réserve des stipulations suivantes.

Pour créer un nouveau vertex avec un ID personnalisé, utilisez l'étape property avec le mot-clé id : g.addV().property(id, 'customid').

Tous les sommets IDs doivent être uniques et toutes les arêtes IDs doivent être uniques. Cependant, Neptune permet d'avoir le même ID pour un sommet et une arête.

Si vous essayez de créer un nouveau vertex à l'aide de g.addV() et qu'il existe déjà un vertex ayant cet ID, l'opération échoue. L'exception à cette règle, c'est que si vous précisez une nouvelle étiquette pour le vertex, l'opération réussit, mais elle ajoute la nouvelle étiquette et toute propriété supplémentaire précisée au sommet existant. Rien n'est remplacé. Un nouveau vertex n'est pas créé. L'ID de sommet ne change pas et reste unique.

Par exemple, les commandes suivantes de la console Gremlin aboutissent :

gremlin> g.addV('label1').property(id, 'customid')
gremlin> g.addV('label2').property(id, 'customid')
gremlin> g.V('customid').label()
==>label1::label2

Propriété Vertex IDs

IDs Les propriétés du sommet sont générées automatiquement et peuvent apparaître sous forme de nombres positifs ou négatifs lorsqu'elles sont demandées.

Cardinalité des propriétés de sommet

Neptune prend en charge la cardinalité définie et la cardinalité unique. Si elle n'est pas spécifiée, la cardinalité définie est sélectionnée. Cela signifie que si vous définissez une valeur de propriété, une nouvelle valeur est ajoutée à la propriété, mais uniquement si elle n'apparaît pas déjà dans l'ensemble de valeurs. Il s'agit de la valeur d'énumération Gremlin Set.

List n’est pas pris en charge. Pour plus d'informations sur la cardinalité des propriétés, consultez la rubrique Vertex dans le Gkremlin. JavaDoc

Mise à jour d'une propriété de sommet

Pour mettre à jour une valeur de propriété sans ajouter une valeur à l'ensemble des valeurs, spécifiez la cardinalité single lors de l'étape property.

g.V('exampleid01').property(single, 'age', 25)

Cela supprime toutes les valeurs existantes de la propriété.

Étiquettes

Neptune prend en charge plusieurs étiquettes pour un sommet. Lorsque vous créez une étiquette, vous pouvez spécifier plusieurs étiquettes en les séparant par ::. Par exemple, g.addV("Label1::Label2::Label3") ajoute un vertex, avec trois étiquettes différentes. L'étape hasLabel associe ce sommet à l'une de ces trois étiquettes : hasLabel("Label1") hasLabel("Label2") et hasLabel("Label3").

Caractères d'échappement

Neptune résout tous les caractères d'échappement comme décrit dans la section Escaping Special Characters (Échappement des caractères spéciaux) de la documentation du langage Apache Groovy.

Limites Groovy

Neptune ne prend pas en charge les commandes Groovy qui ne commencent pas par g. Cela inclut les calculs (par exemple, 1+1), les appels système (par exemple, System.nanoTime()) et les définitions de variable (par exemple, 1+1).

Sérialisation

Neptune prend en charge les sérialisations suivantes en fonction du type MIME demandé.

Bien que Neptune prenne en charge ces différents types de sérialiseurs, les conseils d'utilisation sont assez simples. Si vous vous connectez à Neptune via HTTP, privilégiez l'utilisation de application/vnd.gremlin-v3.0+json;types=false car les types intégrés dans la version alternative de GraphSon 3 compliquent l'utilisation. Si vous utilisez des TinkerPop pilotes Apache, vous n'aurez probablement pas à faire de choix car vous utiliseriez la valeur par défaut deapplication/vnd.graphbinary-v1.0. Le n'application/vnd.graphbinary-v1.0-stringdest généralement utile que lorsqu'il est utilisé conjointement avec la console G705 car il convertit tous les résultats en une représentation sous forme de chaîne pour un affichage simple. Les autres formats restent présents pour des raisons liées à l'héritage.

Étapes Lambda

Neptune ne prend pas en charge les étapes Lambda.

Méthodes Gremlin non prises en charge

Neptune ne prend pas en charge les méthodes Gremlin suivantes :

Par exemple, la traversée suivante n'est pas autorisée : g.V().addE('something').from(__.V().next()).to(__.V().next()).

Étapes Gremlin non prises en charge

Neptune ne prend pas en charge les étapes Gremlin suivantes :

Fonctionnalités du graphe Gremlin dans Neptune

L'implémentation Neptune de Gremlin n'expose pas l'objet graph. Les tableaux suivants répertorient les fonctionnalités Gremlin et indiquent si Neptune les prend en charge ou non.

Prise en charge Neptune des fonctionnalités graph

Les fonctionnalités de graphe Neptune sont les mêmes que celles qui seraient renvoyées par la commande graph.features().

Prise en charge Neptune des fonctionnalités de variable

Prise en charge Neptune des fonctionnalités de sommet

Prise en charge Neptune des fonctionnalités de propriété de sommet

Prise en charge Neptune des fonctionnalités d'arête

Prise en charge Neptune des fonctionnalités de propriété d'arête