QLDBDocumentos de Amazon - 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.

QLDBDocumentos de Amazon

importante

Aviso de fin del soporte: los clientes actuales podrán utilizar 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.

Amazon QLDB almacena los registros de datos como documentos, que son simplemente struct objetos de Amazon Ion que se insertan en una tabla. Para obtener información sobre las especificaciones de Ion, consulte el GitHub sitio de Amazon Ion.

Estructura del documento de Ion

Del mismo modoJSON, QLDB los documentos se componen de pares nombre-valor en la siguiente estructura.

{ name1: value1, name2: value2, name3: value3, ... nameN: valueN }

Los nombres son un token de símbolo y los valores no tienen restricciones. Cada par nombre-valor se denomina campo. El valor de un campo puede ser cualquiera de los Tipos de datos de Ion, incluidos los tipos de contenedores: estructuras anidadas, listas y listas de estructuras.

Del mismo modoJSON, a struct se indica con corchetes ({...}) y a list se indica con corchetes (). [...] El siguiente ejemplo es un documento de los datos de muestra de Primeros pasos con la QLDB consola Amazon que contiene valores de diversos tipos.

{ VIN: "1N4AL11D75C109151", LicensePlateNumber: "LEWISR261LL", State: "WA", City: "Seattle", PendingPenaltyTicketAmount: 90.25, ValidFrom: 2017-08-21T, ValidTo: 2020-05-11T, Owners: { PrimaryOwner: { PersonId: "294jJ3YUoH1IEEm8GSabOs" }, SecondaryOwners: [{ PersonId: "5Ufgdlnj06gF5CWcOIu64s" }] } }
importante

En Ion, las comillas dobles indican valores de cadena y los símbolos sin comillas representan nombres de campo. Pero en PartiQL, las comillas simples indican tanto las cadenas como los nombres de los campos.

Esta diferencia de sintaxis permite que el lenguaje de consultas PartiQL mantenga la SQL compatibilidad y que el formato de datos Amazon Ion mantenga JSON la compatibilidad. Para obtener más información sobre la sintaxis y la semántica de PartiQL QLDB in, consulte. Consulta de Ion con PartiQL

Mapeo de tipo PartiQL-Ion

EnQLDB, PartiQL amplía el sistema SQL de tipos para cubrir el modelo de datos de iones. Este mapeo se describe de la siguiente manera:

  • SQLLos tipos escalares están cubiertos por sus homólogos de iones. Por ejemplo:

    • CHAR y VARCHAR son secuencias Unicode que se asocian al tipo string de Ion.

    • NUMBER se asocia al tipo decimal de Ion.

  • El struct tipo de ion equivale a una SQL tupla, que tradicionalmente representa una fila de una tabla.

    • Sin embargo, con contenido abierto y sin esquema, no se admiten consultas que se basen en la naturaleza ordenada de una SQL tupla (por ejemplo, el orden de salida deSELECT *).

  • Además de NULL, PartiQL tiene un tipo MISSING. Esta es una especialización de NULL e indica la falta de un campo. Este tipo es necesario porque los campos struct de Ion pueden ser dispersos.

ID del documento

QLDBasigna un identificador de documento a cada documento que inserte en una tabla. 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 (por ejemplo,). 3Qv67yjXEwB9SjmvkuG6Cp Para obtener más información, consulte Único IDs en Amazon QLDB.

Cada revisión de documento se identifica de forma única mediante una combinación del identificador del documento y un número de versión de base cero.

Los campos ID de documento y versión se incluyen en los metadatos del documento, que puede consultar en la vista confirmada (la vista de una tabla definida por el sistema). Para obtener más información sobre las vistas en, consulte. QLDB Conceptos clave Para obtener más información sobre metadatos, consulte Consulta de los metadatos del documento.