Étape 1 : Demande d'un résumé dans QLDB

Amazon QLDB fournit une API permettant de demander un résumé reprenant l'extrait actuel du journal figurant dans votre registre. Le conseil du journal fait référence au dernier bloc validé au moment où QLDB reçoit votre demande. Vous pouvez utiliser le AWS Management Console, un AWS SDK ou le AWS Command Line Interface (AWS CLI) pour obtenir un résumé.

AWS Management Console

Procédez comme suit pour demander un résumé à l'aide de la console QLDB.

Pour demander un résumé (console)

1. Connectez-vous à la AWS Management Console console Amazon QLDB et ouvrez-la à l'adresse https://console.aws.amazon.com/qldb.

2. Dans le volet de navigation, choisissez Ledgers.

3. Dans la liste des registres, sélectionnez le nom du registre pour lequel vous souhaitez demander un résumé.

4. Choisissez Get digest. La boîte de dialogue Obtenir le résumé affiche les détails suivants :

   • Résumé — La valeur de hachage SHA-256 du résumé que vous avez demandé.

   • Adresse du résumé : emplacement du dernier bloc dans le journal concerné par le résumé que vous avez demandé. Une adresse comporte les deux champs suivants :

     • strandId— L'identifiant unique du volet du journal qui contient le bloc.

     • sequenceNo— Le numéro d'index qui indique l'emplacement du bloc dans le fil.

   • Grand livre : nom du registre pour lequel vous avez demandé un résumé.

   • Date — Horodatage auquel vous avez demandé le résumé.

5. Passez en revue les informations du résumé. Ensuite, choisissez Save (Enregistrer). Vous pouvez conserver le nom de fichier par défaut ou en saisir un nouveau.

   Note

   Vous remarquerez peut-être que les valeurs de hachage de votre résumé et de votre adresse de pourboire changent même si vous ne modifiez aucune donnée de votre registre. Cela est dû au fait que la console récupère le catalogue système du registre chaque fois que vous exécutez une requête dans l'éditeur partiQL. Il s'agit d'une transaction de lecture qui est validée dans le journal et entraîne la modification de la dernière adresse de bloc.

   Cette étape enregistre un fichier texte brut dont le contenu est au format Amazon Ion. Le fichier porte l'extension de nom de fichier .ion.txt et contient toutes les informations de synthèse répertoriées dans la boîte de dialogue précédente. Voici un exemple du contenu d'un fichier de synthèse. L'ordre des champs peut varier en fonction de votre navigateur.

   {
     "digest": "42zaJOfV8iGutVGNaIuzQWhD5Xb/5B9lScHnvxPXm9E=",
     "digestTipAddress": "{strandId:\"BlFTjlSXze9BIh1KOszcE3\",sequenceNo:73}",
     "ledger": "my-ledger",
     "date": "2019-04-17T16:57:26.749Z"
   }

6. Enregistrez ce fichier pour pouvoir y accéder à l'avenir. Plus tard, vous pourrez utiliser ce fichier pour vérifier une révision de document par rapport à.

   Important

   La révision du document que vous vérifierez ultérieurement doit être couverte par le résumé que vous avez enregistré. En d'autres termes, le numéro de séquence de l'adresse du document doit être inférieur ou égal au numéro de séquence de l'adresse du Digest tip.

API QLDB

Vous pouvez également demander un résumé à partir de votre registre en utilisant l'API Amazon QLDB avec AWS un SDK ou le. AWS CLI L'API QLDB fournit les opérations suivantes destinées à être utilisées par les programmes d'application :

• GetDigest— Renvoie le résumé d'un registre au dernier bloc validé du journal. La réponse inclut une valeur de hachage de 256 bits et une adresse de bloc.

Pour plus d'informations sur la demande d'un résumé à l'aide de AWS CLI, consultez la commande get-digest dans la référence des AWS CLI commandes.

Exemple d'application

Pour des exemples de code Java, consultez le GitHub référentiel amazon-qldb-dmv-sampleaws-samples/ -java. Pour obtenir des instructions sur le téléchargement et l'installation de cet exemple d'application, consultezInstallation de l'exemple d'application Java Amazon QLDB. Avant de demander un résumé, assurez-vous de suivre les étapes 1 à 3 Tutoriel Java pour créer un registre d'échantillons et le charger avec des exemples de données.

Le code du didacticiel présenté en classe GetDigestfournit un exemple de demande de résumé à partir du registre vehicle-registration d'échantillons.

Pour vérifier la révision d'un document à l'aide du résumé que vous avez enregistré, passez àÉtape 2 : vérification de vos données dans QLDB.