Consulta de los metadatos del documento - Base de datos Amazon Quantum Ledger (AmazonQLDB)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Consulta de los metadatos del documento

importante

Aviso de fin de soporte: los clientes actuales podrán usar Amazon QLDB hasta que finalice el soporte, el 31 de julio de 2025. Para obtener más información, consulte Migración de un Amazon QLDB Ledger a Amazon Aurora SQL Postgre.

Una instrucción INSERT crea la revisión inicial de un documento con un número de versión igual a cero. Para identificar de forma única cada documento, Amazon QLDB asigna un identificador de documento como parte de los metadatos.

Además del identificador del documento y el número de versión, QLDB almacena en una tabla otros metadatos generados por el sistema para cada documento. Estos metadatos incluyen información sobre las transacciones, los atributos del diario y el valor hash del documento.

Todos los identificadores universales asignados por el sistema IDs son identificadores únicos (UUID), cada uno de los cuales se representa en una cadena codificada en Base62. Para obtener más información, consulte Único IDs en Amazon QLDB.

Vista confirmada

Puede acceder a los metadatos del documento consultando la vista confirmada. Esta vista devuelve documentos de la tabla generada por el sistema que corresponde directamente a su tabla de usuario. Incluye la última revisión confirmada y no eliminada de sus datos y de los metadatos generados por el sistema. Para consultar esta vista, añada el prefijo _ql_committed_ al nombre de la tabla en la consulta. (El prefijo _ql_ está reservado para los objetos del sistema). QLDB

SELECT * FROM _ql_committed_VehicleRegistration AS r WHERE r.data.VIN IN ('1N4AL11D75C109151', 'KM8SRDHF6EU074761')

Utilizando los datos previamente insertados en Crear tablas con índices e insertar documentos, el resultado de esta consulta muestra el contenido del sistema de la última revisión de cada documento no eliminado. El documento del sistema tiene los metadatos anidados en el campo metadata y los datos de usuario anidados en el campo data.

{ blockAddress:{ strandId:"JdxjkR9bSYB5jMHWcI464T", sequenceNo:14 }, hash:{{wCsmM6qD4STxz0WYmE+47nZvWtcCz9D6zNtCiM5GoWg=}}, data:{ VIN: "1N4AL11D75C109151", LicensePlateNumber: "LEWISR261LL", State: "WA", City: "Seattle", PendingPenaltyTicketAmount: 90.25, ValidFromDate: 2017-08-21T, ValidToDate: 2020-05-11T, Owners: { PrimaryOwner: { PersonId: "294jJ3YUoH1IEEm8GSabOs" }, SecondaryOwners: [{ PersonId: "5Ufgdlnj06gF5CWcOIu64s" }] } }, metadata:{ id:"3Qv67yjXEwB9SjmvkuG6Cp", version:0, txTime:2019-06-05T20:53:321d-3Z, txId:"HgXAkLjAtV0HQ4lNYdzX60" } }, { blockAddress:{ strandId:"JdxjkR9bSYB5jMHWcI464T", sequenceNo:14 }, hash:{{wPuwH60TtcCvg/23BFp+redRXuCALkbDihkEvCX22Jk=}}, data:{ VIN: "KM8SRDHF6EU074761", LicensePlateNumber: "CA762X", State: "WA", City: "Kent", PendingPenaltyTicketAmount: 130.75, ValidFromDate: 2017-09-14T, ValidToDate: 2020-06-25T, Owners: { PrimaryOwner: { PersonId: "IN7MvYtUjkp1GMZu0F6CG9" }, SecondaryOwners: [] } }, metadata:{ id:"JOzfB3lWqGU727mpPeWyxg", version:0, txTime:2019-06-05T20:53:321d-3Z, txId:"HgXAkLjAtV0HQ4lNYdzX60" } }
Campos de la vista confirmada
  • blockAddress: la ubicación del bloque del diario de su libro mayor en el que se confirmó la revisión del documento. Una dirección, que se puede utilizar para la verificación criptográfica, tiene los dos campos siguientes.

    • strandId: el identificador único de la cadena del diario que contiene el bloque.

    • sequenceNo: un número de índice que especifica la ubicación del bloque dentro de la cadena.

    nota

    Los dos documentos de este ejemplo tienen un blockAddress idéntico con el mismo sequenceNo. Como estos documentos se insertaron en una sola transacción (y en este caso, en una sola instrucción), se confirmaron en el mismo bloque.

  • hash— El valor hash SHA de -256 iones que representa de forma exclusiva la revisión del documento. El hash cubre los campos data y metadata de la revisión y se puede utilizar para la verificación criptográfica.

  • data: los atributos de datos de usuario del documento.

    Si redacta una revisión, esta estructura data se sustituye por un campo dataHash cuyo valor es el hash de Ion de la estructura data eliminada.

  • metadata: los atributos de metadatos del documento.

    • id: el identificador único asignado por el sistema al documento.

    • version: el número de versión del documento. Se trata de un entero de base cero que se incrementa con cada revisión del documento.

    • txTime: la fecha y hora de confirmación de la revisión del documento en el diario.

    • txId: el ID único de la transacción que confirmó la revisión del documento.

Combinar las vistas confirmadas y de usuario

Puede escribir consultas que combinen una tabla de la vista confirmada con una tabla de la vista de usuario. Por ejemplo, puede que desee combinar el documento id de una tabla con un campo definido por el usuario de otra tabla.

La siguiente consulta combina dos tablas denominadas DriversLicense y Person en sus campos PersonId e id de documento respectivamente, utilizando la vista confirmada para esta última.

SELECT * FROM DriversLicense AS d INNER JOIN _ql_committed_Person AS p ON d.PersonId = p.metadata.id WHERE p.metadata.id = '1CWScY2qHYI9G88C2SjvtH'

Para obtener información sobre cómo consultar el campo de identificador del documento en la vista de usuario predeterminada, continúe con Uso de la cláusula BY para consultar el identificador del documento.