Documentos de la QLDB - 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.

Documentos de la QLDB

Amazon QLDB almacena los registros de datos como documentos, que sonAmazon Ion structobjetos que se insertan en una tabla. Para obtener información sobre la especificación Ion, consulte laAmazon Ion GitHubsitio:.

Estructura de documentos Ion

Al igual que JSON, los documentos QLDB se componen de pares nombre-valor en la siguiente estructura.

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

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

También como JSON, unstructse denota mediante llaves ({...}), y unlistse indica con corchetes ([...]). El siguiente ejemplo es un documento de los datos de ejemplo deIntroducción a la consola de Amazon QLDBque contiene valores de varios 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 cadenas como nombres de campo.

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

Mapeo de tipos de iones parciales

En QLDB, PartiQL amplía el sistema de tipos de SQL para cubrir el modelo de datos de Ion. Esta asignación se describe de la siguiente manera:

  • Los tipos escalares de SQL están cubiertos por sus homólogos de Ion. Por ejemplo:

    • CHARyVARCHARson secuencias Unicode que se asignan al Ionstring.

    • NUMBERmapas al Iondecimal.

  • Ionstructtype es equivalente a una tupla de SQL, que tradicionalmente representa una tablafila.

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

  • Además deNULL, PartiQL tiene unMISSING. Esta es una especialización deNULLe indica la falta de un campo. Este tipo es necesario porque Ionstructlos campos pueden estar dispersos.

ID de

QLDB asigna unaID dea cada documento que inserte en una tabla. Todos los ID asignados por QLDB son identificadores únicos universales (UUID) que se representan en una cadena codificada en Base62 (por ejemplo,3Qv67yjXEwB9SjmvkuG6Cp). Para obtener más información, consulte ID únicos en Amazon QLDB.

Cada documentorevisiónse identifica de forma exclusiva mediante una combinación del ID del documento y un número de versión basado en cero.

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