Nesne Depolama Ekle (Add Object Storage) Paneli

Genel Bakış

Nesne Depolama Ekle paneli, S3-uyumlu nesne depolama sistemlerinin (MinIO, AWS S3, Ceph vb.) DataFloem platformuna güvenli bir şekilde entegre edilmesini sağlar.

Bu panel üzerinden tanımlanan bağlantılar; unstructured veya semi-structured dosyaların (CSV, Parquet, JSON, Image vb.) okunması, işlenmesi veya işlenen verilerin hedef depolama kovalarına (bucket) yazılması amacıyla kullanılır.

Erişim Gereksinimi

Bu sayfayı görüntüleyebilmek için kullanıcının Yönetici (Administrator) yetkisine sahip olması veya Hedef modülü için CREATE (Oluşturma) yetkisine sahip olması gerekir.

CREATE yetkisi, kullanıcılara yeni gruplar oluşturma izni verir. Yönetici yetkisine veya gerekli CREATE yetkisine sahip olmayan kullanıcılar bu sayfaya erişemez.

Gerekli yetkiye sahip değilseniz, sistem yöneticinizden aşağıdaki yetkilendirme sayfalarından birini kullanarak bu yetkiyi vermesini isteyebilirsiniz.

Yetkilendirme

Gerekli yetkilere sahip olmayan kullanıcılar aşağıdaki yetkilendirme hatasını alırlar:

Erişim Reddedildi

Bu kaynağa erişim yetkiniz bulunmamaktadır.

Ön Koşullar

Yeni bir Nesne Depolama bağlantısı oluşturmadan önce aşağıdakilerden emin olun:

Nesne depolama sunucusunun IP/Domain ve Port adreslerine DataFloem ortamından erişilebildiğini (Network/Firewall izinleri) doğrulayın.
İlgili depolama kovası (Bucket) üzerinde okuma/yazma (Get/Put Object) yetkilerine sahip geçerli bir Access Key ve Secret Key çifti hazırlayın.

Nesne Depolama Form Elemanları

Panel içerisinden yapılandırılması gereken alanlar şunlardır:

Alan	Zorunlu mu?	Açıklama
Connection Name	Evet	Bağlantının platform genelindeki benzersiz adıdır.
Database Type	Evet (Açılır Menü)	Kullanılan nesne depolama servis sağlayıcısının türüdür (Örn: MinIO, AWS S3).
Database Version	Evet (Açılır Menü)	İstemci sürücülerinin doğru eşleşmesi için seçilen depolama servisi sürüm bilgisi.
Is Active	Evet (Toggle)	Bağlantının oluşturulduğu an kullanıma açılıp açılmayacağını belirler. Varsayılan olarak aktif (`açık`) gelir.
Endpoint	Evet	Depolama sunucusunun IP adresi veya domain URL'sidir (Örn: `s3.amazonaws.com` veya özel IP).
Port	Evet	Servisin iletişim port numarasıdır (Örn: MinIO varsayılan `9000` veya HTTPS `443`).
Access Key	Evet	Nesne depolama servisine erişim sağlayan anahtar kimlik bilgisidir.
Secret Key	Evet	Access Key ile eşleşen gizli şifre anahtarıdır (Göz ikonu ile gizlenebilir/gösterilebilirdir).
Bucket Name	Evet	Verilerin okunacağı veya yazılacağı ana depolama kovasının (bucket) adıdır.
Root Directory Path	Evet	İşlemlerin yürütüleceği kök dizin yoludur. Varsayılan olarak kovanın kökünü temsil eden `/` değerini alır.
Path Style Access	Evet (Toggle)	İsteklerin URL yapısını belirler (`endpoint/bucket` formatı için aktif, `bucket.endpoint` formatı için kapalı tutulur; MinIO yapılandırmalarında genellikle aktiftir).
Optional Parameters (Name / Value)	Hayır	Bağlantıya özel ek parametreler (Örn: `region`, `ssl`) eklemek için kullanılan dinamik alandır.
Is Secret (Optional Parameters)	Evet (Toggle)	Girilen özel parametre değerinin şifrelenip gizlenmesini sağlar.

Path Style Access Davranışı

Path Style Access anahtarı aktif (açık) edildiğinde platform, depolama isteklerini https://endpoint:port/bucket-name formatında yönlendirir.
Anahtar kapalı tutulduğunda istekler https://bucket-name.endpoint:port (Virtual Hosted-Style) formatında gönderilir.
Özel sunucu (On-Premises MinIO, Ceph vb.) kurulumlarında erişim hatalarının önüne geçmek için genellikle Path Style Access anahtarının aktif edilmesi gerekmektedir.

Nesne Depolama Bağlantısı Oluşturma Süreci

Yönetim ekranındaki Add Object Storage butonuna tıklayarak sağ paneli açın.
Bağlantıya ait benzersiz Connection Name, Database Type ve Database Version seçimlerini yapın.
Depolama sunucusuna ait Endpoint, Port, Access Key, Secret Key ve Bucket Name bilgilerini girin.
Kök dizin yolunu (Root Directory Path) belirleyin ve mimarinize uygun ise Path Style Access anahtarını yapılandırın.
İhtiyaç varsa Optional Parameters alanından yeni satır ekleyerek özel dize parametrelerini ve Is Secret durumunu tanımlayın.
Bilgilerin doğruluğunu kontrol ettikten sonra bağlantıyı kaydetmek için Save butonuna, işlemi iptal etmek için Cancel butonuna tıklayın.

Doğrulama (Validation)

Connection Name, Endpoint, Port, Access Key, Secret Key ve Bucket Name alanları boş bırakılamaz.
Port alanı yalnızca geçerli sayısal değerler içermelidir (1-65535).
Root Directory Path alanı geçerli bir dizin yolu formatında olmalıdır (Örn: / veya /data/input/).