---
title: "AgensGraph 2.18 PostgreSQL 18.6 tabanına geçti, GQL desteği geldi"
description: "AgensGraph 2.18 PostgreSQL 18.6 tabanına geçti; Cypher yazmaları artık row-level security uyguluyor, 2.17'den geçiş pg_upgrade istiyor."
url: "https://sezer.in/haberler/agensgraph-2-18-postgresql-18-gql/"
date: "2026-11-07T18:46:16+03:00"
updated: "2026-11-07T18:46:16+03:00"
author: "Sezer Şanlıkan"
lang: "tr"
source: "https://sezer.in/haberler/agensgraph-2-18-postgresql-18-gql/"
---

# AgensGraph 2.18 PostgreSQL 18.6 tabanına geçti, GQL desteği geldi

AgensGraph 2.18 serisinin son sürümü v2.18.6.1 yayımlandı ve proje PostgreSQL 18.6 tabanına geçti. Sürüm, openCypher'ın yanına ISO GQL standardından ilk clause setini ekliyor. Variable-length traversal'lar artık her hop'ta edge label index'ini kullanıyor.

## Kısaca AgensGraph nedir

AgensGraph, PostgreSQL üzerine kurulu açık kaynak bir multi-model graph veritabanıdır. İlişkisel tablolarla graph verisini aynı veritabanında tutar ve SQL ile openCypher sorgularını aynı transaction içinde çalıştırır. Sosyal ağ analizi ve knowledge graph gibi ilişki ağırlıklı iş yüklerinde kullanılır. Alternatifleri arasında Neo4j ve PostgreSQL eklentisi Apache AGE var.

## Önce row-level security

AgensGraph 2.18 sürümünde yükseltme kararını hızlandıracak madde güvenlik notu. Duyuruya göre Cypher ile yapılan yazmalar artık RLS (Row-Level Security) politikalarına uyuyor. Fixed-length pattern'ler de adını vermeden eşleştikleri label'larda RLS ve yetkileri denetliyor.

"Artık" ifadesi, 2.17'de bu yollardan politikaların atlanabildiğini düşündürüyor. Kiracı ayrımını RLS ile yapıyorsanız 2.17 üzerinde Cypher erişimi olan kullanıcıları gözden geçirin. AgensGraph geliştiricileri bunu güvenlik açığı olarak duyurmadı ve CVE numarası vermedi.

## Traversal'da index her hop'ta devrede

2.17, variable-length traversal sırasında her hop'ta edge label'ın tamamını tarıyordu. 2.18 her adımda label'ın index'ini kullanıyor. Ekibin kendi testinde 30 milyon edge'lik soc-Pokec graph'ında iki hop'luk sorgu 2.17'de 20 saniyede bitmiyordu, 2.18'de milisaniyeler içinde dönüyor.

Bu yüzden statement timeout'u yükseltilmiş uygulamalarınız varsa yükseltmeden sonra o değerleri yeniden ayarlayın. Typed property column'lar başka bir kazanım getiriyor: sık filtrelenen property'yi native kolon olarak tutup sıradan bir PostgreSQL index'iyle aratabiliyorsunuz.

## GQL clause'ları openCypher'ın yanında

AgensGraph 2.18, ISO/IEC 39075 standardındaki GQL'den LET, FOR, FILTER, NEXT, FINISH ve INSERT clause'larını ekliyor. ORDER BY, OFFSET ve LIMIT bağımsız clause olarak da yazılabiliyor. OpenCypher desteği yerinde kaldığı için elinizdeki sorguları yeniden yazmanız gerekmiyor.

Geliştiriciler GQL uyumu üzerindeki çalışmanın sonraki release'lerde süreceğini söylüyor. Yeni sorgularda GQL söz dizimini seçmek ileride başka bir GQL motoruna geçişi kolaylaştırabilir. Henüz gelmeyen clause'ları yazmaya başlamadan release notlarından kontrol edin.

## AgensGraph 2.18'e yükseltme sırası

2.17 data dizini 2.18 ile doğrudan açılmıyor. Seçenekler pg_upgrade veya 2.18'in pg_dump aracıyla alınan dump'ı geri yüklemek. 2.18.6.0 kullanıyorsanız binary'leri değiştirip yeniden başlatmanız yetiyor.

- Sunucunun hangi sürümde olduğunu doğrulayın.
- 2.17'den geliyorsanız tam yedek alın ve 2.17'den bu yana değişenler sayfasını okuyun.
- Test ortamında RLS'ye dayanan Cypher yazmalarını çalıştırın; artık reddedilen yazmalar uygulamada hata olarak dönebilir.

```
SELECT version();
```

Docker image kullanıyorsanız 2.17 tag'ini 2.18 ile değiştirmekle iş bitmiyor. Volume içindeki data dizini yine pg_upgrade veya dump ile restore istiyor.

## Python driver ve GraphRAG paketleri

Agensgraph-python 2.1, psycopg 3 üzerine yeniden kuruldu. Senkron ve asenkron kodla çalışıyor, sonuçları pandas, Polars veya Arrow'a doğrudan aktarıyor. Major sürüm atlaması eski driver'a bağlı script'lerde uyumsuzluk çıkarabilir. Geçişi kendi branch'inde yapın ve eski sürümü pin'leyin.

Agensgraph-ai paketi LangChain, LlamaIndex, LightRAG ve cognee entegrasyonlarının yanında MCP server'ları getiriyor. Pgvector'ü ayrıca kurarsanız graph traversal ile vector similarity aramasını tek sorguda birleştirebiliyorsunuz. MCP server'ını bir yapay zekâ asistanına bağlayacaksanız ona yalnız kısıtlı yetkisi olan bir veritabanı kullanıcısı açın. RLS düzeltmesi tam bu senaryoda devreye giriyor.