2026-04-10 23:20:41 -04:00
---
layout: default
title: "GraphQL Sorgu Teknik Özellikleri"
parent: "Turkish (Beta)"
---
2026-04-10 12:22:20 -04:00
# GraphQL Sorgu Teknik Özellikleri
2026-04-10 23:20:41 -04:00
> **Beta Translation:** This document was translated via Machine Learning and as such may not be 100% accurate. All non-English languages are currently classified as Beta.
2026-04-10 12:22:20 -04:00
## Genel Bakı
Bu özellik, TrustGraph'ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı
GraphQL sorgu hizmeti, Cassandra'da depolanan yapı ı ı ı ı ı ı ı ı ı ı
## Hedefler
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
**Dinamik Şema Desteği**: Hizmeti yeniden başlatmaya gerek kalmadan yapı ı ı
**GraphQL Standartları ı ı
**Verimli Cassandra Sorguları ı ı ı ı ı
**İlişki Çözümlemesi**: Farklı ı
**Tür Güvenliği**: Şema tanı ı ı ı
**Ölçeklenebilir Performans**: Uygun bağlantı ı ı
**İstek/Yanı ı ı ı ı ı
**Hata İşleme**: Şema uyumsuzlukları ı ı ı ı
## Arka Plan
Yapı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı
Bu özellik tarafı ı ı ı
Cassandra'da depolanan yapı ı ı ı
Yapı ı ı ı
İlişkili nesneler arası
Yapı ı ı ı
GraphQL sorgu hizmeti, bunları ı ı
Cassandra tabloları ı
TrustGraph yapı ı ı ı
GraphQL sorguları ı
Alan çözümleyicileri aracı ı ı
2026-04-11 01:08:44 +00:00
=======
**Dinamik Şema Desteği**: Hizmeti yeniden başlatmadan yapı ı
**GraphQL Standartları ı
**Verimli Cassandra Sorguları ı ı ı ı ı
**İlişki Çözümleme**: Farklı ı
**Tür Güvenliği**: Şema tanı ı ı ı
**Ölçeklenebilir Performans**: Uygun bağlantı ı ı
**İstek/Yanı ı ı ı ı ı
**Hata İşleme**: Şema uyumsuzlukları ı ı ı
## Arka Plan
Yapı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı ı
Bu özellik tarafı ı ı ı
Cassandra'da depolanan yapı ı ı ı ı
Yapı ı ı ı
İlişkili nesneler arası
Yapı ı ı ı ı
GraphQL sorgu hizmeti, bu boşlukları ı ı
Cassandra tabloları ı
TrustGraph yapı ı ı ı
GraphQL sorguları ı
Alan çözümleyicileri aracı ı ı
>>>>>>> 82edf2d (New md files from RunPod)
2026-04-10 12:22:20 -04:00
## Teknik Tasarı
### Mimari
GraphQL sorgu hizmeti, yerleşik kalı ı ı ı ı
**Modül Konumu**: `trustgraph-flow/trustgraph/query/objects/cassandra/`
**Ana Bileşenler**:
1. **GraphQL Sorgu Hizmeti İşlemcisi**
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
Temel FlowProcessor sı ı ı ı
Mevcut sorgu hizmetlerine benzer bir istek/yanı ı ı ı
Şema güncellemeleri için yapı ı ı
GraphQL şeması ı ı ı
2. **Dinamik Şema Oluşturucu**
TrustGraph RowSchema tanı ı ı
Uygun alan tanı ı
Koleksiyon tabanlı
Yapı ı ı ı
3. **Sorgu Yürütücüsü**
Gelen GraphQL sorguları ı ı ı ı
Sorguları
Sorguları ı ı ı ı ı
Ayrı ı ı ı ı
4. **Cassandra Sorgu Çevirmeni**
GraphQL seçimlerini CQL sorguları
Mevcut dizinlere ve bölüm anahtarları ı
Filtrelemeyi, sayfalama ve sı ı
Bağlantı
5. **İlişki Çözümleyici**
Nesne ilişkileri için alan çözümleyicilerini uygular.
N+1 sorguları ı
Çözümlenen ilişkileri istek bağlamı ı
Hem ileri hem de geri ilişki geçişini destekler.
2026-04-11 01:08:44 +00:00
=======
Temel FlowProcessor sı ı ı ı
Mevcut sorgu hizmetlerine benzer bir istek/yanı ı ı ı
Şema güncellemeleri için yapı ı ı
GraphQL şeması ı ı ı
2. **Dinamik Şema Oluşturucu**
TrustGraph RowSchema tanı ı ı
Uygun alan tanı ı
Koleksiyon tabanlı
Yapı ı ı ı
3. **Sorgu Yürütücüsü**
Gelen GraphQL sorguları ı ı ı ı
Sorguları
Sorguları ı ı ı ı ı
Ayrı ı ı ı ı
4. **Cassandra Sorgu Çevirmeni**
GraphQL seçimlerini CQL sorguları
Mevcut dizinlere ve bölüm anahtarları ı
Filtrelemeyi, sayfalama ve sı ı
Bağlantı
5. **İlişki Çözümleyici**
Nesne ilişkileri için alan çözümleyicilerini uygular
N+1 sorguları ı
Çözümlenen ilişkileri istek bağlamı ı
Hem ileri hem de geri ilişki geçişini destekler
>>>>>>> 82edf2d (New md files from RunPod)
2026-04-10 12:22:20 -04:00
### Yapı ı ı
Hizmet, şema güncellemelerini almak için bir yapı ı
```python
self.register_config_handler(self.on_schema_config)
```
Şemalar değiştiğinde:
1. Yapı ı ı ı ı ı ı ı
2. GraphQL türlerini ve çözümleyicileri yeniden oluşturun.
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
3. Çalı ı ı ı
2026-04-11 01:08:44 +00:00
=======
3. Uygulanabilir şemayı
>>>>>>> 82edf2d (New md files from RunPod)
2026-04-10 12:22:20 -04:00
4. Şemaya bağlı
### GraphQL Şema Oluşturma
Yapı ı ı
1. **GraphQL Nesne Türü** :
Alan türlerini eşleyin (string → String, integer → Int, float → Float, boolean → Boolean).
Gerekli alanları
Şemadan alan açı ı ı
2. **Kök Sorgu Alanları :
Koleksiyon sorgusu (örneğin, `customers` , `transactions` ).
İndekslenmiş alanlara göre filtreleme argümanları
Sayfalama desteği (limit, offset).
Sı ı
3. **İlişki Alanları :
Şemadan yabancı
İlgili nesneler için alan çözümleyicileri oluşturun.
Hem tek nesne hem de liste ilişkilerini destekleyin.
### Sorgu Yürütme Akı ı
1. **İstek Alma** :
Pulsar'dan ObjectsQueryRequest'i alı
GraphQL sorgu dizesini ve değişkenlerini çı ı
Kullanı ı ı ı ı
2. **Sorgu Doğrulama** :
Strawberry kullanarak GraphQL sorgusunu ayrı ı ı
Mevcut şemaya göre doğrulayı
Alan seçimlerini ve argüman türlerini kontrol edin.
3. **CQL Oluşturma** :
GraphQL seçimlerini analiz edin.
Uygun WHERE koşulları
Koleksiyonu bölüm anahtarı
GraphQL argümanları ı
4. **Sorgu Yürütme** :
CQL sorgusunu Cassandra'ya karşı
Sonuçları ı ı ı
Herhangi bir ilişki alanı ı
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
Yanı ı
2026-04-11 01:08:44 +00:00
=======
Yanı ı
>>>>>>> 82edf2d (New md files from RunPod)
2026-04-10 12:22:20 -04:00
5. **Yanı :
Sonuçlarla ObjectsQueryResponse oluşturun.
Herhangi bir yürütme hatası ı
Yanı ı
### Veri Modelleri
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
> **Not**: `trustgraph-base/trustgraph/schema/services/structured_query.py`'da mevcut bir StructuredQueryRequest/Response şeması ı ı ı ı ı ı ı ı ı
2026-04-11 01:08:44 +00:00
=======
> **Not**: `trustgraph-base/trustgraph/schema/services/structured_query.py`'da mevcut bir StructuredQueryRequest/Response şeması ı ı ı ı ı ı ı ı ı
>>>>>>> 82edf2d (New md files from RunPod)
2026-04-10 12:22:20 -04:00
#### İstek Şeması
```python
from pulsar.schema import Record, String, Map, Array
class ObjectsQueryRequest(Record):
user = String() # Cassandra keyspace (follows pattern from TriplesQueryRequest)
collection = String() # Data collection identifier (required for partition key)
query = String() # GraphQL query string
variables = Map(String()) # GraphQL variables (consider enhancing to support all JSON types)
operation_name = String() # Operation to execute for multi-operation documents
```
**Mevcut StructuredQueryRequest'ten yapı
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
Diğer sorgu hizmetlerinin kalı ı `user` ve `collection` alanları
2026-04-11 01:08:44 +00:00
=======
Diğer sorgu hizmetlerinin kalı ı ı `user` ve `collection` alanları
>>>>>>> 82edf2d (New md files from RunPod)
2026-04-10 12:22:20 -04:00
Bu alanlar, Cassandra anahtar alanı ı ı
Değişkenler şu anda Map(String()) olarak kalmaktadı
#### Yanı ı
```python
from pulsar.schema import Record, String, Array
from ..core.primitives import Error
class GraphQLError(Record):
message = String()
path = Array(String()) # Path to the field that caused the error
extensions = Map(String()) # Additional error metadata
class ObjectsQueryResponse(Record):
error = Error() # System-level error (connection, timeout, etc.)
data = String() # JSON-encoded GraphQL response data
errors = Array(GraphQLError) # GraphQL field-level errors
extensions = Map(String()) # Query metadata (execution time, etc.)
```
**Mevcut StructuredQueryResponse'tan yapı
Sistem hataları ı `error` ) ve GraphQL hataları ı `errors` ) ayı ı
Dizi yerine yapı ı ı ı ı
GraphQL spesifikasyonuna uygunluk için `extensions` alanı
Uyumluluk için verileri JSON dizesi olarak tutar, ancak yerel türler tercih edilir.
### Cassandra Sorgu Optimizasyonu
Hizmet, Cassandra sorguları ı ı
1. **Bölüm Anahtarları ı
Her zaman sorgularda koleksiyonu dahil edin.
Şema tanı ı ı ı
Tam tablo taramaları ı ı
2. **Dizinleri Kullanma:**
Filtreleme için ikincil dizinleri kullanı
Mümkün olduğunda birden fazla filtreyi birleştirin.
Sorguları ı
3. **Toplu Yükleme:**
İlişki sorguları ı ı
Gidiş-dönüş sayı ı ı ı ı ı
Sonuçları ı ı
4. **Bağlantı
Kalı ı ı ı
Bağlantı ı
Hatalarda yeniden bağlanmayı
### Örnek GraphQL Sorguları
#### Basit Koleksiyon Sorgusu
```graphql
{
customers(status: "active") {
customer_id
name
email
registration_date
}
}
```
#### İlişkilere Sahip Sorgular
```graphql
{
orders(order_date_gt: "2024-01-01") {
order_id
total_amount
customer {
name
email
}
items {
product_name
quantity
price
}
}
}
```
#### Sayfalı
```graphql
{
products(limit: 20, offset: 40) {
product_id
name
price
category
}
}
```
### Uygulama Bağı ı ı ı
**Strawberry GraphQL**: GraphQL şema tanı ı
**Cassandra Driver**: Veritabanı ı ı ı ı
**TrustGraph Base**: FlowProcessor ve şema tanı ı
**Configuration System**: Şema takibi ve güncellemeleri için
### Komut Satı ı
Hizmet, aşağı ı `kg-query-objects-graphql-cassandra`
Argümanlar:
`--cassandra-host` : Cassandra kümesi iletişim noktası
`--cassandra-username` : Kimlik doğrulama kullanı ı ı
`--cassandra-password` : Kimlik doğrulama parolası
`--config-type` : Şemalar için yapı ı ı
Standart FlowProcessor argümanları ı ı ı
## API Entegrasyonu
### Pulsar Konuları
**Giriş Konusu**: `objects-graphql-query-request`
Şema: ObjectsQueryRequest
Ağ geçidi hizmetlerinden GraphQL sorguları ı
**Çı ı `objects-graphql-query-response`
Şema: ObjectsQueryResponse
Sorgu sonuçları ı ı
### Ağ Geçidi Entegrasyonu
Ağ geçidi ve ters ağ geçidi, aşağı ı ı
1. İstemcilerden GraphQL sorguları ı
2. Sorguları
3. Yanı ı
4. GraphQL introspeksiyon sorguları ı
### Aracı ı ı
Yeni bir aracı ı ı ı ı ı ı ı
Doğal dili GraphQL sorgusuna dönüştürme
Doğrudan GraphQL sorgusu yürütme
Sonuçları ı
Aracı ı ı ı
## Güvenlik Hususları
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
**Sorgu Derinliği Sı ı ı ı ı
**Sorgu Karmaşı ı ı ı ı ı ı ı ı
**Alan Düzeyi İzinleri**: Kullanı ı
**Giriş Temizleme**: Enjeksiyon saldı ı ı ı
**Hı ı ı ı ı ı ı ı ı ı ı
2026-04-11 01:08:44 +00:00
=======
**Sorgu Derinliği Sı ı ı ı ı ı
**Sorgu Karmaşı ı ı ı ı ı ı ı ı
**Alan Düzeyi İzinleri**: Kullanı ı
**Giriş Temizleme**: Enjeksiyon saldı ı ı ı
**Hı ı ı ı ı ı ı ı ı ı ı ı ı
>>>>>>> 82edf2d (New md files from RunPod)
2026-04-10 12:22:20 -04:00
## Performans Hususları
**Sorgu Planlama**: CQL oluşturmayı ı
**Sonuç Önbelleği**: Sı
**Bağlantı ı ı
**Toplu İşlemler**: Mümkün olduğunda birden fazla sorguyu birleştirme, gecikmeyi azaltma
**İzleme**: Optimizasyon için sorgu performans metriklerini izleme
## Test Stratejisi
### Birim Testleri
RowSchema tanı ı
GraphQL sorgusu ayrı ı
CQL sorgusu oluşturma mantı ı
Alan çözümleyici uygulamaları
### Sözleşme Testleri
Pulsar mesaj sözleşmesi uyumluluğu
GraphQL şema geçerliliği
Yanı ı ı
Hata yapı ı ı
### Entegrasyon Testleri
Test Cassandra örneğine karşı
Şema güncelleme işleme
İlişki çözümü
Sayfalama ve filtreleme
Hata senaryoları
### Performans Testleri
Yük altı
Çeşitli sorgu karmaşı ı ı ı
Büyük sonuç kümeleriyle bellek kullanı ı
Bağlantı
## Geçiş Planı
Bu yeni bir özellik olduğu için herhangi bir geçiş gerekli değildir. Hizmet şunları ı
1. Mevcut şemaları ı ı ı
2. Depolama modülü tarafı ı ı
3. Dağı ı ı ı
## Zaman Çizelgesi
1-2. Hafta: Temel hizmet uygulaması
3. Hafta: Sorgu yürütme ve CQL çevirisi
4. Hafta: İlişki çözümü ve optimizasyon
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
5. Hafta: Test etme ve performans ayarlaması
2026-04-11 01:08:44 +00:00
=======
5. Hafta: Test ve performans ayarlaması
>>>>>>> 82edf2d (New md files from RunPod)
2026-04-10 12:22:20 -04:00
6. Hafta: Ağ geçidi entegrasyonu ve dokümantasyon
## Açı
1. **Şema Evrimi** : Hizmet, şema geçişleri sı ı ı ı
Seçenek: Şema güncellemeleri sı ı ı ı
Seçenek: Aynı
2. **Önbellekleme Stratejisi** : Sorgu sonuçları ı ı ı
2026-04-11 01:08:44 +00:00
< < < < < < < HEAD
2026-04-10 12:22:20 -04:00
Dikkat edilmesi gerekenler: Zaman tabanlı
Dikkat edilmesi gerekenler: Olay tabanlı ı
2026-04-11 01:08:44 +00:00
=======
Dikkate alı ı ı
Dikkate alı ı ı ı
>>>>>>> 82edf2d (New md files from RunPod)
2026-04-10 12:22:20 -04:00
3. **Federasyon Desteği** : Hizmet, diğer veri kaynakları
Yapı ı ı ı ı ı
4. **Abonelik Desteği** : Hizmet, gerçek zamanlı
Ağ geçidinde WebSocket desteği gerektirir
5. **Özel Ölçekler** : Hizmet, alan adları
Örnekler: DateTime, UUID, JSON alanları
## Referanslar
Yapı ı ı ı `docs/tech-specs/structured-data.md`
Strawberry GraphQL Dokümantasyonu: https://strawberry.rocks/
GraphQL Özelliği: https://spec.graphql.org/
Apache Cassandra CQL Referansı
2026-04-10 23:20:41 -04:00
TrustGraph Akı
