Documentazione Amazon QLDB

Amazon QLDB archivia i record di dati come documenti, che sono solostruct oggetti Amazon Ion inseriti in una tabella. Per le specifiche degli ioni, consulta il GitHub sito Amazon Ion.

Struttura del documento Ion

Come JSON, i documenti QLDB sono composti da coppie nome-valore nella seguente struttura.

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

I nomi sono simboli e i valori sono illimitati. Ogni coppia nome-valore è chiamata campo. Il valore di un campo può essere uno qualsiasi degli IonTipi di dati, inclusi i tipi di contenitore: strutture annidate, elenchi ed elenchi di strutture.

Inoltre, come JSON, astruct è indicato da parentesi ricce ({...}) e alist è indicato da parentesi quadre ([...]). L'esempio seguente è un documento tratto dai dati di esempio inNozioni di base sulla console Amazon QLDB cui sono contenuti valori di vario tipo.

{
    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

In Ion, le virgolette doppie indicano i valori delle stringhe e i simboli senza virgolette rappresentano i nomi dei campi. Ma in PartiQL, le virgolette singole indicano sia le stringhe che i nomi dei campi.

Questa differenza di sintassi consente al linguaggio di query PartiQL di mantenere la compatibilità SQL e al formato dati Amazon Ion di mantenere la compatibilità JSON. Per dettagli sulla sintassi e sulla semantica di PartiQL in QLDB, vedereInterrogare Ion con PartiQL.

Mappatura del tipo a ioni parziali

In QLDB, PartiQL estende il sistema di tipi SQL per coprire il modello di dati Ion. La mappatura è descritta come segue:

• I tipi scalari SQL sono coperti dalle loro controparti Ion. Ad esempio:

  • CHAReVARCHAR sono sequenze Unicode che corrispondono alstring tipo Ion.

  • NUMBERcorrisponde aldecimal tipo Ion.

• Ilstruct tipo di Ion è equivalente a una tupla SQL, che tradizionalmente rappresenta una riga della tabella.

  • Tuttavia, con contenuto aperto e senza schema, le query che si basano sulla natura ordinata di una tupla SQL non sono supportate (come l'ordine di output diSELECT *).

• InoltreNULL, PartiQL ha unMISSING tipo. Questa è una specializzazioneNULL e indica la mancanza di un campo. Questo tipo è necessario perchéstruct i campi ionici potrebbero essere sparsi.

ID del documento

QLDB assegna un ID documento a ogni documento inserito in una tabella. Tutti gli ID assegnati dal sistema sono identificatori univoci universali (UUID), ciascuno rappresentato in una stringa codificata in Base62 (ad esempio3Qv67yjXEwB9SjmvkuG6Cp). Per ulteriori informazioni, consulta ID univoci in Amazon QLDB.

Ogni revisione del documento è identificata in modo univoco da una combinazione dell'ID del documento e di un numero di versione a base zero.

I campi dell'ID e della versione del documento sono inclusi nei metadati del documento, che è possibile interrogare nella vista commit (la vista definita dal sistema di una tabella). Per ulteriori informazioni sulle visualizzazioni in QLDB, consultareConcetti principali. Per ulteriori informazioni sui metadati, consultaInterrogazione dei metadati dei documenti.