Ana içeriğe geç

MySQL Veri Kaynağı Ekleme

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

MySQL 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

MySQL/MariaDB veri kaynağı eklemeden önce şunlar hazır olmalıdır:

  • MySQL/MariaDB host/IP ve port (varsayılan: 3306)
  • Veritabanı adı (MySQL'de schema = database)
  • Kullanıcı adı ve şifresi
  • Kullanıcının ilgili veritabanına erişim yetkisi

→ Port — MySQL Genel Bakış

Ekleme Öncesi Gerekli Bilgiler

Bilgi Açıklama Varsayılan Örnek
Name Pirivision içinde veri kaynağına verilecek görünen isim — MES MySQL DB
Description Veri kaynağının kullanım amacı — MySQL type DB for MES Data
Database Name Bağlanılacak veritabanı adı — mes_production
Host MySQL sunucusunun IP adresi veya domain adresi — pirivision.digitheta.dev
Port MySQL bağlantı portu 3306 3307
Username Veritabanı kullanıcı adı — mysql
Password Kullanıcı şifresi — mysql

Varsayılan MySQL Portu

MySQL için varsayılan port 3306 değeridir. Özel kurulumlarda farklı port kullanılabilir.

Schema Alanı Yok

MySQL'de tablolar doğrudan veritabanı altında yer alır; ayrıca bir Schema alanı girilmez. Compass'ta sorgu yazarken tablo adını doğrudan kullanabilirsiniz (örn. SELECT * FROM production_logs). Birden fazla veritabanına erişim için sorgu içinde database_adi.tablo_adi notasyonu 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. MySQL Veri Kaynağı Tipini Seçin

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

MySQL eklemek için:

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

MySQL Veri Kaynağı Seçimi

Info

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

4. MySQL Formunu Doldurun

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

Form üç ana bölümden oluşur:

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

MySQL 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:

MES MySQL DB
Tesis1_MySQL_Production
ERP_MySQL
Quality_DB

Description

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

Örnek:

MES sisteminden üretim kayıtlarını içeren MySQL veritabanı.

6. Connection Settings

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

Alan Zorunlu Açıklama Varsayılan Örnek
Database Name Evet Bağlanmak istediğiniz veritabanının adı — mes_production
Host Evet MySQL sunucusunun IP adresi veya domain adresidir. — pirivision.digitheta.dev
Port Evet MySQL sunucusunun bağlantı dinlediği porttur. 3306 3307

Database Name

Örnekler:

mes_production
factory_app
scada_history
quality_db

Host

Örnekler:

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

Warning

Pirivision sunucusunun MySQL host adresine ağ üzerinden erişebilmesi gerekir.

Port

Varsayılan değer:

3306

7. Authentication

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

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

Yetki Önerisi

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

Güvenlik

Veritabanı şifresini dokümanlarda 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. MySQL 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 MySQL 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 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 MySQL veri kaynağı listede görünür.

MySQL Veri Kaynağı Listede

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

Alan / Aksiyon Açıklama
Veri kaynağı ikonu MySQL 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. → 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

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.
Access denied for user Kullanıcı adı veya şifre yanlış / yetersiz yetki Username/password bilgisini doğrulayın; kullanıcı yetkilerini kontrol edin.
Unknown database Database Name yanlış MySQL üzerinde gerçek veritabanı adını kontrol edin.
Can't connect to MySQL server MySQL servisi çalışmıyor veya port kapalı MySQL servisi durumunu ve TCP portunu kontrol edin.
host is not allowed to connect Uzak bağlantıya izin verilmemiş MySQL'de GRANT ... TO 'user'@'%' veya ilgili host için izin verin.
Kaydedilmiyor Test başarısız Test başarılı olmadan bağlantı kaydedilmez.

12. Sonraki Adım

MySQL 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/>MySQL 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

MySQL 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 MySQL seçilir.
  4. Display Info alanları doldurulur.
  5. Connection Settings alanları doldurulur (Database Name, Host, Port).
  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.