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.
Concepts et terminologie de base dans Amazon QLDB
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
Cette section fournit une vue d'ensemble des concepts et de la terminologie de base d'Amazon QLDB, notamment la structure du registre et la façon dont un registre gère les données. En tant que base de données de registre, QLDB se distingue des autres bases de données orientées document en ce qui concerne les concepts clés suivants.
Rubriques
Modèle d'objet de données QLDB
Le modèle d'objet de données fondamental dans Amazon QLDB est décrit comme suit :
-
Grand livre
La première étape consiste à créer un registre, qui est le type de AWS ressource principal dans QLDB. Pour savoir comment créer un registre, consultez la section Prise Étape 1 : Création d'un nouveau registre en main de la console, ouOpérations de base pour les registres Amazon QLDB.
Pour les modes d'
STANDARDautorisationALLOW_ALLet d'autorisation d'un registre, vous créez des politiques AWS Identity and Access Management (IAM) qui accordent des autorisations pour exécuter des opérations d'API sur cette ressource de registre.Format ARN du registre :
arn:aws:qldb:${region}:${account-id}:ledger/${ledger-name} -
Journal et tableaux
Pour commencer à écrire des données dans un registre QLDB, vous devez d'abord créer une table avec une instruction de base. CREATE TABLE Les données du grand livre sont des révisions de documents qui sont enregistrées dans le journal du grand livre. Vous validez les révisions de documents dans le registre dans le contexte de tables définies par l'utilisateur. Dans QLDB, un tableau représente une vue matérialisée d'un ensemble de révisions de documents provenant du journal.
Dans le mode
STANDARDautorisations d'un registre, vous devez créer des politiques IAM qui accordent des autorisations pour exécuter des instructions partiQL sur cette ressource de table. Avec des autorisations sur une ressource de table, vous pouvez exécuter des instructions qui accèdent à l'état actuel de la table. Vous pouvez également consulter l'historique des révisions de la table à l'aide de lahistory()fonction intégrée.Format d’ARN des tables :
arn:aws:qldb:${region}:${account-id}:ledger/${ledger-name}/table/${table-id}Pour plus d'informations sur l'octroi d'autorisations sur un registre et ses ressources associées, consultezComment Amazon QLDB fonctionne avec IAM.
-
Documents
Les tables sont constituées de révisions deDocuments QLDB, qui sont des ensembles de données au
structformat Amazon Ion. Une révision de document représente une version unique d'une séquence de documents identifiés par un identifiant de document unique.QLDB stocke l'historique complet des modifications de vos documents validés. Une table permet d'interroger l'état actuel de ses documents, tandis que la
history()fonction permet d'interroger l'historique complet des révisions des documents d'une table. Pour plus de détails sur l'interrogation et la rédaction de révisions, voirUtilisation des données et de l'historique. -
Catalogue de systèmes
Chaque registre fournit également une ressource de catalogue définie par le système que vous pouvez interroger pour répertorier toutes les tables et tous les index d'un registre. Dans le mode
STANDARDautorisations d'un registre, vous devez disposer de l'qldb:PartiQLSelectautorisation sur cette ressource de catalogue pour effectuer les opérations suivantes :-
Exécutez
SELECTdes instructions sur la table du catalogue système information_schema.user_tables. -
Consultez les informations relatives aux tables et aux index sur la page des détails du registre de la console QLDB.
-
Consultez la liste des tables et des index dans l'éditeur partiQL de la console QLDB.
Format ARN du catalogue :
arn:aws:qldb:${region}:${account-id}:ledger/${ledger-name}/information_schema/user_tables -
Transactions donnant la priorité au journal
Lorsqu'une application lit ou écrit des données dans un registre QLDB, elle le fait dans le cadre d'une transaction de base de données. Toutes les transactions sont soumises aux limites définies dansQuotas et limites dans Amazon QLDB. Dans le cadre d'une transaction, QLDB effectue les étapes suivantes :
-
Lisez l'état actuel des données dans le registre.
-
Exécutez les instructions fournies dans la transaction, puis vérifiez l'absence de conflit à l'aide du contrôle de simultanéité optimiste (OCC) pour garantir une isolation entièrement sérialisable.
-
Si aucun conflit OCC n'est détecté, renvoyez les résultats de la transaction comme suit :
-
Pour les lectures, renvoyez le jeu de résultats et
SELECTvalidez les instructions dans le journal en ajoutant uniquement. -
Pour les écritures, validez les mises à jour, les suppressions ou les données nouvellement insérées dans le journal en ajoutant uniquement.
-
Le journal représente un historique complet et immuable de toutes les modifications apportées à vos données. QLDB écrit un bloc enchaîné dans le journal lors d'une transaction. Chaque bloc contient des objets d'entrée qui représentent les révisions de documents que vous insérez, mettez à jour et supprimez, ainsi que les instructions partiQL qui les ont validées.
Le schéma suivant illustre cette structure de journal.
Le diagramme montre que les transactions sont enregistrées dans le journal sous forme de blocs contenant des entrées de révision de documents. Chaque bloc est haché et enchaîné aux blocs suivants à des fins de vérification. Chaque bloc possède un numéro de séquence pour spécifier son adresse dans le fil.
Note
Dans Amazon QLDB, un fil est une partition du journal de votre registre. QLDB prend actuellement en charge les revues à un seul volet.
Pour plus d'informations sur le contenu des données d'un bloc, consultezContenu du journal dans Amazon QLDB.
Interrogation de vos données
QLDB est conçu pour répondre aux besoins des charges de travail de traitement des transactions en ligne (OLTP) à hautes performances. Un registre fournit des tableaux interrogeables de vos données en fonction des informations de transaction enregistrées dans le journal. Une vue tabulaire dans QLDB est un sous-ensemble des données d'une table. Les vues sont gérées en temps réel, de sorte qu'elles sont toujours disponibles pour les requêtes des applications.
Vous pouvez interroger les vues définies par le système suivantes à l'aide des instructions partiQL : SELECT
-
Utilisateur : dernière révision active des seules données que vous avez écrites dans le tableau (c'est-à-dire l'état actuel de vos données utilisateur). Il s'agit de la vue par défaut dans QLDB.
-
Engagé : dernière révision active de vos données utilisateur et des métadonnées générées par le système. Il s'agit de la table complète définie par le système qui correspond directement à votre table utilisateur.
Outre ces vues interrogeables, vous pouvez consulter l'historique des révisions de vos données à l'aide de la fonction intégrée. Fonction d'historique La fonction d'historique renvoie à la fois vos données utilisateur et les métadonnées associées dans le même schéma que la vue validée.
Stockage de données
Il existe deux types de stockage de données dans QLDB :
-
Stockage du journal : espace disque utilisé par le journal d'un registre. Le journal ne comporte que des ajouts et contient l'historique complet, immuable et vérifiable de toutes les modifications apportées à vos données.
-
Stockage indexé : espace disque utilisé par les tables, les index et l'historique indexé d'un registre. Le stockage indexé est constitué de données de registre optimisées pour les requêtes à hautes performances.
Une fois que vos données ont été validées dans le journal, elles sont matérialisées dans les tables que vous avez définies. Ces tables sont optimisées pour des requêtes plus rapides et plus efficaces. Lorsqu'une application utilise l'API de données transactionnelles pour lire des données, elle accède aux tables et aux index stockés dans votre stockage indexé.
Modèle d'API QLDB
QLDB fournit deux types avec lesquels le code APIs de votre application peut interagir :
-
Amazon QLDB : API de gestion des ressources QLDB (également connue sous le nom de plan de contrôle). Cette API est utilisée uniquement pour gérer les ressources du registre et pour les opérations de données non transactionnelles. Vous pouvez utiliser ces opérations pour créer, supprimer, décrire, répertorier et mettre à jour des registres. Vous pouvez également vérifier les données de manière cryptographique et exporter ou diffuser des blocs de journal.
-
Session Amazon QLDB : API de données transactionnelles QLDB. Vous pouvez utiliser cette API pour exécuter des transactions de données sur un registre avec des instructions PartiQL.
Important
Au lieu d'interagir directement avec l'API de session QLDB, nous vous recommandons d'utiliser le pilote QLDB ou le shell QLDB pour exécuter des transactions de données sur un registre.
-
Si vous travaillez avec un AWS SDK, utilisez le pilote QLDB. Le pilote fournit une couche d'abstraction de haut niveau au-dessus de l'API de données de session QLDB et gère
SendCommandles opérations pour vous. Pour plus d'informations et une liste des langages de programmation pris en charge, consultezCommencer à utiliser le chauffeur. -
Si vous travaillez avec le AWS CLI, utilisez le shell QLDB. Le shell est une interface de ligne de commande qui utilise le pilote QLDB pour interagir avec un registre. Pour plus d’informations, veuillez consulter Utilisation du shell Amazon QLDB (API de données uniquement).
-
Pour plus d'informations sur ces opérations d'API, consultez leRéférence de l'API Amazon QLDB.
Étapes suivantes
Pour savoir comment utiliser un registre avec vos données, consultez Utilisation des données et de l'historique dans Amazon QLDB et suivez les exemples qui décrivent le processus de création de tables, d'insertion de données et d'exécution de requêtes de base. Ce guide explique en profondeur le fonctionnement de ces concepts, à l'aide d'exemples de données et d'exemples de requêtes pour le contexte.
Pour démarrer rapidement avec un exemple de didacticiel d'application utilisant la console QLDB, consultez. Commencer à utiliser la console Amazon QLDB
Pour obtenir la liste des principaux termes et définitions décrits dans cette section, consultez leGlossaire Amazon QLDB.
