Que sont les Hosted Sinks ?
Mis à jour en août 2026
Hosted Sinks est un service géré sur The Graph Market qui exécute votre sink Substreams pour vous. Vous le pointez vers un package Substreams et votre propre base Postgres ou ClickHouse, et il indexe en continu dans cette base sans que vous ayez à provisionner ou exploiter quoi que ce soit.
Il est actuellement en bêta.
Qu'est-ce qu'il remplace ?
La moitié opérationnelle d'un pipeline de données. Normalement, exécuter un sink signifie déployer un binaire quelque part, le maintenir en vie, le surveiller, le redémarrer en toute sécurité après une panne, et s'assurer que son curseur est persisté pour que les redémarrages ne perdent ni ne dupliquent de données.
Hosted Sinks s'occupe de cette partie. Vous restez propriétaire de la base de données et du module Substreams — ce qui disparaît, c'est l'infrastructure entre les deux.
| Sink auto-géré | Hosted Sink | |
|---|---|---|
| Vous exploitez | Processus du sink, supervision, redémarrages | Rien |
| Vous possédez | Base de données, module | Base de données, module |
| Déploiement | Votre infrastructure | Configuré dans un portail |
| Destinations | Postgres, ClickHouse, Kafka, fichiers, et plus | Postgres, ClickHouse |
| Réseau | Où que vous l'exécutiez | Votre base doit être joignable depuis internet |
De quoi ai-je besoin avant de commencer ?
Un compte et une organisation sur The Graph Market. Un package Substreams qui émet des database changes ou des mappings relationnels — issu du registre ou créé par vous-même. Et une base Postgres ou ClickHouse accessible depuis le réseau, avec votre schéma appliqué ou créé par le package.
Cette dernière exigence est celle qui écarte le plus de monde : la base de données doit être joignable depuis l'infrastructure de StreamingFast. Une base à l'intérieur d'un VPC privé sans route publique ne fonctionnera pas telle quelle.
Comment en mettre un en place ?
Donnez un nom au sink, fournissez le package — soit une URL publique, soit un identifiant de registre comme ethereum_common@v0.3.3 — puis choisissez Postgres ou ClickHouse et saisissez les informations de connexion.
Définissez la plage d'exécution : un bloc de départ (0 pour la genèse) et un bloc d'arrêt (0 pour suivre la tête de chaîne indéfiniment), plus le nom du module de sortie, généralement db_out. Des filtres et des paramètres de module sont disponibles si le package les prend en charge.
Déployez, et le sink se provisionne et commence à indexer.
Utilisez un utilisateur de base de données dédié, avec un accès en écriture limité au schéma cible, plutôt qu'un compte administrateur. Les identifiants sont stockés pour connecter le sink à votre base, et des permissions restreintes sont simplement une bonne pratique.
Quelles bases de données gérées fonctionnent ?
Des guides détaillés existent pour Supabase et Neon côté Postgres, et pour ClickHouse Cloud côté analytique. Toute instance Postgres ou ClickHouse joignable devrait fonctionner ; ces trois-là ont simplement des guides pas à pas.
Quand dois-je plutôt exécuter le sink moi-même ?
Quand vous avez besoin d'une destination que Hosted Sinks ne couvre pas — Kafka, PubSub, des fichiers, ou un consommateur personnalisé. Quand votre base de données ne peut pas être publiquement joignable. Ou quand vous voulez que le sink soit co-localisé avec votre base pour des raisons de latence ou de coûts de sortie réseau.
Les deux chemins utilisent le même package Substreams, c'est donc une décision de déploiement plutôt qu'une décision d'architecture. Commencer en mode hébergé puis migrer plus tard ne signifie rien réécrire.
Questions fréquentes
Hosted Sinks stocke-t-il mes données ? Non. Il écrit dans votre propre base de données. Vous êtes propriétaire des données et du schéma.
Puis-je l'utiliser avec Kafka ? Pas actuellement — Hosted Sinks prend en charge Postgres et ClickHouse. Les autres destinations nécessitent un sink auto-géré.
Est-ce prêt pour la production ? C'est en bêta et en développement actif. Vérifiez le statut actuel avant d'en dépendre pour des charges de travail critiques.
Mettez-en un en place sur thegraph.market — aucune information personnelle requise pour obtenir une clé API.
Voir aussi : Comment diffuser des données onchain vers une base de données ? · Comment obtenir des données blockchain dans Postgres ? · Comment obtenir des données blockchain dans ClickHouse ?