2026-04-10 23:20:41 -04:00
---
layout: default
title: "Cassandra Yapı ı
parent: "Turkish (Beta)"
---
2026-04-06 14:50:34 -04:00
# Cassandra Yapı ı
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-06 14:50:34 -04:00
**Durum:** Taslak
**Yazar:** Yardı ı
**Tarih:** 2024-09-03
## Genel Bakı
Bu özellik, TrustGraph kod tabanı ı ı ı ı ı ı ı ı ı ı ı ı ı `cassandra_*` ve `graph_*` ), bu da kafa karı ı ı ı ı ı ı ı ı
## Sorun Tanı ı
Kod tabanı ı ı ı ı
1. **Bilgi/Yapı ı aşağı ı
`cassandra_host` (sunucu listesi)
`cassandra_user`
`cassandra_password`
2. **Grafik/Depolama modülleri** aşağı ı
`graph_host` (tek bir sunucu, bazen listeye dönüştürülür)
`graph_username`
`graph_password`
3. **Tutarsı ı ı ı ı :
Bazı `kg-store` ), Cassandra ayarları ı ı ı ı
Diğer işleme birimleri bunları ı
Yardı ı ı ı ı
Her iki parametre seti de aynı ı ı ı ı ı
Kullanı ı ı ı ı ı ı ı
Artan bakı
Tutarsı
Yanlı ı ı
Bazı ı ı ı ı ı ı ı ı ı ı
## Önerilen Çözüm
### 1. Parametre Adları ı ı ı
Tüm modüller, tutarlı `cassandra_*` parametre adları ı ı
`cassandra_host` - Sunucu listesi (içeride liste olarak saklanı
`cassandra_username` - Kimlik doğrulama için kullanı ı ı
`cassandra_password` - Kimlik doğrulama için parola
### 2. Komut Satı ı ı
TÜM işleme birimleri, Cassandra yapı ı ı ı ı ı ı ı ı ı ı ı
`--cassandra-host` - Virgülle ayrı ı
`--cassandra-username` - Kimlik doğrulama için kullanı ı ı
`--cassandra-password` - Kimlik doğrulama için parola
### 3. Ortam Değişkeni Geri Düşüşü
Komut satı ı ı ı ı
`CASSANDRA_HOST` - Virgülle ayrı ı
`CASSANDRA_USERNAME` - Kimlik doğrulama için kullanı ı ı
`CASSANDRA_PASSWORD` - Kimlik doğrulama için parola
### 4. Varsayı
Ne komut satı ı
`cassandra_host` , `["cassandra"]` 'e varsayı ı
`cassandra_username` , `None` 'e (kimlik doğrulama yok) varsayı ı
`cassandra_password` , `None` 'e (kimlik doğrulama yok) varsayı ı
### 5. Yardı
`--help` çı ı ı ı
Ortam değişkeni değerleri ayarlandı ı ı ı
Parola değerlerini asla göstermemelidir (bunun yerine `****` veya `<set>` göstermelidir)
Çözüm sı ı ı ı ı
Örnek yardı ı ı ı
```
--cassandra-host HOST
Cassandra host list, comma-separated (default: prod-cluster-1,prod-cluster-2)
[from CASSANDRA_HOST environment variable]
--cassandra-username USERNAME
Cassandra username (default: cassandra_user)
[from CASSANDRA_USERNAME environment variable]
--cassandra-password PASSWORD
Cassandra password (default: < set from environment > )
```
## Uygulama Detayları
### Parametre Çözümleme Sı ı
Her Cassandra parametresi için, çözümleme sı ı ı ı
1. Komut satı ı ı
2. Ortam değişkeni (`CASSANDRA_*` )
3. Varsayı
### Ana Bilgisayar Parametreleri Yönetimi
`cassandra_host` parametresi:
Komut satı ı ı ı `--cassandra-host "host1,host2,host3"`
Ortam değişkeni, virgülle ayrı ı `CASSANDRA_HOST="host1,host2,host3"`
İçeride her zaman bir liste olarak saklanı `["host1", "host2", "host3"]`
Tek bir ana bilgisayar: `"localhost"` → `["localhost"]` 'e dönüştürülür
Zaten bir liste: `["host1", "host2"]` → olduğu gibi kullanı ı
### Kimlik Doğrulama Mantı ı
Kimlik doğrulama, hem `cassandra_username` hem de `cassandra_password` sağlandı ı ı ı
```python
if cassandra_username and cassandra_password:
# Use SSL context and PlainTextAuthProvider
else:
# Connect without authentication
```
## Değiştirilecek Dosyalar
### `graph_*` parametrelerini kullanan modüller (değiştirilecek):
`trustgraph-flow/trustgraph/storage/triples/cassandra/write.py`
`trustgraph-flow/trustgraph/storage/objects/cassandra/write.py`
`trustgraph-flow/trustgraph/storage/rows/cassandra/write.py`
`trustgraph-flow/trustgraph/query/triples/cassandra/service.py`
### `cassandra_*` parametrelerini kullanan modüller (ortam değişkeni geri dönüşü ile güncellenecek):
`trustgraph-flow/trustgraph/tables/config.py`
`trustgraph-flow/trustgraph/tables/knowledge.py`
`trustgraph-flow/trustgraph/tables/library.py`
`trustgraph-flow/trustgraph/storage/knowledge/store.py`
`trustgraph-flow/trustgraph/cores/knowledge.py`
`trustgraph-flow/trustgraph/librarian/librarian.py`
`trustgraph-flow/trustgraph/librarian/service.py`
`trustgraph-flow/trustgraph/config/service/service.py`
`trustgraph-flow/trustgraph/cores/service.py`
### Güncellenecek Test Dosyaları
`tests/unit/test_cores/test_knowledge_manager.py`
`tests/unit/test_storage/test_triples_cassandra_storage.py`
`tests/unit/test_query/test_triples_cassandra_query.py`
`tests/integration/test_objects_cassandra_integration.py`
## Uygulama Stratejisi
### Aşama 1: Ortak Yapı ı ı ı ı
Tüm işlemcilerde Cassandra yapı ı ı ı ı ı ı
```python
import os
import argparse
def get_cassandra_defaults():
"""Get default values from environment variables or fallback."""
return {
'host': os.getenv('CASSANDRA_HOST', 'cassandra'),
'username': os.getenv('CASSANDRA_USERNAME'),
'password': os.getenv('CASSANDRA_PASSWORD')
}
def add_cassandra_args(parser: argparse.ArgumentParser):
"""
Add standardized Cassandra arguments to an argument parser.
Shows environment variable values in help text.
"""
defaults = get_cassandra_defaults()
# Format help text with env var indication
host_help = f"Cassandra host list, comma-separated (default: {defaults['host']})"
if 'CASSANDRA_HOST' in os.environ:
host_help += " [from CASSANDRA_HOST]"
username_help = f"Cassandra username"
if defaults['username']:
username_help += f" (default: {defaults['username']})"
if 'CASSANDRA_USERNAME' in os.environ:
username_help += " [from CASSANDRA_USERNAME]"
password_help = "Cassandra password"
if defaults['password']:
password_help += " (default: < set > )"
if 'CASSANDRA_PASSWORD' in os.environ:
password_help += " [from CASSANDRA_PASSWORD]"
parser.add_argument(
'--cassandra-host',
default=defaults['host'],
help=host_help
)
parser.add_argument(
'--cassandra-username',
default=defaults['username'],
help=username_help
)
parser.add_argument(
'--cassandra-password',
default=defaults['password'],
help=password_help
)
def resolve_cassandra_config(args) -> tuple[list[str], str|None, str|None]:
"""
Convert argparse args to Cassandra configuration.
Returns:
tuple: (hosts_list, username, password)
"""
# Convert host string to list
if isinstance(args.cassandra_host, str):
hosts = [h.strip() for h in args.cassandra_host.split(',')]
else:
hosts = args.cassandra_host
return hosts, args.cassandra_username, args.cassandra_password
```
### 2. Aşama: `graph_*` Parametrelerini Kullanan Modülleri Güncelleme
1. Parametre adları ı `graph_*` 'dan `cassandra_*` 'e değiştirin.
2. Özel `add_args()` yöntemlerini standart `add_cassandra_args()` yöntemleriyle değiştirin.
3. Ortak yapı ı ı ı ı ı ı
4. Dokümantasyon metinlerini güncelleyin.
Örnek dönüşüm:
```python
# OLD CODE
@staticmethod
def add_args(parser):
parser.add_argument(
'-g', '--graph-host',
default="localhost",
help=f'Graph host (default: localhost)'
)
parser.add_argument(
'--graph-username',
default=None,
help=f'Cassandra username'
)
# NEW CODE
@staticmethod
def add_args(parser):
FlowProcessor.add_args(parser)
add_cassandra_args(parser) # Use standard helper
```
### 3. Aşama: `cassandra_*` Parametrelerini Kullanarak Modülleri Güncelleme
1. Eksik olan yerlerde komut satı ı ı `kg-store` )
2. Mevcut argüman tanı ı ı `add_cassandra_args()` ile değiştirin
3. Tutarlı `resolve_cassandra_config()` 'ı ı
4. Tutarlı ı
### 4. Aşama: Testleri ve Belgeleri Güncelleme
1. Tüm test dosyaları ı ı ı
2. Komut satı ı
3. API belgelerini güncelleyin
4. Ortam değişkeni belgelerini ekleyin
## Geriye Dönük Uyumluluk
Geçiş sı ı
1. `graph_*` parametreleri için **kullanı ı ı ı
2. **Parametre takma adları - başlangı ı
3. **Aşamalı ı ı birden fazla sürümde
4. **Belge güncellemeleri** ve geçiş kı
Örnek geriye dönük uyumluluk kodu:
```python
def __init__ (self, **params):
# Handle deprecated graph_* parameters
if 'graph_host' in params:
warnings.warn("graph_host is deprecated, use cassandra_host", DeprecationWarning)
params.setdefault('cassandra_host', params.pop('graph_host'))
if 'graph_username' in params:
warnings.warn("graph_username is deprecated, use cassandra_username", DeprecationWarning)
params.setdefault('cassandra_username', params.pop('graph_username'))
# ... continue with standard resolution
```
## Test Stratejisi
1. **Birim testleri** , yapı ı ı ı
2. **Entegrasyon testleri** , çeşitli yapı ı ı
3. **Ortam değişkeni testleri**
4. **Geriye dönük uyumluluk testleri** , kullanı ı ı ı
5. **Docker compose testleri** , ortam değişkenleriyle
## Dokümantasyon Güncellemeleri
1. Tüm CLI komutu dokümantasyonunu güncelleyin
2. API dokümantasyonunu güncelleyin
3. Geçiş kı
4. Docker compose örneklerini güncelleyin
5. Yapı ı
## Riskler ve Azaltma
| Risk | Etki | Azaltma |
|------|--------|------------|
| Kullanı ı ı
| Geçiş sı ı ı ı ı ı ı ı ı ı ı ı ı
| Test hataları ı
| Docker dağı ı ı
## Başarı
[ ] Tüm modüller, tutarlı `cassandra_*` parametre adları ı ı
[ ] Tüm işlemciler, Cassandra ayarları ı ı ı ı ı ı ı
[ ] Komut satı ı ı ı ı ı
[ ] Parola değerleri, yardı
[ ] Ortam değişkeni yedeklemesi doğru şekilde çalı ı
[ ] `cassandra_host` , dahili olarak tutarlı
[ ] Geriye dönüştürülebilirlik, en az 2 sürüm için korunur
[ ] Tüm testler, yeni yapı ı
[ ] Dokümantasyon tamamen güncellenmiştir
[ ] Docker compose örnekleri, ortam değişkenleriyle çalı ı
## Zaman Çizelgesi
**1. Hafta:** Ortak yapı ı ı ı ı ı ı `graph_*` modüllerini güncelleyin
**2. Hafta:** Mevcut `cassandra_*` modüllerine ortam değişkeni desteği ekleyin
**3. Hafta:** Testleri ve dokümantasyonu güncelleyin
**4. Hafta:** Entegrasyon testi ve hata düzeltmeleri
## Gelecek Hususlar
Bu kalı ı ı ı ı ı
Yapı ı ı ı
Cassandra bağlantı ı ı ı
2026-04-10 23:20:41 -04:00
Yapı ı ı ı
