Étape 1 : Demande d'un résumé dans QLDB - Base de données Amazon Quantum Ledger (AmazonQLDB)

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.

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

Important

Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez Migrer un Amazon QLDB Ledger vers Amazon Aurora SQL Postgre.

Amazon QLDB fournit un résumé API pour demander un résumé qui couvre le conseil actuel du journal figurant dans votre grand livre. L'astuce du journal fait référence au dernier bloc validé au moment de la QLDB réception de votre demande. Vous pouvez utiliser le plugin AWS Management Console, une AWS SDK, ou le AWS Command Line Interface (AWS CLI) pour obtenir un condensé.

AWS Management Console

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

Pour demander un résumé (console)
  1. Connectez-vous au AWS Management Console, puis ouvrez la QLDB console Amazon à 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 :

    • Digest — La valeur de hachage SHA -256 du condensé 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.

QLDB API

Vous pouvez également demander un résumé à partir de votre registre en utilisant Amazon QLDB API avec un AWS SDKou le AWS CLI. QLDBAPIfournit l'opération suivante à utiliser 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 du AWS CLI, consultez la commande get-digest dans le AWS CLI Référence de commande.

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 Amazon QLDB Java. 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.