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.
QLDBDocuments Amazon
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 Amazon QLDB Ledger vers Amazon Aurora SQL Postgre
Amazon QLDB stocke les enregistrements de données sous forme de documents, qui sont simplement struct
des objets Amazon Ion insérés dans un tableau. Pour connaître les spécifications relatives aux ions, consultez le GitHub site Amazon Ion
Structure du document Ion
Par exempleJSON, QLDB les documents 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 ionTypes de données, y compris les types de conteneurs : structures imbriquées, listes et listes de structures.
De mêmeJSON, a struct
est désigné par des accolades ({...}
), et a list
est désigné par des crochets (). [...]
L'exemple suivant est un document issu de l'échantillon de données Commencer à utiliser la QLDB console Amazon 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 SQL compatibilité et au format de données Amazon Ion de maintenir JSON la compatibilité. Pour plus de détails sur la syntaxe et la sémantique de partiQL in, consultez. QLDB Interroger Ion avec PartiQL
Cartographie des types d'ions partiels
DansQLDB, partiQL étend SQL le système de types pour couvrir le modèle de données Ion. Ce mappage est décrit comme suit :
-
SQLles types scalaires sont couverts par leurs homologues ioniques. Par exemple :
-
CHAR
etVARCHAR
sont des séquences Unicode correspondant austring
type Ion. -
NUMBER
correspond audecimal
type d'ion.
-
-
Le
struct
type d'ion est équivalent à un SQL tuple, qui représente traditionnellement une ligne de tableau.-
Cependant, avec un contenu ouvert et sans schéma, les requêtes qui reposent sur la nature ordonnée d'un SQL tuple ne sont pas prises en charge (comme l'ordre de sortie de
SELECT *
).
-
-
En plus de
NULL
, partiQL possède unMISSING
type. Il s'agit d'une spécialisation qui indique l'absence d'un domaine.NULL
Ce type est nécessaire carstruct
les champs d'ions peuvent être rares.
Numéro du document
QLDBattribue un identifiant de document à chaque document que vous insérez dans un tableau. Tous les identifiants uniques universels (UUID) assignés par le système IDs sont chacun représentés dans une chaîne codée en Base62 (par exemple,). 3Qv67yjXEwB9SjmvkuG6Cp
Pour plus d’informations, consultez Unique IDs sur Amazon QLDB.
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 dansQLDB, voirConcepts de base. Pour en savoir plus sur les métadonnées, consultezInterrogation des métadonnées d'un document.