Query The Graph with Python and Subgrounds

Reading time: 2 min

Subgrounds, Playgrounds tarafından oluşturulmuş, subgraph sorgulamak için kullanılan sezgisel bir Python kütüphanesidir. Bu kütüphane, subgraph verilerini doğrudan bir Python veri ortamına bağlamanıza olanak tanır ve pandas gibi kütüphaneleri kullanarak veri analizi yapmanıza imkan sağlar!

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.

Subgrounds, Python 3.10 veya daha yüksek bir sürümünü gerektirir ve pypi üzerinden erişilebilir.

pip install --upgrade subgrounds
# yada
python -m pip install --upgrade subgrounds

Kurulum tamamlandıktan sonra, aşağıdaki sorgu ile subgrounds'ı test edebilirsiniz. Aşağıdaki örnek, Aave v2 protokolü için bir subgraph çeker ve TVL'ye (Toplam Kilitli Varlık) göre sıralanan en üst 5 pazarı sorgular, adlarını ve TVL'lerini (USD cinsinden) seçer ve verileri bir pandas DataFrame olarak döndürür.

from subgrounds import Subgrounds

sg = Subgrounds()

# Subgraph'ı yükleme
aave_v2 = sg.load_subgraph(
    "https://api.thegraph.com/subgraphs/name/messari/aave-v2-ethereum")

# Sorguyu oluşturma
latest_markets = aave_v2.Query.markets(
    orderBy=aave_v2.Market.totalValueLockedUSD,
    orderDirection='desc',
    first=5,
)
# Sorguyu bir veri çerçevesine döndürme
sg.query_df([
    latest_markets.name,
    latest_markets.totalValueLockedUSD,
])

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
  • Başka bir analiz için verilerinizi sorunsuz bir şekilde CSV olarak kaydetme hakkında hızlı bir makale.