SQL Sorguları (SQL Queries)

Genel Bakış

SQL Queries (SQL Sorguları) modülü, DataFloem platformu üzerinde kayıtlı veri kataloglarına (Catalogs), veri tabanlarına, şemalara (Namespaces) ve tablolara doğrudan SQL cümleleri yazarak etkileşimli veri analizi, sorgulama ve veri inceleme yapmanızı sağlayan web tabanlı bir SQL editörüdür.

Bu modül sayesinde kullanıcılar:

Farklı veri kaynaklarına bağlı kataloglar üzerinde ad-hoc (anlık) SQL sorguları çalıştırabilir.
Sık kullanılan sorguları kaydedebilir (Saved Queries) ve sekmeli yapıda çoklu sorgular üzerinde çalışabilir.
Sorguları çalıştırmak için uygun Execution Engine / Cluster seçimini yapabilir.
Geçmiş sorgu çalışma loglarını (Recent) ve dönen sonuçları veya hata mesajlarını (Query Results) inceleyebilir.

Erişim ve Arayüz Bileşenleri

SQL Queries arabirimi 4 ana bölümden oluşmaktadır:

Sol Navigasyon Paneli (Saved Queries & Catalogs)
Üst Sekme ve Araç Çubuğu (Tabs & Toolbar)
SQL Kod Editörü (Code Editor)
Sonuç ve Geçmiş Paneli (Recent & Query Results)

1. Sol Navigasyon Paneli

Saved Queries (Kaydedilen Sorgular)

Daha önce oluşturulup kaydedilmiş olan SQL sorgularının listelendiği alandır.

Liste üzerindeki herhangi bir sorguya tıklayarak editörde yeni bir sekmede açabilirsiniz.
Sorgu satırının sağındaki üç nokta (...) aksiyon menüsünü kullanarak kaydedilmiş sorguları yeniden adlandırabilir veya silebilirsiniz.

Catalogs (Katalog ve Veri Yapısı Ağacı)

Sistemde tanımlı tüm veri kaynaklarını, şemaları/namespace'leri ve tabloları hiyerarşik bir ağaç yapısında sunar.

Search catalogs...: Kataloglar, şemalar veya tablolar arasında hızlı arama yapmanızı sağlar.
Hiyerarşi Yapısı: Katalog (ör. Catalog1) ➔ Şema/Namespace (ör. Namespace1) ➔ Tablo (ör. Table1).
Open in Editor (Editörde Aç): Bir tablonun yanındaki aksiyon butonuna (...) tıklandığında açılan "Open in editor" seçeneği, seçili tabloya ait hazır SELECT * FROM catalog.schema.table sorgusunu otomatik oluşturarak editörde yeni sekmede açar.

Ekranın sağ üst köşesinde yer alan araç çubuğu, sorgu sekmelerini ve çalıştırma ortamlarını yönetir:

Simge / Buton	İşlev / Açıklama
`+` (New SQL tab)	Yeni bir boş SQL sorgu sekmesi açar. Aynı anda birden fazla sorgu sekmesiyle çalışabilirsiniz.
💾 (Save / Save All)	Aktif sekmedeki sorguyu kaydeder (`Cmd + S` / `Ctrl + S`). Yanındaki aşağı ok simgesine tıklandığında veya klavye kısayolu ile (`Cmd + Shift + S` / `Ctrl + Shift + S`) açık olan tüm sekmeleri tek tıkla kaydetmenize olanak tanır.
`∨` (Engine Selector)	Sorgunun çalıştırılacağı bilgi işlem motorunu/kümesini (Cluster/Engine) seçmenizi sağlar (ör. `DFL-6413`, `jdbc-cluster`, `engine-v2`). Her motorun anlık çalışma durumu (`Idle`, `Running` vb.) ve türü (`Dynamic`) bu menüde listelenir.
▶ (Run)	Yazılan SQL sorgusunu seçili çalışma motoru üzerinde yürütür.
🟥 (Stop)	Çalışmakta olan sorgunun yürütülmesini anında durdurur/iptal eder.

