2 dakika
Python ve Subgrounds ile The Graph'i Sorgulama
Subgrounds, Playgrounds tarafından geliştirilen ve Subgraph’leri sorgulamak için kullanılan sezgisel bir Python kütüphanesidir. Bu kütüphane sayesinde Subgraph verilerini doğrudan bir Python veri ortamına bağlayabilir, pandas gibi kütüphaneleri kullanarak veri analizi gerçekleştirebilirsiniz!
Subgrounds, GraphQL sorguları oluşturmak için sayfalandırma gibi sıkıcı iş akışlarını otomatikleştiren ve kontrollü şema dönüşümleri aracılığıyla ileri düzey kullanıcıları güçlendiren basit bir Pythonic API sunar.
Buradan Başlayın
Subgrounds, Python 3.10 veya daha yüksek bir sürümünü gerektirir ve pypi üzerinden erişilebilir.
1pip install --upgrade subgrounds2# yada3python -m pip install --upgrade subgrounds
Kurulum tamamlandıktan sonra, aşağıdaki sorgu ile Subgrounds’u test edebilirsiniz. Bu örnek, Aave v2 protokolüne ait bir Subgraph’i kullanarak TVL (Kilitlenen Toplam Değer) değerine göre sıralanmış ilk beş market’i sorgular; her bir market’in adını ve TVL değerini (USD cinsinden) seçer ve veriyi bir pandas DataFrame olarak döndürür.
1from subgrounds import Subgrounds23sg = Subgrounds()45# Subgraph'i yükleme6aave_v2 = sg.load_subgraph(7 "https://api.thegraph.com/subgraphs/name/messari/aave-v2-ethereum")89# Sorguyu oluşturma10latest_markets = aave_v2.Query.markets(11 orderBy=aave_v2.Market.totalValueLockedUSD,12 orderDirection='desc',13 first=5,14)15# Sorguyu bir DataFrame olarak döndürme16sg.query_df([17 latest_markets.name,18 latest_markets.totalValueLockedUSD,19])
Dökümantasyon
Subgrounds, Playgrounds ekibi tarafından oluşturulmuş ve sürdürülmektedir ve Playgrounds dokümantasyonu üzerinden erişilebilir.
Subgrounds’un keşfedilecek geniş bir özellik seti bulunduğundan, işe bazı yararlı başlangıç noktaları:
- Sorgulamaya Başlarken
- Subgrounds ile sorguların nasıl oluşturulacağına dair iyi bir başlangıç.
- Sentetik Alanlar Oluşturma
- Veri şemasından tanımlanan verileri dönüştüren sentetik alanları tanımlamaya yönelik yumuşak bir giriş.
- Eşzamanlı Sorgular
- Sorgularınızı paralelleştirerek nasıl geliştireceğinizi öğrenin.
- Veriyi CSV dosyalarına aktarma
- Verilerinizi daha ileri analizler için sorunsuz bir şekilde CSV formatında nasıl kaydedeceğinizi anlatan kısa bir makale.