Documentos de Amazon QLDB

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

Estructura del documento de Ion

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

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

Los nombres son símbolos y los valores no están restringidos. Cada par nombre-valor se denomina campo. El valor de un campo puede ser cualquiera de los ionesTipos de datos, incluidos los tipos de contenedores: estructuras anidadas, listas y listas de estructuras.

Al igual que JSON, a se indica con llaves ({...}) y alist se indica con corchetes ([...]).struct El siguiente ejemplo es un documento de los datos de muestraIntroducción a la consola de Amazon QLDB que 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. Sin embargo, en PartiQL, las comillas simples indican tanto cadenas como nombres de campos.

Esta diferencia de sintaxis permite que el lenguaje de consulta PartiQL mantenga la compatibilidad con SQL y que el formato de datos Amazon Ion mantenga la compatibilidad con JSON. Para obtener detalles sobre la sintaxis y la semántica de PartiQL en QLDB, 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. Este mapeo se describe de la siguiente manera:

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

  • CHARyVARCHAR son secuencias Unicode que se asignan alstring tipo Ion.

  • NUMBERse asigna aldecimal tipo de iones.

• Elstruct tipo de Ion equivale a una tupla de SQL, que tradicionalmente representa una fila de una tabla.

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

• Además deNULL, PartiQL tiene unMISSING tipo. Esta es una especializaciónNULL e indica la falta de un campo. Este tipo es necesario porquestruct los campos de iones pueden ser escasos.

ID del documento

QLDB asigna un identificador de documento a cada documento que se inserta en una tabla. 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 (por ejemplo,3Qv67yjXEwB9SjmvkuG6Cp). Para obtener más información, consulte Identificadores únicos en Amazon QLDB.

Cada revisión del documento se identifica de forma única mediante una combinación del identificador 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 la vista confirmada (la vista de una tabla definida por el sistema). Para obtener más información sobre las vistas en QLDB, consulteConceptos clave. Para obtener más información sobre los metadatos, consulteConsultar los metadatos del documento.