Explorez Cardano : 2. Architecture : d. Travailler avec DB Sync

L'objectif de ce document est d'expliquer comment les utilisateurs de Cardano peuvent extraire des données blockchain de la base de données. Nous examinerons ici les moyens de travailler avec la base de données PostgreSQL et explorerons ses différentes requêtes.

 

Comment extraire des données de la base de données PostgreSQL de DB Sync

Pré-requis pour l'installation

  • Bibliothèque PostgreSQL. Celle-ci peut être installée sur Linux en utilisant par exemple, apt install libpq-dev.
  • Serveur PostgreSQL. Celui-ci peut être installée sur Linux en utilisant par exemple, apt install postgresql.
  • Le paquet Сardano-node. Il fournit les fonctionnalités de base du node Cardano et fonctionne comme un node passif.
  • Le paquet Сardano-db-sync. Il agit comme une bibliothèque pour le support des bases de données et se connecte au node Cardano.

Vous pouvez également exécuter ces composants à l'aide de Docker : le dépôt cardano-db-sync contient un fichier docker-compose.yml qui vous permet de démarrer le node, Postgres et db-sync avec une seule commande:

docker-compose up

 

Comment installer et accéder à la base de données

  1. Vous devrez d'abord installer PostgreSQL.
  2. Créer la base de données et gérer les schémas.
  3. Construisez et exécutez le cardano-node et cardano-db-sync.

 

Tutoriels PostgreSQL utiles:

 

Comment obtenir des données à partir des tables

Les données de la chaîne sont stockées dans des tables dont le mappage est structuré (normalisé) de manière à éviter la duplication des données. Cependant, cela signifie également que pour extraire certaines données (comme les informations sur les transactions, par exemple), vous devrez joindre plusieurs tables dans une requête.

Pour afficher toutes les tables, exécutez cette commande:

\dt

Pour afficher les détails d'une table spécifique:

\d+ TABLE_NAME

Utilisez les requêtes de la section ci-dessous pour obtenir les données blockchain que vous recherchez.

 

Utilisation des outils de gestion de la DB

Une autre façon pratique d'explorer les tables de la base de données est d'utiliser un outil de gestion de la base de données comme https://www.pgadmin.org/.

Cet outil permet de parcourir les tables et leurs définitions (comme les dépendances des clés étrangères) ou de développer et d'exécuter des requêtes complexes.

Suivez les instructions de démarrage pour tout configurer. Vous pouvez maintenant utiliser les requêtes énumérées ci-dessous pour obtenir les données blockchain que vous recherchez.

 

Requêtes utiles

 Vous pouvez trouver une liste de requêtes utiles ici.

 

 

Vous trouverez une copie officielle de ce document ici :

https://docs.cardano.org/explore-cardano/cardano-architecture/working-with-db-sync

 

Plus de traductions de Cardano à: Cardano For The World