Ana içeriğe geç

PostgreSQL Veri Kaynağı Ekleme

Bu sayfa, Pirivision Port modülünde PostgreSQL veri kaynağı ekleme sürecini anlatır.

PostgreSQL bağlantısı başarıyla oluşturulduktan sonra veri kaynağı Compass modülünde SQL sorguları için kullanılabilir. Compass'ta hazırlanan sorgular daha sonra Cartography tarafında chart / KPI formatına dönüştürülür ve Horizon veya Atlas dashboardlarında kullanılır.

Ön Koşul

PostgreSQL veri kaynağı eklemeden önce şunlar hazır olmalıdır:

  • PostgreSQL sunucu host/IP ve port (varsayılan: 5432)
  • Veritabanı adı ve schema (varsayılan: public)
  • Kullanıcı adı, şifre ve veritabanına erişim yetkisi
  • Pirivision sunucusundan ağ erişimi (firewall/VPN)

→ Port — PostgreSQL Genel Bakış

Ekleme Öncesi Gerekli Bilgiler

Bilgi Açıklama Varsayılan Örnek
Name Pirivision içinde veri kaynağına verilecek görünen isim — Process DB
Description Veri kaynağının kullanım amacı — PostgreSQL type DB for Process Data
Schema PostgreSQL schema adı public postgres, production
Database Name Bağlanılacak veritabanı adı — process_db
Host PostgreSQL sunucusunun IP adresi veya domain adresi — pirivision.digitheta.dev
Port PostgreSQL bağlantı portu 5432 5433, 15432
Username Veritabanı kullanıcı adı — postgres
Password Kullanıcı şifresi — postgres

Varsayılan PostgreSQL Portu

PostgreSQL için varsayılan port genellikle 5432 değeridir. Özel kurulumlarda farklı port kullanılabilir.

1. Port Modülüne Girin

Sol menüden Port modülüne tıklayın. Port, Pirivision'da veri kaynaklarının eklendiği, listelendiği, düzenlendiği ve test edildiği modüldür.

Port Root Directory

Eğer daha önce veri kaynağı eklenmediyse ekranda Connect Your Factory Data mesajı görünür.

Bu ekrandan veri kaynağı eklemek için:

  • Add New Data Sources
  • Add Your First Data Source

butonlarından biri kullanılabilir.

2. Yeni Veri Kaynağı Ekleme Akışını Başlatın

Sağ üstteki Add New Data Sources butonuna tıklayın.

Boş liste ekranındaysanız orta bölümdeki Add Your First Data Source butonu da aynı akışı başlatır.

3. PostgreSQL Veri Kaynağı Tipini Seçin

Açılan ekranda Select Your Data Source Type başlığı altında veri kaynağı tipleri listelenir.

PostgreSQL eklemek için:

  1. Relational Databases (SQL) bölümüne gidin.
  2. PostgreSQL kartını seçin.
  3. Sağ üstteki Next butonuna tıklayın.

PostgreSQL Veri Kaynağı Seçimi

Info

Pirivision'da ilişkisel veritabanı bağlantıları için PostgreSQL, MySQL ve MSSQL seçenekleri kullanılabilir.

4. PostgreSQL Formunu Doldurun

PostgreSQL seçildikten sonra Add a New PostgreSQL Data Source ekranı açılır.

Form dört ana bölümden oluşur:

  1. Display Info
  2. Connection Settings
  3. Authentication
  4. Location

PostgreSQL Veri Kaynağı Ekleme Formu

5. Display Info

Display Info, veri kaynağının Pirivision arayüzünde nasıl görüneceğini belirler.

Alan Zorunlu Açıklama
Name Evet Veri kaynağını Pirivision içinde tanımak için kullanılan isimdir.
Description Hayır Veri kaynağının ne işe yaradığını açıklayan kısa nottur.

Name

Bu veri kaynağını panellerde ve listelerde tanımak için kullanılır.

İyi örnekler:

Process DB
Tesis1 SCADA PostgreSQL
MES Production DB
Quality Laboratory DB

Kötü örnekler:

test
db1
postgres
new source

İsimlendirme Önerisi