Klavye Kısayolları (Keyboard Shortcuts)

Kod editöründe hızlı kaydetme işlemleri için aşağıdaki klavye kısayolları kullanılabilir:

Kısayol	İşlev / Açıklama
`Cmd + S` / `Ctrl + S`	Aktif olan sorgu sekmesini kaydeder.
`Cmd + Shift + S` / `Ctrl + Shift + S`	Açık olan tüm sorgu sekmelerini tek seferde kaydeder.

3. SQL Kod Editörü

Ana çalışma alanında yer alan siyah temalı kod editörü; SQL sözdizimi vurgulama (syntax highlighting), otomatik tamamlama ve çoklu satır kod yazma desteği sunar.

Sorgularda katalog, şema ve tablo isimleri tam adresiyle (Fully Qualified Name) kullanılır:

SELECT * FROM dfl.new_namespace.z_postgre_struct LIMIT 100;

4. Sonuç ve Geçmiş Paneli (Bottom Panel)

Editörün alt tarafında yer alan panel, sorgu çalıştırma çıktılarını ve geçmişini iki ana sekmede gösterir:

Recent (Geçmiş Sorgular)

Sol tarafta çalıştırılan son sorguların geçmişi listelenir:

Sorgu metninin kısa özeti, çalıştırma tarihi/saati ve durumu gösterilir.
Status İndikatörleri:
- Failed (Kırmızı): Sorgu çalışırken hata aldığını belirtir.
- Success (Yeşil): Sorgunun başarıyla tamamlandığını belirtir.

Query Results (Sorgu Sonuçları)

Sağ tarafta aktif sorgunun yürütme sonuçları görüntülenir:

Başarılı Çalıştırma: Sorgudan dönen veriler tablo formatında gösterilir, veriler filtrelenebilir veya dışa aktarılabilir.
Hata Durumu: Sorgu veya katalog bağlantı hatası alındığında (ör. HTTP 406, Catalog request error, Syntax error), hatanın gRPC/HTTP status kodları ve detaylı hata iletisi (payload) bu alanda raporlanır.

Temel Kullanım Adımları

Yeni Sorgu Başlatma: Üst araç çubuğundaki + butonuna tıklayarak yeni bir SQL sekmesi açın veya sol paneldeki Catalogs ağacından bir tablonun yanındaki Open in editor seçeneğini kullanın.
Motor (Engine) Seçimi: Çalıştırma butonunun solundaki açılır menüden sorguyu koşturmak istediğiniz aktif motoru (Engine/Cluster) seçin.
Sorguyu Yazma ve Çalıştırma: SQL kodunuzu yazdıktan sonra yeşil Run (▶) butonuna basarak sorguyu çalıştırın.
Sonuçları İnceleme: Çalıştırma tamamlandığında alt paneldeki Query Results sekmesinden dönen veri tablosunu veya oluşan hata mesajlarını kontrol edin.
Sorguyu Kaydetme: Sorgunuzu kaydetmek için Cmd + S (Ctrl + S) kısayolunu veya Save (Disket) butonunu kullanın. Tüm sekmeleri kaydetmek için Cmd + Shift + S (Ctrl + Shift + S) kullanabilirsiniz.

Notlar ve İpuçları

Sorguları kaydetmek için fare kullanmadan Command + S (Aktif sekme) ve Command + Shift + S (Tüm sekmeler) kısayollarını tercih edebilirsiniz.
Büyük boyutlu tablolarda sorgu çalıştırırken sistem performansını korumak için LIMIT ifadesi kullanılması önerilir.
Çalışma motorunun status değeri Idle olduğunda motor hazırdır; sorgu gönderildiğinde otomatik olarak görevi işler.
Katalog erişim hatası (Status(StatusCode="Internal")...) alındığında ilgili veri kaynağı bağlantısının (Source / Target) veya katalog servisinin aktifliğini kontrol edin.