Consulta de metadatos de documentos - Amazon Quantum Ledger Database (Amazon QLDB)

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 metadatos de documentos

UnINSERTcrea la revisión inicial de un documento con un número de versión de cero. Para identificar de forma exclusiva cada documento, Amazon QLDB asigna unID de documentocomo parte de los metadatos.

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

Todos los ID asignados a QLDB son identificadores únicos universalmente (UUID) que están representados en una cadena codificada en Base62. Para obtener más información, consulte ID únicos en Amazon QLDB.

Vista comprometida

Puede acceder a los metadatos de los documentos consultando elvista comprometida. Esta vista devuelve documentos de la tabla definida por el sistema que corresponden directamente a la tabla de usuarios. Incluye la última revisión confirmada y no eliminada de sus datos y de los metadatos generados por QLDB. Para consultar esta vista, agregue el prefijo_ql_committed_al nombre de la tabla de la consulta. (El prefijo_ql_está reservado en QLDB para objetos del sistema.)

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

Uso de los datos insertados anteriormente enCreación de tablas con índices e inserción de 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 metadatos anidados en elmetadatay los datos de usuario anidados en eldata.

{ 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 vista confirmados

  • blockAddress— La ubicación del bloque en el diario del libro mayor en el que se ha confirmado la revisión del documento. Una dirección, que se puede utilizar para la verificación criptográfica, tiene los dos campos siguientes.

    • strandId: ID exclusivo de la cadena de diario que contiene el bloque.

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

    nota

    Ambos documentos de este ejemplo tienen un idénticoblockAddresscon el mismosequenceNo. Debido a que estos documentos se insertaron en una única transacción (y en este caso, en una sola declaración), se comprometieron en el mismo bloque.

  • hash— El valor hash de iones SHA-256 que representa de forma exclusiva la revisión del documento. El hash cubre la revisióndataymetadatacampos y se puede utilizar paraverificación criptográfica.

  • metadata— Los atributos de metadatos del documento.

    • id— Identificador exclusivo asignado al sistema del documento.

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

    • txTime— Marca de hora en que la revisión del documento se ha confirmado en la revista.

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

Unirse a las vistas confirmadas y de usuario

Puede escribir consultas que se unen a una tabla en la vista confirmada con una tabla en la vista de usuario. Por ejemplo, es posible que exija el documentoidde una tabla con un campo definido por el usuario de otra tabla.

La siguiente consulta une dos tablas denominadasDriversLicenseyPersonen suPersonIdy el documentoidrespectivamente, utilizando la vista confirmada para este último.

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 ID de documento en la vista de usuario predeterminada, proceda aUso de la cláusula BY para consultar el ID de documento.