Documents Amazon QLDB

Amazon QLDB stocke les enregistrements de données sous forme de documents, qui ne sont questruct des objets Amazon Ion insérés dans un tableau. Pour la spécification Ion, consultez le GitHub site Amazon Ion.

Structure d'Ion

Comme 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 ionTypes de données, y compris les types de conteneurs : structures imbriquées, listes et listes de structures.

Tout comme JSON, astruct est indiqué par des accolades ({...}) et alist est indiqué par des crochets ([...]). L'exemple suivant est un document issu des exemples de donnéesMise en route avec la console Amazon QLDB 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 sans guillemets représentent des 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, consultezInterroger Ion avec PartiQL.

Cartographie des types d'ions partiels

Dans QLDB, PartiQL étend le système de types 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 :

  • CHARetVARCHAR sont des séquences Unicode correspondant austring type Ion.

  • NUMBERcorrespond audecimal type Ion.

• Lestruct type d'Ion est équivalent à un tuple SQL, qui représente traditionnellement une ligne de table.

  • Toutefois, avec un contenu ouvert et sans schéma, les requêtes qui s'appuient sur la nature ordonnée d'un tuple SQL ne sont pas prises en charge (comme l'ordre de sortie deSELECT *).

• En plus deNULL, PartiQL possède unMISSING type. Il s'agit d'une spécialisationNULL et indique l'absence de domaine. Ce type est nécessaire carstruct les champs ioniques peuvent être clairsemés.

Numéro du document

QLDB attribue un identifiant de document à chaque document que vous insérez dans un tableau. Tous les identifiants attribués par le système sont des identifiants uniques universels (UUID) qui sont chacun représentés dans une chaîne codée en Base62 (par exemple,3Qv67yjXEwB9SjmvkuG6Cp). Pour plus d'informations, veuillez consulter Identifiants uniques dans Amazon QLDB.

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

Les champs d'ID et de version du document sont inclus dans les métadonnées du document, que vous pouvez consulter dans la vue validée (la vue définie par le système d'une table). Pour plus d'informations sur les vues dans QLDBConcepts de base Pour en savoir plus sur les métadonnées, veuillez consulterInterroger les métadonnées d'un document.