SQL Veri Kaynağı

SQL veri kaynağı, platformun dışındaki bir veritabanına bağlantı tanımıdır. Tanımlandıktan sonra script’ler, raporlar ve kayıtlı sorgular ona adıyla erişir.

Alanlar

Alan	Açıklama
Name	Veri kaynağının adı; script ve sorgular bu adla çağırır (en çok 100 karakter)
Description	Açıklama (en çok 255 karakter)
URL	JDBC bağlantı adresi (en çok 2048 karakter)
Username	Kullanıcı adı (en çok 50 karakter)
Password	Parola (en çok 50 karakter)
Is Default	Bu kaynağın projenin varsayılan kaynağı olup olmadığı

Parola geri gösterilmez

Listede parolanın kendisi değil, ayarlı olup olmadığı görünür. Şifreli saklanır ve okunmak üzere geri verilmez. Düzenlerken parola alanı boş gelir: boş bıraktığınızda mevcut parola korunur, yalnızca yeni bir parola yazdığınızda değişir.

Şifreleme anahtarı kaybolursa parola da gider

Bu parola, kurulumun öznitelik şifreleme anahtarıyla korunur. Geri yükleme sırasında o anahtar kaybolursa parola çözülemez ve elle yeniden girilmesi gerekir — hiçbir zaman açık metin olarak saklanmadığı için kurtarılacak bir şey yoktur. Ayrıntı: Yedekleme.

Varsayılan kaynak

Is Default işaretli kaynak, adı yazılmadan çalıştırılan sorguların gittiği yerdir:

ins.runSql('SELECT ...');                    // varsayılan veri kaynağı
ins.runSql('UretimDB', 'SELECT ...');        // ada göre

Bir projede yalnızca bir kaynağı varsayılan işaretleyin. İkincisini işaretlemek birincinin işaretini kaldırmaz ve kaynak adı yazılmayan çağrı hangisine gideceğini belirleyemez. Araç çubuğundaki çoğalt düğmesi Is Default dahil tüm alanları kopyaladığı için bu duruma en kolay buradan düşülür: çoğalttıktan sonra kopyanın işaretini kaldırın.

İzinli adresler

Veri kaynağı adresleri bir izin listesine tabidir. Liste ins.datasource.allowed-hosts ile verilir; virgülle ayrılmış ana makine adları (veritabani.ornek.com), joker alt alan adları (*.ornek.com) ve CIDR blokları (10.0.0.0/8) kabul edilir.

Durum	Sonuç
Liste boş (varsayılan)	Hiçbir adrese izin verilmez
Adres listede	İzin verilir
Adres listede değil	Reddedilir
Loopback, 0.0.0.0 veya link-local adres	Liste ne derse desin reddedilir

Bu, kurulumun bilerek böyle bırakılmış bir davranışıdır: ayar yapılmadan hiçbir veri kaynağı çalışmaz, çünkü aksi hâlde bir script’in sunucunun ulaşabildiği her adrese sorgu göndermesinin önü açık olurdu.

JDBC adresinden ana makine adı çıkarılırken kullanıcı bilgisi, yol ve SQL Server’ın noktalı virgüllü parametreleri atılır. Yüksek erişilebilirlik için birden çok makine yazılmış bir PostgreSQL adresinde hepsinin listede olması gerekir. Oracle TNS biçimi (// içermeyen adres) desteklenmez; bu biçimde bir adres kaydedilemez.

Adres iki yerde denetlenir: kaydederken (hatalı adres formda hata olarak döner) ve sorgu çalışırken.

Zaman aşımları

Sınır	Varsayılan	Nereye uygulanır
Bağlanma	10 saniye	Ayakta olmayan kaynak hızlı hata verir
Sorgu	60 saniye	Bir sorgunun alabileceği süre

Script süresinin içindedirler

Bu sınırlar script çalışma süresinin içinde sayılır ve bu bilinçlidir: cevap vermeyen bir kaynak, script’i öldüren bir zaman aşımı olarak değil veri kaynağı hatası olarak görünür — böylece günlükte sebebi okunur. Sorgu süresini yükseltirseniz script sınırının altında tutun, yoksa bu ayrım kaybolur.

Bağlantı havuzu yeniden kullanılır

Her veri kaynağı için bir bağlantı havuzu açılır ve sonraki sorgularda yeniden kullanılır. Kaydı düzenlediğinizde ya da sildiğinizde havuz kapatılıp bırakılır; yeni adres veya parola bir sonraki sorguda kendiliğinden geçerli olur. Yeniden başlatmaya gerek yoktur.

İlgili

• SQL Sorgu — kayıtlı sorgular
• SQL Veritabanı — şemayı gezme ve sorgu çalıştırma
• InfluxDB Veri Kaynağı — zaman serisi karşılığı
• Script Engine — ins.runSql kullanımı