Veri kaynağı adında tesis, sistem ve veri tipi bilgisini birlikte kullanın. Örneğin: Tesis1_SCADA_PostgreSQL.

Description

Bu bağlantının ne işe yaradığını açıklayan isteğe bağlı alandır.

Örnek:

Üretim, enerji ve kalite verilerini içeren PostgreSQL veri kaynağı.

6. Connection Settings

Connection Settings, PostgreSQL sunucusuna bağlanmak için gerekli teknik bilgileri içerir.

Alan Zorunlu Açıklama Varsayılan Örnek
Schema Hayır PostgreSQL içinde tabloların ve view'ların bulunduğu mantıksal gruptur. public production, reporting
Database Name Evet Bağlanmak istediğiniz veritabanının adıdır. — process_db
Host Evet PostgreSQL sunucusunun IP adresi veya domain adresidir. — pirivision.digitheta.dev
Port Evet PostgreSQL sunucusunun bağlantı dinlediği porttur. 5432 5433, 15432

Schema

PostgreSQL'de schema; tablo, view ve diğer veritabanı nesnelerini organize etmek için kullanılan mantıksal gruptur. Özel yapılandırma yoksa çoğu kurulumda public kullanılır.

Yaygın değerler:

public
postgres
production
reporting

Note

Tablolar özel bir schema altında tutuluyorsa doğru schema adı girilmelidir. Aksi halde Compass tarafında tablo veya view bulunamayabilir.

Database Name

Sunucu üzerinde bağlanılacak veritabanının tam adıdır.

Örnekler:

process_db
factory_mes
scada_history
quality_db

Host

PostgreSQL veritabanının çalıştığı sunucunun ağ adresidir.

Örnekler:

localhost
127.0.0.1
192.168.1.105
db.company.local
pirivision.digitheta.dev

Warning

Pirivision sunucusunun PostgreSQL host adresine ağ üzerinden erişebilmesi gerekir. Kendi bilgisayarınızdan bağlantı kurabilmeniz, Pirivision sunucusunun da erişebileceği anlamına gelmeyebilir.

Port

PostgreSQL bağlantı portudur.

Varsayılan değer:

5432

Özel kurulum örnekleri:

5100
5433
15432

7. Authentication

Authentication bölümünde veritabanı kullanıcı bilgileri girilir.

Alan Zorunlu Açıklama Örnek
Username Evet PostgreSQL kullanıcı adı postgres
Password Evet Kullanıcıya ait şifre postgres

Username

Veritabanına bağlanmak ve sorgu çalıştırmak için yetkilendirilmiş kullanıcı adıdır.

Örnekler:

postgres
readonly_user
dashboard_user
pirivision_user

Yetki Önerisi

Dashboard okumaları için sadece gerekli tablolara okuma yetkisi olan ayrı bir kullanıcı oluşturmak daha güvenlidir. Örneğin: pirivision_readonly.

Password

Bu kullanıcıya ait paroladır. Şifre alanı gizli tutulur. Gerekirse göz ikonuyla geçici olarak görüntülenebilir.

Güvenlik

Veritabanı şifresini dokümanlarda, ekran görüntülerinde veya paylaşılabilir ortamlarda açık şekilde göstermeyin.

8. Location

Location, oluşturulan veri kaynağının Pirivision klasör yapısında nerede saklanacağını belirtir.

Alan Açıklama Örnek
Target Folder Veri kaynağının kaydedileceği klasör PORT

Target Folder alanına tıklandığında klasör seçim diyaloğu açılır:

Location — Target Folder alanı

Target Folder seçim diyaloğu

Örnek klasörleme:

PORT/
├── Tesis 1/
│   ├── SCADA/
│   ├── MES/
│   └── Quality/
├── Tesis 2/
│   ├── SCADA/
│   └── Energy/
└── Test Sources/

9. Test & Save ile Bağlantıyı Kaydedin

Tüm zorunlu alanlar doldurulduktan sonra sağ alttaki Test & Save butonuna tıklayın.

Bu işlem iki aşamalı çalışır:

  1. PostgreSQL bağlantısı test edilir.
  2. Test başarılıysa veri kaynağı otomatik olarak kaydedilir.

Ekranda şu bilgi yer alır:

