PostgreSQL Veri Kaynağı Düzenleme
Bu sayfa, Pirivision Port modülünde daha önce eklenmiş bir PostgreSQL veri kaynağının Edit aksiyonuyla güncellenmesini anlatır.
Bağlantı bilgileri değiştiğinde (sunucu taşıması, şifre rotasyonu, schema değişikliği vb.), veri kaynağına yeni bir isim verilmek istendiğinde veya klasör konumu güncellenmek istendiğinde bu akış kullanılır.
Ön Koşul
Port listesinde en az bir PostgreSQL veri kaynağı kayıtlı olmalıdır. Henüz eklenmemişse önce PostgreSQL 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 PostgreSQL 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 veri kaynağı ekleme formuyla aynı ekrandır; fark yalnızca alanlardaki değerlerin dolu gelmesi ve altta Test and 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 | Schema | Hayır | public |
PostgreSQL schema adı |
| Connection Settings | Database Name | Evet | — | Bağlanılacak veritabanının adı |
| Connection Settings | Host | Evet | — | Sunucunun IP veya domain adresi |
| Connection Settings | Port | Evet | 5432 |
Bağlantı portu |
| Authentication | Username | Evet | — | Veritabanı kullanıcı adı |
| Authentication | Password | Evet | — | Kullanıcı ş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 | PostgreSQL olarak sabit kalır; MSSQL, MySQL vb. türlere dönüştürülemez. |
5. Test and Update Butonu
Tüm alanlar güncellendikten sonra sağ alttaki Test and Update butonuna tıklayın.
Bu işlem iki aşamada çalışır:
- Girilen bağlantı bilgileriyle PostgreSQL bağlantısı test edilir.
- Test başarılıysa güncellenen değerler kaydedilir.
Formun alt kısmında şu bilgi görünür:
Success
Test başarılı olursa güncellenen veri kaynağı Port listesine yönlendirilir. Bağlantıya ait Compass sorgu önbelleği otomatik geçersiz kılınır (query cache invalidated), sorgular en güncel bağlantı üzerinden çalışır.
Failure
Test başarısız olursa güncellenmiş bilgiler kaydedilmez. Host, port, database name, username, password, schema ve ağ erişimini 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ı kullanıcı adı altında başka bir veri kaynağı bu adı zaten kullanıyor | 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; yetkisiz kaynak için yönetici ile iletişime geçin |
user not found |
Oturum süresi dolmuş veya hesap silinmiş | Yeniden giriş yapın |
Bağlantı test hatası (update failed: ...) |
Güncellenen Host, Port, Database Name veya kimlik bilgileri hatalı | Bağlantı parametrelerini doğrulayın; sunucuya ağ erişimini kontrol edin |
| Timeout | Sunucuya erişim yok veya firewall engeli | Firewall, VPN, güvenlik grubu kurallarını kontrol edin |
FATAL: password authentication failed for user |
Şifre yanlış | Şifreyi doğrulayın |
FATAL: database does not exist |
Database Name yanlış | PostgreSQL üzerinde gerçek veritabanı adını kontrol edin |
7. Sonraki Adım
Veri kaynağı güncellendikten sonra bu kaynağı kullanan Compass sorguları otomatik olarak yeni bağlantı parametrelerini kullanır. Sorgunun hâlâ doğru çalıştığını Compass üzerinde test sorgusu çalıştırarak doğrulayabilirsiniz.
flowchart LR
A["Port<br/>PostgreSQL Düzenlendi"] --> B["Compass<br/>Sorgu Doğrulama"]
B --> C["Cartography<br/>Chart / KPI (değişiklik yok)"]Özet
PostgreSQL veri kaynağı düzenleme süreci:
- Port modülüne girilir.
- Listede veri kaynağı bulunur.
- Kart üzerindeki Edit butonuna tıklanır.
- Form mevcut değerlerle dolu açılır.
- İlgili alanlar güncellenir.
- Test and Update ile bağlantı test edilip kaydedilir.
- Compass'ta sorgu doğrulaması yapılır.