Subgraph Kimliği ve Dağıtım Kimliği Karşılaştırılması

Her bir Subgraph, bir Subgraph Kimliği (Subgraph ID) ile tanımlanır ve bu Subgraph’in her bir sürümü, bir Dağıtım Kimliği (Deployment ID) ile tanımlanır.

Bir Subgraph sorgulanırken her iki kimlik de kullanılabilir, ancak genellikle spesifik bir Subgraph sürümünü tam olarak tanımlayabildiği için Dağıtım Kimliği’nin kullanılması önerilir.

İki kimlik arasındaki bazı temel farklar şunlardır:

Dağıtım Kimliği

Dağıtım Kimliği (Deployment ID), derlenmiş manifesto dosyasının IPFS hash’idir ve bilgisayardaki göreli URL’ler yerine IPFS üzerindeki diğer dosyalara referans verir. Örneğin, derlenmiş manifesto dosyasına şu bağlantı üzerinden erişilebilir: https://ipfs.thegraph.com/ipfs/QmQKXcNQQRdUvNRMGJiE2idoTu9fo5F5MRtKztH4WyKxED. Dağıtım Kimliği’ni değiştirmek için, manifesto dosyasında güncelleme yapmak yeterlidir; örneğin, Subgraph manifesto dokümantasyonu⁠nda açıklandığı gibi “description” alanını değiştirerek bu sağlanabilir.

Bir Subgraph’in Dağıtım Kimliği kullanılarak sorgu yapıldığında, sorgulanacak Subgraph sürümü açıkça belirtilmiş olur. Belirli bir Subgraph sürümünü sorgulamak için Dağıtım Kimliği kullanmak, sorgulanan sürüm üzerinde tam kontrol sağladığı için daha gelişmiş ve sağlam bir yapı sunar. Ancak, bu yaklaşım her yeni Subgraph sürümü yayımlandığında sorgu kodunun manuel olarak güncellenmesini gerektirir.

Dağıtım Kimliği kullanan örnek uç nokta:

https://gateway-arbitrum.network.thegraph.com/api/[api-key]/deployments/id/QmfYaVdSSekUeK6expfm47tP8adg3NNdEGnVExqswsSwaB

Subgraph Kimliği

Subgraph Kimliği (Subgraph ID), bir Subgraph için benzersiz bir tanımlayıcıdır ve Subgraph’in tüm sürümleri boyunca sabit kalır. En güncel Subgraph sürümünü sorgulamak için Subgraph Kimliği’nin kullanılması önerilir, ancak bununla ilgili bazı dikkat edilmesi gereken noktalar vardır.

Subgraph Kimliği kullanılarak yapılan sorguların, yeni sürümün senkronize olması için zamana ihtiyaç duyması nedeniyle eski bir Subgraph sürümünden yanıt alan sorgulara neden olabileceğini unutmayın. Ayrıca, yeni sürümler şemada uyumsuz değişikliklere yol açabilir.

Subgraph Kimliği kullanan örnek uç nokta: https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/FL3ePDCBbShPvfRJTaSCNnehiqxsPHzpLud6CpbHoeKW