Global Variables

Global Variables, Pirivision'da Compass sorgu editöründe ${değişken_adi} yazarak referans alınan kullanıcı tanımlı sabit değerlerdir. Sorgu çalıştırıldığında veya Horizon / Atlas dashboard'unda filtre tetiklendiğinde backend bu yer tutucuyu kayıtlı değerle otomatik olarak değiştirir.

Erişim

Sol menüden Settings simgesine tıklayın → açılan diyalogda Global Variables sekmesini seçin.

Ne İşe Yarar?

Birden fazla sorguda tekrar eden değerleri (tesis adı, makine ID'si, varsayılan tarih aralığı vb.) tek noktadan yönetmenizi sağlar. Değer değiştiğinde tüm ilgili sorguları tek tek düzenlemenize gerek kalmaz; yalnızca Global Variables'ta güncelleme yapmanız yeterlidir.

UI Alan Referansı

Alan	Açıklama	Zorunlu
Name	Sorguda `${...}` içinde kullanılan teknik anahtar. Boşluk içeremez; önerilen format: `snake_case`.	Evet
Value	Bu değişkenin yerine geçecek gerçek değer. Metin, sayı veya tarih olabilir.	Evet

`${değişken}` Kullanım Örnekleri

Global Variables aşağıdaki tüm sorgu tiplerinde çalışır:

PostgreSQL

SELECT ts, value
FROM sensor_readings
WHERE plant_code = '${plant_code}'
  AND ts >= NOW() - INTERVAL '${lookback_days} days'
ORDER BY ts DESC;

MSSQL (T-SQL)

SELECT TOP 500
    RecordTime,
    TagValue
FROM dbo.TagHistory
WHERE TagName = '${tag_name}'
  AND RecordTime >= DATEADD(HOUR, -${hour_range}, GETDATE());

MySQL

SELECT DATE_FORMAT(ts, '%Y-%m-%d %H:%i') AS period, AVG(value) AS avg_val
FROM measurements
WHERE machine_id = '${machine_id}'
GROUP BY period
ORDER BY period;

MQTT (Topic Filtresi)

factory/${plant_id}/line/+/temperature

REST API (URL Parametresi)

/api/v1/sensors?plant=${plant_code}&limit=${page_size}

Değişken Ekleme

Settings → Global Variables sekmesini açın.
Sağ üstteki + butonuna tıklayın.
Name alanına teknik anahtar girin (örn. plant_code).
Value alanına gerçek değeri girin (örn. IST-01).
Save butonuna tıklayın.

Değişken listeye eklenir ve artık tüm sorgularda kullanılabilir.

Değişken Düzenleme

Listede düzenlemek istediğiniz satırın üzerine gelin.
Satır sonunda beliren kalem (Edit) ikonuna tıklayın.
Name veya Value alanını güncelleyin.
Save butonuna tıklayın.

Ad Değişikliği

Name alanını değiştirirseniz bu değişkeni kullanan tüm sorgulardaki ${eski_ad} referansları artık eşleşmez. Sorguları manuel olarak güncellemeniz gerekir.

Değişken Silme

Silmek istediğiniz satırın sonundaki çöp kutusu (Delete) ikonuna tıklayın.
Onay isteği gelirse Onayla'ya tıklayın.

Geri Alma Yok

Silinen değişken geri getirilemez. Bu değişkene bağlı sorgular çalışmaya devam eder ancak ${değişken_adi} yer tutucusu boş veya hatalı olarak değerlendirilir.

Sınırlamalar ve Notlar

Konu	Açıklama
Kapsam	Değişkenler kullanıcı bazındadır; başka kullanıcıların tanımladığı değişkenler görünmez.
Tip desteği	Tüm değerler metin olarak saklanır; sorgu içinde gerekiyorsa tür dönüşümü (örn. `::integer`, `CAST`) yapmanız gerekir.
Büyük/küçük harf	`${plant_code}` ile `${Plant_Code}` farklı değişkenlerdir.
Boşluk	Name alanında boşluk kullanmayın; yerine alt çizgi (`_`) tercih edin.
Sorgu kayıt ekranı	Compass'ta sorgu kaydedilirken `{{parametre}}` olarak tanımlanan inline parametreler Global Variables'tan ayrıdır — bunlar dashboard filtresi olarak çalışır.

Sonraki Adım

→ My Color Palettes → Tags → Compass — Sorgu Oluşturma