Connection will be saved automatically if the test is successful

Success

Test başarılı olursa PostgreSQL veri kaynağı Port ekranında listelenir ve Compass içinde sorgu oluşturmak için kullanılabilir hale gelir.

Failure

Test başarısız olursa host, port, database name, username, password, schema ve ağ erişimi bilgilerini kontrol edin.

10. Veri Kaynağını Listede Kontrol Edin

Başarılı kayıt işleminden sonra Port ana ekranına dönüldüğünde oluşturulan PostgreSQL veri kaynağı listede görünür.

PostgreSQL Veri Kaynağı Listede

Liste kartında aşağıdaki bilgiler ve aksiyonlar yer alır:

Alan / Aksiyon Açıklama
Veri kaynağı ikonu PostgreSQL veri kaynağı olduğunu gösterir.
Name Veri kaynağı adı.
Description Açıklama metni.
Kullanım durumu In Use veya Not in Use bilgisi.
Edit Bağlantı bilgilerini günceller. → PostgreSQL Veri Kaynağı Düzenleme
More Ek işlemler menüsünü açar.
↳ Move Veri kaynağını farklı bir klasöre taşır. → Veri Kaynağı Taşıma
↳ Duplicate Aynı ayarlarla yeni bir kopya oluşturur. → Veri Kaynağı Çoğaltma
↳ Delete Veri kaynağını kaldırır. → Veri Kaynağı Silme

Delete İşlemi

Silme işlemi geri alınamayabilir. Veri kaynağı bir sorgu, chart veya dashboard tarafından kullanılıyorsa silmeden önce bağımlılıkları kontrol edin.

Veri kaynağı henüz Compass veya dashboard tarafında kullanılmıyorsa durum genellikle şöyle görünür:

Not in Use

11. Sık Karşılaşılan Hatalar

Hata / Belirti Olası Neden Çözüm
Bağlantı kurulamıyor Host yanlış veya erişilemiyor IP/domain bilgisini ve ağ erişimini kontrol edin.
Timeout hatası Sunucuya erişim yok veya firewall engeli var Firewall, VPN, security group ve network ayarlarını kontrol edin.
Authentication failed Kullanıcı adı veya şifre yanlış Username/password bilgisini doğrulayın.
Database does not exist Database name yanlış PostgreSQL üzerinde gerçek veritabanı adını kontrol edin.
Permission denied Kullanıcının yetkisi yok Kullanıcıya gerekli schema/table yetkilerini verin.
Relation not found Schema veya tablo adı yanlış Schema ve tablo adını kontrol edin.
SSL hatası Sunucu SSL istiyor veya SSL modu uyumsuz PostgreSQL SSL yapılandırmasını kontrol edin.
Kaydedilmiyor Test başarısız Test başarılı olmadan bağlantı kaydedilmez.

12. Sonraki Adım

PostgreSQL veri kaynağı Port modülünde oluşturulduktan sonra süreç Compass, Cartography, Horizon ve Atlas adımlarıyla devam eder.

flowchart LR
    A["Port<br/>PostgreSQL Veri Kaynağı"] --> B["Compass<br/>SQL Sorgusu"]
    B --> C["Cartography<br/>Chart / KPI"]
    C --> D["Horizon<br/>Sayfa / Board Hazırlama"]
    D --> E["Atlas<br/>Dashboard Görünümü"]

Özet

PostgreSQL veri kaynağı ekleme süreci:

  1. Port modülüne girilir.
  2. Add New Data Sources butonuna tıklanır.
  3. Veri kaynağı tipi olarak PostgreSQL seçilir.
  4. Display Info alanları doldurulur.
  5. Connection Settings alanları doldurulur.
  6. Authentication bilgileri girilir.
  7. Target Folder seçilir.
  8. Test & Save ile bağlantı test edilir ve kaydedilir.
  9. Veri kaynağı Port listesinde kontrol edilir.
  10. Compass modülünde SQL sorgusu oluşturulur.
  11. Cartography modülünde chart / KPI oluşturulur.
  12. Horizon tarafında sayfa veya board hazırlanır.
  13. Atlas tarafında dashboard görünümü oluşturulur.