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.
Important
Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez Migrer un registre Amazon QLDB vers Amazon Aurora PostgreSQL
Amazon QLDB utilise un modèle de notation de données qui unifie Amazon
Interroger Ion avec PartiQL dans Amazon QLDB
Pour connaître la syntaxe et la sémantique de l'interrogation de données Ion avec PartiQL dans QLDB, consultez la référence Amazon QLDB PartiQL. Interroger Ion avec PartiQL
Pour des exemples de code qui interrogent et traitent des données Ion dans un registre QLDB, reportez-vous aux sections et. Exemples de code Amazon Ion Travailler avec Amazon Ion
Rubriques
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 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 le JSON, consultez Présentation du JSON
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 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.
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 imbriquées à une profondeur arbitraire, mais pas des graphes orientés.
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
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
Compatible avec JSON
Comme dans le 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: collections de valeurs hétérogènes ordonnées. -
struct: collections non ordonnées de paires nom-valeur. Comme JSON, ilstructautorise plusieurs valeurs par nom, mais cela est généralement déconseillé.
Extensions depuis JSON
Types de numéros
Au lieu du number 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écimal d'une précision arbitraire. -
float: nombres à virgule flottante codés en binaire (IEEE 64 bits).
Lors de l'analyse de 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 un point décimal et sans exposant (par exemple0.00001,200.0). -
float: nombres avec exposant, tels que la notation scientifique ou la notation E (par exemple2e0,3.1e-4).
Nouveaux types de données
Amazon Ion ajoute les types de données suivants :
-
timestamp: Date/time/timezone moments de précision arbitraire. -
symbol: Atomes symboliques Unicode (tels que les identifiants). -
blob: données binaires de codage défini par l'utilisateur. -
clob: données de texte dont le codage est défini par l'utilisateur. -
sexp: collections ordonnées de valeurs 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 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 ], }
Références d'API
