MQTT Veri Kaynağı Düzenleme
Bu sayfa, Pirivision Port modülünde daha önce eklenmiş bir MQTT veri kaynağının Edit aksiyonuyla güncellenmesini anlatır.
MQTT broker adresi veya portu değiştiğinde, protokol güncellendiğinde (örn. ws'ten tcp'ye), kimlik bilgileri değiştiğinde veya veri kaynağı farklı bir klasöre taşınmak istendiğinde bu akış kullanılır.
Ön Koşul
Port listesinde en az bir MQTT veri kaynağı kayıtlı olmalıdır. Henüz eklenmemişse önce MQTT Veri Kaynağı Ekleme sayfasına bakın.
1. Port Listesinde Veri Kaynağını Bulun
Sol menüden Port modülüne tıklayın. Düzenlemek istediğiniz MQTT veri kaynağını listede bulun.
Listede arama çubuğunu kullanarak veri kaynağı adını veya #etiket ile filtreleme yapabilirsiniz.
2. Edit Butonuna Tıklayın
Veri kaynağı kartının sağ tarafında Edit butonu (kalem ikonu) yer alır.
Edit butonuna tıklayın.
Tip
Kart üzerinde doğrudan Edit butonu görünür. More menüsünden erişim gerekmez.
3. Düzenleme Formu Açılır
Edit tıklandığında form, mevcut değerler önceden dolu şekilde açılır. Bu, yeni MQTT veri kaynağı ekleme formuyla aynı ekrandır; fark yalnızca alanlardaki değerlerin dolu gelmesi ve altta Update butonunun bulunmasıdır.
4. Değiştirilebilen Alanlar
Aşağıdaki alanlar düzenlenebilir:
| Bölüm | Alan | Zorunlu | Varsayılan | Açıklama |
|---|---|---|---|---|
| Display Info | Name | Evet | — | Veri kaynağının Pirivision içindeki görünen adı |
| Display Info | Description | Hayır | — | Kısa açıklama metni |
| Connection Settings | Protocol | Evet | ws |
Bağlantı protokolü (ws, wss, tcp, ssl) |
| Connection Settings | Host | Evet | — | MQTT broker'ın IP adresi veya hostname'i |
| Connection Settings | Port | Evet | 8083 |
Broker'ın dinlediği port numarası |
| Connection Settings | Path | Hayır | /mqtt |
WebSocket yolu (ws/wss için) |
| Connection Settings | Keep Alive Time | Evet | 60 |
Bağlantı canlılık ping aralığı (saniye) |
| Authentication | Username | Hayır | — | MQTT broker kullanıcı adı |
| Authentication | Password | Hayır | — | Broker kimlik doğrulama şifresi |
| Location | Target Folder | Hayır | — | Veri kaynağının Port klasör yapısındaki konumu |
Değiştirilemeyen Alan
| Alan | Durum |
|---|---|
| Veri kaynağı tipi | MQTT olarak sabit kalır; SQL veya REST API türlerine dönüştürülemez. |
5. Update Butonu
Tüm alanlar güncellendikten sonra sağ alttaki Update butonuna tıklayın.
Bağlantı Testi Yapılmaz
MQTT veri kaynağı düzenlemesinde SQL veri kaynaklarının aksine anlık bir bağlantı testi yapılmaz. Update butonu doğrudan kaydeder. Bağlantı durumu Compass modülünde topic bazında doğrulanabilir.
Formun alt kısmında şu bilgi görünür:
Success
Update işlemi tamamlandığında güncellenen MQTT bağlantı parametreleri kaydedilir. Compass'ta bu veri kaynağını kullanan topic sorgularının hâlâ erişilebilir olduğunu doğrulayın.
Failure
Güncelleme sonrasında broker'a bağlanılamıyorsa Host, Port, Protocol ve kimlik bilgilerini kontrol edin.
6. Sık Karşılaşılan Hatalar
| Hata / Belirti | Olası Neden | Çözüm |
|---|---|---|
a datasource with this name already exists, please choose a different name |
Aynı isimde başka bir veri kaynağı mevcut | Farklı bir Name değeri girin |
you do not have permission to update this datasource or the datasource was not found |
Veri kaynağı başka bir kullanıcıya ait veya silinmiş | Port listesini yenileyin |
user not found |
Oturum süresi dolmuş | Yeniden giriş yapın |
| Kaydedildi ama broker'a bağlanılamıyor | Host/Port/Protocol yanlış güncellendi | Compass'ta topic sorgusuyla bağlantıyı test edin |
| WebSocket bağlantısı kurulamıyor | Protocol veya Path yanlış | ws/wss seçiminde Path'in /mqtt olduğunu kontrol edin |
| Kimlik doğrulama başarısız | Username/Password güncellendi ancak broker kabul etmiyor | Broker tarafındaki kimlik bilgilerini doğrulayın |
7. Sonraki Adım
MQTT veri kaynağı güncellendikten sonra Compass'ta bu kaynağa bağlı topic sorgularının çalıştığını doğrulayın.
flowchart LR
A["Port<br/>MQTT Düzenlendi"] --> B["Compass<br/>Topic Sorgu Doğrulama"]
B --> C["Cartography<br/>Chart / KPI (değişiklik yok)"]Özet
MQTT veri kaynağı düzenleme süreci:
- Port modülüne girilir.
- Listede MQTT veri kaynağı bulunur.
- Kart üzerindeki Edit butonuna tıklanır.
- Form mevcut değerlerle dolu açılır.
- İlgili alanlar güncellenir (Protocol, Host, Port, Path, Keep Alive, Auth).
- Update ile değişiklikler kaydedilir.
- Compass'ta topic sorgusu doğrulaması yapılır.