Appeler les Neptune Streams REST API - Amazon Neptune

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.

Appeler les Neptune Streams REST API

Vous accédez à Neptune Streams à l'aide d'un REST API qui envoie une HTTP GET demande à l'un des points de terminaison locaux suivants :

  • Pour une base de données de SPARQL graphes :https://Neptune-DNS:8182/sparql/stream.

  • Pour une base de données Gremlin ou openCypher graphique : https://Neptune-DNS:8182/propertygraph/stream ouhttps://Neptune-DNS:8182/pg/stream.

Note

Depuis la version 1.1.0.0 du moteur, le point de terminaison du flux Gremlin (https://Neptune-DNS:8182/gremlin/stream) est obsolète, ainsi que son format de sortie associé (GREMLIN_JSON). Il reste pris en charge pour des raisons de rétrocompatibilité, mais il pourrait être supprimé dans les futures versions.

Seule une HTTP GET opération est autorisée.

Neptune prend en charge la gzip compression de la réponse, à condition que la HTTP demande inclue un Accept-Encoding en-tête qui indique gzip un format de compression accepté (c'est-à-dire,"Accept-Encoding: gzip").

Paramètres

  • limit : long, facultatif. Plage : de 1 à 100 000. Par défaut : 10

    Spécifie le nombre maximal d'enregistrements à renvoyer. Il existe également une limite de taille de 10 Mo pour la réponse qui ne peut pas être modifiée et qui est prioritaire sur le nombre d'enregistrements spécifié dans le paramètre limit. La réponse inclut un enregistrement de dépassement de seuil si la limite de 10 Mo a été atteinte.

  • iteratorType : chaîne, facultatif.

    Ce paramètre peut avoir l'une des valeurs suivantes :

    • AT_SEQUENCE_NUMBER (valeur par défaut) : indique que la lecture doit commencer à partir du numéro de séquence d'événement spécifié conjointement par les paramètres commitNum et opNum.

    • AFTER_SEQUENCE_NUMBER : indique que la lecture doit commencer juste après le numéro de séquence d'événement spécifié conjointement par les paramètres commitNum et opNum.

    • TRIM_HORIZON : indique que la lecture doit commencer au niveau du dernier enregistrement non tronqué du système, qui est le plus ancien enregistrement n'ayant pas expiré (pas encore supprimé) dans le flux de journaux des modifications. Ce mode est utile lors du démarrage de l'application, lorsque vous n'avez pas de numéro de séquence d'événement de démarrage spécifique.

    • LATEST : indique que la lecture doit commencer au niveau de l'enregistrement le plus récent dans le système, qui est le dernier enregistrement n'ayant pas expiré (pas encore supprimé) dans le flux de journaux des modifications. Cela est utile lorsqu'il est nécessaire de lire les enregistrements à partir du haut actuel des flux afin de ne pas traiter les anciens enregistrements, par exemple lors d'une reprise après sinistre ou d'une mise à niveau sans interruption de service. Notez que dans ce mode, un seul enregistrement est renvoyé au maximum.

  • commitNum— long, obligatoire quand iteratorType est AT_SEQUENCE_NUMBER ouAFTER_SEQUENCE_NUMBER.

    Numéro de validation de l'enregistrement de départ à lire à partir du flux du journal des modifications.

    Ce paramètre est ignoré quand iteratorType a la valeur TRIM_HORIZON ou LATEST.

  • opNum : long, facultatif (la valeur par défaut est 1).

    Numéro de séquence d'opération au sein de la validation spécifiée à partir duquel commencer la lecture dans les données du flux du journal des modifications.

Les opérations qui modifient les données du SPARQL graphe ne génèrent généralement qu'un seul enregistrement de modification par opération. Cependant, les opérations qui modifient les données de graphe Gremlin peuvent générer plusieurs enregistrements de modification par opération, comme dans les exemples suivants :

  • INSERT : un sommet Gremlin peut avoir plusieurs étiquettes, et un élément Gremlin peut avoir plusieurs propriétés. Un enregistrement de modification distinct est généré pour chaque étiquette et propriété lorsqu'un élément est inséré.

  • UPDATE : lorsqu'une propriété d'élément Gremlin est modifiée, deux enregistrements de modification sont générés : le premier pour supprimer la valeur précédente et le second pour insérer la nouvelle valeur.

  • DELETE : un enregistrement de modification distinct est généré pour chaque propriété d'élément supprimée. Par exemple, lorsqu'un arc Gremlin avec des propriétés est supprimé, un enregistrement de modification est généré pour chacune des propriétés, puis un autre enregistrement est généré pour la suppression de l'étiquette d'arc.

    Lorsqu'un sommet Gremlin est supprimé, toutes les propriétés d'arc entrant et sortant sont supprimées en premier, puis viennent les étiquettes d'arc, les propriétés de sommet et enfin les étiquettes de sommet. Chacune de ces suppressions génère un enregistrement de modification.