Utilisation de Neptune Streams

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

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

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 c'est le cas 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.

• 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.

• lastEventId : identifiant de séquence de la dernière modification dans la réponse du flux. Un ID d'événement se compose de deux champs : un commitNum qui identifie une transaction ayant modifié le graphe et un opNum qui identifie une opération spécifique au sein de cette transaction. Voici un exemple :

    "eventId": {
      "commitNum": 12,
      "opNum": 1
    }

• lastTrxTimestamp : heure à laquelle la validation de la transaction a été demandée, en millisecondes, à partir de l'Unix Epoch.

• format : format de sérialisation pour les enregistrements de modification renvoyés. Les valeurs possibles concernent les enregistrements PG_JSON de G705 ou de openCypher modification, et NQUADS les enregistrements de SPARQL modifications.

• records : tableau des enregistrements sérialisés du flux de journaux de modifications inclus dans la réponse. Chaque enregistrement du tableau records contient les champs suivants :

  • commitTimestamp : heure à laquelle la validation de la transaction a été demandée, en millisecondes, à partir de l'Unix Epoch.

  • eventId : identifiant de séquence de l'enregistrement de dernière modification du flux.

  • data— Le G705 sérialiséSPARQL, ou enregistrement des OpenCypher modifications. Les formats de sérialisation de chaque enregistrement sont décrits plus en détail dans la section suivante, Formats de sérialisation dans Neptune Streams.

  • op : opération à l'origine de la modification.

  • isLastOp : présent uniquement si cette opération est la dernière dans sa transaction. Lorsqu'il est présent, il est défini sur true. Utile pour s'assurer qu'une transaction est consommée dans son intégralité.

• totalRecords : nombre total d'enregistrements dans la réponse.