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 des données qui unifie Amazon Ion avec un sous-ensemble de types partiQL. Cette section fournit un aperçu de référence du format de données des documents Ion, indépendamment de son intégration avec partiQL.

Interroger Ion avec PartiQL sur Amazon QLDB

Pour connaître la syntaxe et la sémantique de l'interrogation de données Ion avec PartiQL in, QLDB consultez la référence Interroger Ion avec PartiQL Amazon PartiQL. QLDB

Pour des exemples de code qui interrogent et traitent des données ioniques dans un QLDB registre, reportez-vous aux sections Exemples de code Amazon Ion etTravailler avec Amazon Ion.

Qu'est-ce qu'Amazon Ion ?

Ion est un format de sérialisation de données open source, richement typé, autodescriptif et hiérarchique 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 surensemble deJSON, ce qui signifie que tout JSON document valide est également un document Ion valide. Ce guide suppose une connaissance pratique de base deJSON. Si vous ne le connaissez pas déjàJSON, consultez la section Présentation 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. Par exempleJSON, le formulaire de 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 Ion peut transcoder entre les deux formats pour représenter exactement le même ensemble de structures de données sans aucune 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.

Spécification des ions

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

Pour rationaliser le développement des 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 des données ioniques, consultez le livre de recettes Amazon Ion sur GitHub.

JSONcompatible

De mêmeJSON, 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 JSON données traditionnels suivants :

Extensions de JSON

Types de numéros

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

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

Nouveaux types de données

Amazon Ion ajoute les types de données suivants :

Types nuls

Outre le type nul générique défini parJSON, 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 ionique

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

APIréférences