InfluxDB Veri Kaynağı

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

Liste projeye göre süzülür; sütunlarda ad, açıklama, adres, kullanıcı adı ve veritabanı görünür. Üstteki araç çubuğunda yenile, sil, düzenle, ekle, çoğalt ve süzgeç düğmeleri vardır.

Platformun kendi tarihçesiyle karıştırmayın

Burada tanımlanan kaynak sizin bir veritabanınızdır. Platformun kendi tarihçe deposu ayrı yapılandırılır; bu ekrandaki kayıtlar onu etkilemez.

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	Sunucunun HTTP adresi (en çok 2048 karakter)
Username	Kullanıcı adı (en çok 50 karakter)
Password	Parola (en çok 50 karakter)
Database	Bu kaynak üzerinden çalışan sorguların varsayılan veritabanı (en çok 50 karakter)
Is Default	Bu kaynağın projenin varsayılan kaynağı olup olmadığı

Database, bağlantı kurulurken istemciye verilir; yani bu kaynak üzerinden çalışan bir sorgu veritabanı adını yazmak zorunda kalmaz. SQL veri kaynağında böyle bir alan yoktur — orada veritabanı JDBC adresinin içindedir.

Kullanıcı adı ve parola isteğe bağlıdır

Kimlik doğrulama, kullanıcı adı ve parolanın ikisi birden dolu olduğunda gönderilir. Biri boşsa bağlantı kimliksiz kurulur. Kimlik doğrulaması kapalı bir sunucuda bu alanlar boş bırakılır.

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.runInfluxQL('SELECT ...');                  // varsayılan kaynak
ins.runInfluxQL('SayacDB', '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. Link-local adresin her koşulda kapalı olması, bulut sağlayıcıların örnek meta veri servislerini hedef dışı bırakır.

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 (okuma)	60 saniye	Bir sorgunun alabileceği süre
Yazma	10 saniye	İstek gövdesinin gönderilmesi

Yazma zaman aşımı yalnızca InfluxDB için geçerlidir; SQL tarafında karşılığı yoktur.

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ı yeniden kullanılır

Her veri kaynağı için bir istemci açılır ve sonraki sorgularda yeniden kullanılır. Kaydı düzenlediğinizde ya da sildiğinizde açık istemci 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

• InfluxDB Sorgu — kayıtlı sorgular ve editör
• SQL Veri Kaynağı — ilişkisel veritabanı karşılığı
• Script Engine — ins.runInfluxQL ve diğer veri kaynağı metotları