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.

# Documents Amazon QLDB
<a name="ql-reference.docs"></a>

**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](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

Amazon QLDB stocke les enregistrements de données sous forme de documents, qui sont simplement des objets [Amazon](ion.md) `struct` Ion insérés dans une table. Pour les spécifications relatives aux ions, consultez le GitHub site [Amazon Ion](http://amzn.github.io/ion-docs/docs/spec.html).

**Topics**
+ [Structure du document Ion](#ql-reference.docs.ion)
+ [Cartographie des types d'ions partiels](#ql-reference.docs.types)
+ [Identifiant du document](#ql-reference.docs.id)

## Structure du document Ion
<a name="ql-reference.docs.ion"></a>

Tout comme le JSON, les documents QLDB sont composés de paires nom-valeur dans la structure suivante.

```
{
  name1: value1,
  name2: value2,
  name3: value3,
  ...
  nameN: valueN
}
```

Les noms sont des symboles et les valeurs ne sont pas limitées. *Chaque paire nom-valeur est appelée champ.* La valeur d'un champ peut être n'importe quel ion[Types de données](ql-reference.data-types.md), y compris les types de conteneurs : structures imbriquées, listes et listes de structures.

Tout comme JSON, a `struct` est indiqué par des accolades (`{...}`) et a `list` est indiqué par des crochets (). `[...]` L'exemple suivant est un document issu de l'échantillon de données [Commencer à utiliser la console Amazon QLDB](getting-started.md) qui contient des valeurs de différents types.

```
{
    VIN: "1N4AL11D75C109151",
    LicensePlateNumber: "LEWISR261LL",
    State: "WA",
    City: "Seattle",
    PendingPenaltyTicketAmount: 90.25,
    ValidFrom: 2017-08-21T,
    ValidTo: 2020-05-11T,
    Owners: {
        PrimaryOwner: { PersonId: "294jJ3YUoH1IEEm8GSabOs" },
        SecondaryOwners: [{ PersonId: "5Ufgdlnj06gF5CWcOIu64s" }]
    }
}
```

**Important**  
Dans Ion, les guillemets doubles indiquent des valeurs de chaîne et les symboles non guillemets représentent les noms de champs. Mais dans PartiQL, les guillemets simples désignent à la fois les chaînes et les noms de champs.  
Cette différence de syntaxe permet au langage de requête partiQL de maintenir la compatibilité SQL et au format de données Amazon Ion de maintenir la compatibilité JSON. Pour plus de détails sur la syntaxe et la sémantique de partiQL dans QLDB, consultez. [Interroger Ion avec PartiQL](ql-reference.query.md)

## Cartographie des types d'ions partiels
<a name="ql-reference.docs.types"></a>

Dans QLDB, partiQL étend le système de types de SQL pour couvrir le modèle de données Ion. Ce mappage est décrit comme suit :
+ Les types scalaires SQL sont couverts par leurs homologues Ion. Par exemple :
  + `CHAR`et `VARCHAR` sont des séquences Unicode correspondant au `string` type Ion.
  + `NUMBER`correspond au `decimal` type d'ion.
+ Le `struct` type d'Ion est équivalent à un tuple SQL, qui représente traditionnellement une *ligne* de table.
  + Cependant, avec un contenu ouvert et sans schéma, les requêtes qui reposent sur la nature ordonnée d'un tuple SQL ne sont pas prises en charge (comme l'ordre de sortie de`SELECT *`).
+ En plus de`NULL`, partiQL possède un `MISSING` type. Il s'agit d'une spécialisation qui indique l'absence d'un domaine. `NULL` Ce type est nécessaire car `struct` les champs d'ions peuvent être rares.

## Identifiant du document
<a name="ql-reference.docs.id"></a>

QLDB attribue *un ID de document à chaque document* que vous insérez dans un tableau. Tous les identifiants uniques universels (UUID) attribués par le système IDs sont chacun représentés dans une chaîne codée en Base62 (par exemple,). `3Qv67yjXEwB9SjmvkuG6Cp` Pour de plus amples informations, veuillez consulter [Unique IDs dans Amazon QLDB](working.unique-id.md).

Chaque *révision* de document est identifiée de manière unique par une combinaison de l'ID du document et d'un numéro de version à base zéro.

Les champs d'ID et de version du document sont inclus dans les métadonnées du document, que vous pouvez interroger dans la vue *validée (la vue* définie par le système d'une table). Pour plus d'informations sur les vues dans QLDB, consultez. [Concepts de base](ledger-structure.md) Pour en savoir plus sur les métadonnées, consultez[Interrogation des métadonnées d'un document](working.metadata.md).