SQL Sorgu

SQL sorgu, bir kez yazıp adıyla sakladığınız sorgudur. Aynı sorgunun birkaç script ve raporda tekrarlanması yerine tek yerde durur; değiştiğinde hepsi birden güncel olur.

SQL Sorgu ekranı — üstte liste, altta editör ve sonuç paneli

Ekran iki bölümdür. Üstte kayıtlı sorguların listesi vardır; sütunlarda proje, ad, açıklama ve kaydı kimin ne zaman oluşturup güncellediği görünür. Altta SQL Editor ve yanında SQL Result paneli durur.

Alanlar

Alan	Açıklama
Name	Sorgunun adı; script’ten bu adla çağrılır
Description	Açıklama
Query	SQL metni, en çok 32.767 karakter

Sorgu metni, saklanan diğer çalıştırılabilir içerik gibi bir bütünlük damgası taşır.

Editör ve sonuç

Listeden bir sorgu seçtiğinizde metni editöre gelir. Editörün solundaki açılır listeden sorgunun hangi veri kaynağında çalışacağı seçilir; sağdaki düğmeler arama, biçimlendirme, çalıştırma ve kaydetmedir. Sonuç sağdaki panelde görünür.

Buradaki çalıştırma bir deneme değildir: sorgu gerçekten seçili kaynakta koşar. Çalıştırmak için RUN_QUERY yetkisi gerekir.

Script’ten kullanma

Kayıtlı bir sorgunun metnini almak için:

var sql = ins.getCustomSqlQuery('GunlukUretim');
var res = ins.runSql(sql);                   // varsayılan veri kaynağı
var res2 = ins.runSql('UretimDB', sql);      // belirli bir kaynak

Çağrı sorgunun metnini döndürür, sonucunu değil; hangi veri kaynağında çalışacağına siz karar verirsiniz. Aynı sorguyu birden çok kaynakta (örneğin test ve üretim) çalıştırmak bu sayede mümkündür.

Sonucun yapısı

Dönen değer satırların kendisi değil, bir sonuç kümesidir. Tek ifadelik bir sorguda tek sonuç vardır; arka arkaya birkaç ifade çalıştıran bir sorguda her ifade için bir sonuç gelir.

var res = ins.runSql('SELECT id, name FROM product');

res.getSize();                  // sonuç sayısı
var first = res.getResult(0);
first.getType();                // "list" ya da "scalar"
var rows = first.getRows();     // satırlar: sütun adıyla anahtarlanmış nesneler
rows[0].name;

Satır döndüren bir ifade list tipinde gelir ve getRows() ile okunur; satır döndürmeyen bir ifade (INSERT, UPDATE, DELETE) scalar tipindedir ve getResult() ile etkilenen satır sayısını verir.

Bütünlük damgası

Metin script’e verilmeden önce damgasıyla karşılaştırılır. Kurulumun bütünlük kipi:

Kip	Davranış
`OFF`	Denetim yapılmaz
`WARN`	Uyuşmazlık proje günlüğüne yazılır, metin yine de verilir
`ENFORCE`	Hata verilir, script metni hiç görmez

Denetim script’e verilirken yapılır, kayıt okunurken değil. Bu bilinçlidir: damgası tutmayan bir sorgu bu ekranda görünmeye devam eder, böylece ne olduğunu görüp düzeltebilirsiniz — ENFORCE kipinde bile kaydı onaracak ekran elinizden alınmaz.

İlgili

SQL Veri Kaynağı — bağlantı tanımı
SQL Veritabanı — sorguyu yazarken şemayı gezme
InfluxDB Sorgu — zaman serisi karşılığı
Script Engine — ins.runSql ve diğer veri kaynağı metotları