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à.
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 registro Amazon QLDB su Amazon Aurora PostgreSQL
Amazon QLDB utilizza un modello di notazione dei dati che unifica Amazon
Interrogazione di Ion con PartiQL in Amazon QLDB
Per la sintassi e la semantica dell'interrogazione di dati Ion con PartiQL in QLDB, consulta Interrogare Ion con PartiQL il riferimento Amazon QLDB PartiQL.
Per esempi di codice che interrogano ed elaborano dati Ion in un registro QLDB, vedere e. 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 di JSON, il che significa che qualsiasi documento JSON valido è anche un documento Ion valido. Questa guida presuppone una conoscenza operativa di base di JSON. Se non conosci già JSON, consulta Introduzione
Puoi annotare i documenti Ion in modo intercambiabile in forma di testo leggibile dall'uomo o in forma con codifica binaria. Come JSON, 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.
Specificazione ionica
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
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
Compatibile con JSON
Analogamente a JSON, 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 JSON tradizionali:
-
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: testi letterali Unicode. -
list: raccolte di valori eterogenee ordinate. -
struct: raccolte non ordinate di coppie nome-valore. Come JSON,structconsente più valori per nome, ma in genere è sconsigliato.
Estensioni di JSON
Tipi di numeri
Invece dell'ambiguo number tipo JSON, 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 (IEEE a 64 bit).
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.00001200.0 -
float: Numeri con un esponente, come la notazione scientifica o la notazione E (ad esempio,).2e03.1e-4
Nuovi tipi di dati
Amazon Ion aggiunge i seguenti tipi di dati:
-
timestamp: Date/time/timezone momenti 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 da JSON, 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 ], }
Riferimenti API
