Subgraph

Subgraph adalah pipeline data dan API kueri yang ditentukan developer untuk mengindeks data blockchain tertentu ke dalam skema terstruktur. Dalam ekosistem The Graph, manifest menetapkan jaringan, kontrak, dan event handler; mapping mengubah data yang dipilih menjadi entitas yang dapat di-query klien dengan GraphQL.

Bagian-bagian subgraph

Proyek subgraph umumnya memiliki manifest, skema GraphQL, dan kode mapping. Manifest menyatakan data apa yang dipantau dan cara memprosesnya; skema mendefinisikan entitas serta kolom yang dibuka oleh API; mapping menerjemahkan event atau pemanggilan blockchain terpilih menjadi entitas tersebut. API yang dihasilkan mengikuti model data pilihan developer, bukan semua fakta yang ada di chain.

Satu subgraph The Graph dapat mengindeks beberapa kontrak pada satu jaringan, tetapi dokumentasi manifest resminya menyatakan satu subgraph tidak mengindeks beberapa jaringan sekaligus. Proyek yang membutuhkan beberapa jaringan biasanya memerlukan deployment terpisah atau arsitektur lain.

Kueri dan batas data

Aplikasi mengirim kueri GraphQL ke endpoint subgraph atau Gateway. Respons berasal dari deployment yang dilayani endpoint tersebut, jadi developer sebaiknya memastikan identitas subgraph, versi deployment, jaringan, dan kemajuan indexing sebelum menggunakan hasilnya.

Subgraph memudahkan kueri terstruktur berulang dibandingkan membangun ulang setiap relasi dari blok mentah, tetapi tidak menghilangkan pertanyaan tentang kualitas data. Handler yang terlewat, mapping yang keliru, indeks yang tertinggal, atau skema yang terbatas dapat menghasilkan jawaban tidak lengkap. Untuk keputusan berisiko tinggi, subgraph juga tidak menggantikan pemeriksaan transaksi atau state secara langsung.

Sentimen Media Sosial

Sebuah utas developer r/thegraph yang lebih lama menanyakan cara menemukan kontrak dan data yang tepat saat membuat subgraph; balasan mengarahkan pembaca ke bantuan komunitas dan contoh proyek. Ini menggambarkan tantangan belajar dalam diskusi tersebut, bukan keadaan terkini alat atau layanan The Graph. diskusi developer di r/thegraph

Terakhir diperbarui: 2026-10

Istilah Terkait

Lihat Juga

Sumber

  • Manifest subgraph The Graph — Panduan resmi menjelaskan cara manifest menetapkan jaringan, kontrak, event handler, skema, dan mapping.
  • API GraphQL The Graph — Dokumentasi menjelaskan kueri GraphQL read-only terhadap entitas dan field yang ditentukan oleh skema subgraph.
  • Menyajikan kueri melalui Gateway — Panduan Gateway menjelaskan bagaimana permintaan diselesaikan melalui ID subgraph atau deployment dan dilayani Indexer.