Aperçu
Key-Value Store est une solution de stockage de données robuste qui vous permet de gérer de vastes listes de points de données, telles que des centaines (voire des millions) d’adresses de portefeuille, ainsi que des ensembles clé-valeur. Grâce à Key-Value Store, vous pouvez mettre à jour vos listes et vos ensembles clé-valeur à la demande, les gérer et les utiliser à tout moment via l’API REST ou de manière transparente au sein de votre filtre Streams.
Pourquoi un magasin clé-valeur ?
Lorsque vous traitez de grands volumes de données, un stockage efficace et une récupération rapide sont essentiels. Le magasin clé-valeur s'intègre parfaitement à Streams, ce qui vous permet d'évaluer facilement vos listes et vos ensembles clé-valeur par rapport à des données en temps réel et historiques diffusées en continu, de gérer vos listes et vos ensembles, et de suivre les points de données bloc par bloc avec une grande efficacité.
Cette solution est particulièrement utile pour les cas d'utilisation qui nécessitent le suivi, la mise à jour et l'évaluation de grands ensembles de données en temps réel, tels que :
- Applications de portefeuille et de gestion de portefeuille qui souhaitent suivre l'activité d'une liste importante et dynamique d'adresses de portefeuille
- Suivi et vérification des avoirs en jetons
- Applications permettant de suivre l'évolution des valeurs au fil du temps et d'émettre des alertes en cas de changement
Fonctionnalités d'un magasin clé-valeur
- Gestion évolutive des données: gérez, consultez et analysez facilement de vastes ensembles de données, tels que des millions d'adresses ou d'autres éléments de données.
- Mises à jour en temps réel - Mettez vos données à jour à la demande et accédez-y instantanément.
- Accès à l'API - Interagissez avec vos listes et vos ensembles de paires clé-valeur via l'API REST.
- Intégration à Streams: utilisez le magasin clé-valeur de manière transparente au sein des filtres Streams pour bénéficier de capacités de traitement des données améliorées.
- Haute performance — Le magasin clé-valeur offre un temps d'accès ultra-rapide, permettant une recherche et une mise à jour efficaces des données.
Exemples d'utilisation
- Gestion des adresses de portefeuille : gérez des listes d'adresses de portefeuille afin de les comparer aux données en continu.
- Suivi des données historiques : suivez l'évolution des valeurs au fil du temps pour différents indicateurs.
- Analyse de données : calculer les deltas et d'autres statistiques sur de grands ensembles de données.
En tirant parti du magasin clé-valeur, vous pouvez améliorer et personnaliser les flux, ce qui vous permet de créer des ensembles de données en streaming plus sophistiqués, plus efficaces et plus réactifs, en fonction de vos spécifications.
Listes ou ensembles : choisir le bon type de données
| Listes | Ensembles | |
|---|---|---|
| Ce qu'il contient | Une collection nommée d'éléments de type chaîne de caractères associée à une seule clé | Une seule paire clé-valeur |
| Idéal pour | Vérifications relatives à l'adhésion (par exemple : « Cette adresse figure-t-elle dans ma liste de surveillance ? ») | Stockage et récupération de points de données individuels |
| Exemple | Une liste intitulée portefeuilles surveillés contenant des milliers d'adresses de portefeuille | Une clé nommée dernier bloc traité avec valeur 19271294 |
| Fonction « Streams » | qnContainsListItems, qnUpsertList, qnAddListItem | qnGetSet, qnAddSet, qnBulkSets |
Utilisez des listes lorsque vous devez gérer et évaluer un ensemble dynamique d'éléments (par exemple, des adresses de portefeuille, des contrats de jetons, des identifiants de compte) par rapport à des données en flux continu. Utilisez des ensembles lorsque vous devez stocker et récupérer des points de données individuels susceptibles d'évoluer au fil du temps (par exemple, suivre un cumul, stocker le numéro du dernier bloc traité, mettre en cache une valeur calculée entre deux blocs).
Disponibilité et coûts des fonctionnalités
Le service de stockage clé-valeur est accessible aux utilisateurs de toutes les formules Quicknode. Pour plus d'informations, consultez la page des tarifs.
Accès
Accédez au magasin clé-valeur depuis la section « Streams » du portail développeur Quicknode, ainsi que via l'API REST du magasin clé-valeur.
Utilisation d'un magasin clé-valeur avec les filtres Streams
Les éléments du magasin clé-valeur sont sensibles à la casse. Il est particulièrement important de garder cela à l'esprit lorsque l'on travaille avec des adresses de blockchain, car celles-ci doivent être saisies exactement telles qu'elles apparaissent sur la chaîne.
Le Key-Value Store est accessible et gérable en toute transparence depuis un filtre Streams. Vous pouvez créer de nouvelles listes et de nouveaux ensembles clé-valeur, ajouter et supprimer des éléments de vos listes, mettre à jour des ensembles clé-valeur, et comparer les données de votre Key-Value Store à celles de la blockchain en flux continu.
Dans un magasin clé-valeur, un ensemble désigne une seule paire clé-valeur. Une liste est une collection nommée d'éléments de type chaîne de caractères associés à une seule clé.
Utilisation listes Lorsque vous souhaitez associer plusieurs valeurs à une seule clé, vous pouvez par exemple gérer et analyser une longue liste d'adresses de portefeuille en les ajoutant sous la forme articles à une liste intitulée adresses.
Utiliser la valeur-clé ensembles Lorsque vous souhaitez stocker des données afin de pouvoir les récupérer et les mettre à jour facilement, vous pouvez, par exemple, calculer le prix moyen du gaz dans un bloc et enregistrer cette valeur avec la clé gasPrice, puis le récupérer dans le bloc suivant pour calculer le delta.
Fonctions de stockage clé-valeur disponibles dans votre filtre Streams
Listes
qnLib.qnUpsertList: Crée ou met à jour une nouvelle liste dans le magasin clé-valeur.qnLib.qnAddListItem: Ajoute un élément à une liste spécifique dans le magasin clé-valeur.qnLib.qnRemoveListItem: Supprime un élément d'une liste spécifique dans le magasin clé-valeur.qnLib.qnContainsListItems: Recherche par lots permettant de vérifier si plusieurs éléments figurent dans une liste spécifique au sein d'un magasin clé-valeur. Regroupez toutes les recherches en un nombre d'appels aussi réduit que possible afin de limiter les allers-retours et d'améliorer les performances.qnLib.qnDeleteList: Supprime une liste spécifique du magasin clé-valeur.
Exemple de code de filtrage pour les listes
Pour un exemple complet et fonctionnel illustrant toutes les opérations sur les listes (qnUpsertList, qnAddListItem, qnRemoveListItem, qnContainsListItems, qnDeleteList), voir le Documentation sur les filtres de flux.
Ensembles
qnLib.qnAddSet: Crée un ensemble clé-valeur dans le magasin de données clé-valeur.qnLib.qnBulkSets: Permet de créer et de supprimer en masse des ensembles clé-valeur dans le magasin clé-valeur.qnLib.qnDeleteSet: Supprime un ensemble clé-valeur du magasin de données clé-valeur.qnLib.qnGetSet: Récupère la valeur d'une clé spécifique dans le magasin de paires clé-valeur.qnLib.qnListAllSets: Répertorie toutes les clés des ensembles dans le magasin de paires clé-valeur.
Exemple de code de filtrage pour des ensembles de bases de données clé-valeur
Pour un exemple complet et fonctionnel illustrant toutes les opérations sur les ensembles (qnAddSet, qnGetSet, qnListAllSets, qnBulkSets, qnDeleteSet), voir le Documentation sur les filtres de flux.
Vous avez des commentaires sur Key-Value Store ? N'hésitez pas à nous en faire part.