Consultar los metadatos del documento

UnaINSERT sentencia crea la revisión inicial de un documento con un número de versión cero. Para identificar de forma exclusiva cada documento, Amazon QLDB asigna un identificador de documento como 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 la información de la transacción, los atributos del diario y el valor de hash del documento.

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

Visión comprometida

Puede acceder a los metadatos del documento consultando la vista 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 el sistema. Para consultar esta vista, añada el prefijo_ql_committed_ al nombre de la tabla de la consulta. (El prefijo_ql_ está reservado en QLDB para los objetos del sistema).

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

Con los datos insertados anteriormenteCrear 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 metadatos anidados en elmetadata campo y sus datos de usuario anidados en eldata campo.

{
    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 visualización comprometidos

• blockAddress— La ubicación del bloque en el diario de su libro mayor en el que se registró 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 de revista 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 son idénticosblockAddress a los mismossequenceNo. Como estos documentos se insertaron en una sola transacción (y, en este caso, en una sola declaración), se confirmaron en el mismo bloque.

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

• data— Los atributos de datos de usuario del documento.

  Si redacta una revisión, estadata estructura se sustituye por undataHash campo cuyo valor es el hash de iones de ladata estructura eliminada.

• metadata— Los atributos de los metadatos del documento.

  • id— El identificador único del documento asignado por el sistema.

  • version— El número de versión del documento. Se trata de un entero de base cero que aumenta con cada revisión del documento.

  • txTime— La marca de tiempo en la que se envió la revisión del documento a la revista.

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

Uniendo las opiniones comprometidas y las de los usuarios

Puede escribir consultas que unan una tabla en la vista comprometida con una tabla en la vista de usuario. Por ejemplo, puede que desee unir el documentoid de una tabla con un campo definido por el usuario de otra tabla.

La siguiente consulta une dos tablas denominadasDriversLicense yPerson en susid camposPersonId y documento, respectivamente, utilizando la vista comprometida 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 del documento en la vista de usuario predeterminada, vaya aUso de la cláusula BY para consultar el ID del documento.