Référence du format de données Amazon Ion dans Amazon QLDB - Amazon Quantum Ledger Database (Amazon QLDB)
Qu'est-ce qu'Amazon IonSpécification lonCompatible avec JSONExtensions depuis JSONExemple de texte lonRéférences d'API

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Référence du format de données Amazon Ion dans Amazon QLDB

Amazon QLDB utilise un modèle de notation de données qui unifie Amazon Ion avec un sous-ensemble de types PartiQL. Cette section fournit une présentation de référence du format de données du document Ion, indépendamment de son intégration à PartiQL.

Interroger Ion avec PartiQL dans Amazon QLDB

Pour connaître la syntaxe et la sémantique de l'interrogation de données Ion à l'aide de PartiQL dans QLDB, consultezInterroger Ion avec PartiQL la référence Amazon QLDB PartiQL.

Pour des exemples de code qui interrogent et traitent des données Ion dans un registre QLDB, consultezExemples de code Amazon Ion etUtilisation d'Amazon Ion.

Rubriques

Qu'est-ce qu'Amazon Ion

Ion est un format de sérialisation de données hiérarchique open source, richement typé et autodescriptif qui a été initialement développé en interne chez Amazon. Il est basé sur un modèle de données abstrait qui vous permet de stocker des données structurées et non structurées. Il s'agit d'un sur-ensemble de JSON, ce qui signifie que tout document JSON valide est également un document Ion valide. Ce guide suppose une connaissance pratique de base de JSON. Si vous ne connaissez pas encore JSON, consultez Présentation du JSON pour plus d'informations.

Vous pouvez noter les documents Ion de manière interchangeable sous forme de texte lisible par l'homme ou sous forme codée en binaire. Comme le JSON, le formulaire texte est facile à lire et à écrire, ce qui permet un prototypage rapide. Le codage binaire est plus compact et plus efficace pour la persistance, la transmission et l'analyse. Un processeur ionique peut transcoder entre les deux formats pour représenter exactement le même ensemble de structures de données sans perte de données. Cette fonctionnalité permet aux applications d'optimiser la façon dont elles traitent les données pour différents cas d'utilisation.

Note

Le modèle de données Ion est strictement basé sur des valeurs et ne prend pas en charge les références. Ainsi, le modèle de données peut représenter des hiérarchies de données qui peuvent être imbriquées à une profondeur arbitraire, mais pas des graphes orientés.

Spécification lon

Pour obtenir la liste complète des types de données Ion Core avec des descriptions complètes et des informations détaillées sur le formatage des valeurs, consultez le document de spécification Ion sur le GitHub site Amazon.

Pour rationaliser le développement d'applications, Amazon Ion fournit des bibliothèques clientes qui traitent les données Ion pour vous. Pour des exemples de code illustrant des cas d'utilisation courants pour le traitement de données Ion, consultez le livre de recettes Amazon Ion sur GitHub.

Compatible avec JSON

Comme au format JSON, vous composez des documents Amazon Ion avec un ensemble de types de données primitifs et un ensemble de types de conteneurs définis de manière récursive. Ion inclut les types de données JSON traditionnels suivants :

  • null: valeur nulle (vide) générique non typée. De plus, comme décrit dans la section suivante, Ion prend en charge un type nul distinct pour chaque type primitif.

  • bool: valeurs booléennes.

  • string: littéraux de texte Unicode.

  • list: ensembles de valeurs hétérogènes ordonnés.

  • struct: collections non ordonnées de paires nom-valeur. Comme JSON, ilstruct autorise plusieurs valeurs par nom, mais cela est généralement déconseillé.

Extensions depuis JSON

Types de numéros

Au lieu dunumber type JSON ambigu, Amazon Ion définit strictement les nombres comme l'un des types suivants :

  • int: entiers signés de taille arbitraire.

  • decimal: nombres réels codés en décimales d'une précision arbitraire.

  • float: nombres à virgule flottante codés en binaire (IEEE 64 bits).

Lors de l'analyse des documents, un processeur ionique attribue les types de numéros suivants :

  • int: nombres sans exposant ni point décimal (par exemple,100200).

  • decimal: nombres avec virgule décimale et sans exposant (par exemple0.00001,200.0).

  • float: nombres avec un exposant, tels que la notation scientifique ou la notation E (par exemple,2e0,3.1e-4).

Nouveaux types de données

Amazon Ion ajoute les types de données suivants :

  • timestamp: moments de date/heure/fuseau horaire d'une précision arbitraire.

  • symbol: atomes symboliques Unicode (tels que les identifiants).

  • blob: données binaires encodées par l'utilisateur.

  • clob: données de texte dont le codage est défini par l'utilisateur.

  • sexp: collections de valeurs ordonnées avec une sémantique définie par l'application.

Types nuls

Outre le type nul générique défini par JSON, Amazon Ion prend en charge un type nul distinct pour chaque type primitif. Cela indique un manque de valeur tout en conservant un type de données strict.

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

Exemple de texte lon

// 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
    ],
}

Références d'API