Riferimento al formato di dati Amazon Ion in Amazon QLDB - Database Amazon Quantum Ledger (Amazon) QLDB
Cos'è Amazon Ion?Specifiche ionicheJSONcompatibileEstensioni da JSONEsempio di testo ionicoAPIriferimenti

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Riferimento al formato di dati Amazon Ion in Amazon QLDB

Importante

Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto il 31/07/2025. Per ulteriori dettagli, consulta Migrare un Amazon QLDB Ledger ad Amazon Aurora Postgre. SQL

Amazon QLDB utilizza un modello di notazione dei dati che unifica Amazon Ion con un sottoinsieme di tipi PartiQL. Questa sezione fornisce una panoramica di riferimento del formato di dati dei documenti Ion, separata dalla sua integrazione con PartiQL.

Interrogare Ion con PartiQL in Amazon QLDB

Per la sintassi e la semantica dell'interrogazione di dati Ion con PartiQL QLDB in, consulta il Interrogare Ion con PartiQL riferimento Amazon PartiQL. QLDB

Per esempi di codice che interrogano ed elaborano dati Ion in un registro, consulta e. QLDB Esempi di codice Amazon Ion Lavorare con Amazon Ion

Argomenti

Cos'è Amazon Ion?

Ion è un formato di serializzazione dei dati gerarchico open source, riccamente tipizzato, autodescrittivo, originariamente sviluppato internamente ad Amazon. Si basa su un modello di dati astratto che consente di archiviare dati strutturati e non strutturati. È un superset diJSON, il che significa che qualsiasi JSON documento valido è anche un documento Ion valido. Questa guida presuppone una conoscenza operativa di base di. JSON Se non lo conosci giàJSON, consulta Introduzione JSON per ulteriori informazioni.

Puoi annotare i documenti Ion in modo intercambiabile in forma di testo leggibile dall'uomo o in forma con codifica binaria. Ad esempioJSON, il modulo di testo è facile da leggere e scrivere e supporta la prototipazione rapida. La codifica binaria è più compatta ed efficiente da persistere, trasmettere e analizzare. Un processore Ion può transcodificare tra entrambi i formati per rappresentare esattamente lo stesso insieme di strutture di dati senza alcuna perdita di dati. Questa funzionalità consente alle applicazioni di ottimizzare il modo in cui elaborano i dati per diversi casi d'uso.

Nota

Il modello di dati Ion è strettamente basato sui valori e non supporta i riferimenti. Pertanto, il modello di dati può rappresentare gerarchie di dati che possono essere annidate a profondità arbitrarie, ma non grafici diretti.

Specifiche ioniche

Per un elenco completo dei tipi di dati principali di Ion con descrizioni complete e dettagli sulla formattazione dei valori, consulta il documento delle specifiche Ion sul GitHub sito Amazon.

Per semplificare lo sviluppo delle applicazioni, Amazon Ion fornisce librerie client che elaborano i dati Ion per te. Per esempi di codice di casi d'uso comuni per l'elaborazione di dati Ion, consulta Amazon Ion Cookbook su GitHub.

JSONcompatibile

AnalogamenteJSON, componi documenti Amazon Ion con un set di tipi di dati primitivi e un set di tipi di contenitori definiti in modo ricorsivo. Ion include i seguenti tipi di dati tradizionali: JSON

  • null: un valore nullo (vuoto) generico e non tipizzato. Inoltre, come descritto nella sezione seguente, Ion supporta un tipo null distinto per ogni tipo primitivo.

  • bool: valori booleani.

  • string: caratteri letterali di testo Unicode.

  • list: raccolte di valori eterogenee ordinate.

  • struct: raccolte non ordinate di coppie nome-valore. Ad esempioJSON, struct consente più valori per nome, ma in genere è sconsigliato.

Estensioni da JSON

Tipi di numeri

Invece del JSON number tipo ambiguo, Amazon Ion definisce rigorosamente i numeri come uno dei seguenti tipi:

  • int: numeri interi con segno di dimensione arbitraria.

  • decimal: numeri reali con codifica decimale di precisione arbitraria.

  • float: numeri in virgola mobile con codifica binaria (64 bit). IEEE

Durante l'analisi dei documenti, un processore Ion assegna i tipi di numeri come segue:

  • int: Numeri senza esponente o punto decimale (ad esempio,). 100200

  • decimal: Numeri con un punto decimale e senza esponente (ad esempio,). 0.00001 200.0

  • float: Numeri con un esponente, come la notazione scientifica o la notazione E (ad esempio,). 2e0 3.1e-4

Nuovi tipi di dati

Amazon Ion aggiunge i seguenti tipi di dati:

  • timestamp: Momenti di data/ora/fuso orario di precisione arbitraria.

  • symbol: atomi simbolici Unicode (come gli identificatori).

  • blob: dati binari di codifica definita dall'utente.

  • clob: dati testuali di codifica definita dall'utente.

  • sexp: raccolte ordinate di valori con semantica definita dall'applicazione.

Tipi nulli

Oltre al tipo null generico definito daJSON, Amazon Ion supporta un tipo null distinto per ogni tipo primitivo. Ciò indica una mancanza di valore pur mantenendo un tipo di dati rigoroso.

null
null.null       // Identical to untyped null
null.bool
null.int
null.float
null.decimal
null.timestamp
null.string
null.symbol
null.blob
null.clob
null.struct
null.list
null.sexp

Esempio di testo ionico

// Here is a struct, which is similar to a JSON object.
{
    // Field names don't always have to be quoted.
    name: "fido",
    
    // This is an integer.
    age: 7,
    
    // This is a timestamp with day precision.
    birthday: 2012-03-01T,
    
    // Here is a list, which is like a JSON array.
    toys: [
        // These are symbol values, which are like strings,
        // but get encoded as integers in binary.
        ball,
        rope
    ],
}

APIriferimenti