Azure Cloud Storage Paneli

Genel Bakış

Azure Cloud Storage paneli, Microsoft Azure üzerinde barındırılan depolama hesaplarının (Azure Blob Storage / Azure Data Lake Storage Gen2) DataFloem platformuna OAuth kimlik doğrulama yöntemiyle güvenli bir şekilde bağlanmasını sağlar.

Bu panel üzerinden tanımlanan bağlantılar; Azure konteynerları (Containers) içerisindeki yapılandırılmamış veya yarı yapılandırılmış dosyaların (Parquet, CSV, JSON vb.) okunması, işlenmesi ve işlenen verilerin hedef Azure Cloud Storage dizinlerine 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 Kaynak 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 Azure Cloud Storage bağlantısı oluşturmadan önce aşağıdakilerden emin olun:

Microsoft Entra ID (eski adıyla Azure AD) üzerinde DataFloem entegrasyonu için kayıtlı bir uygulama (App Registration) oluşturun.
Uygulamaya ait Client Id, Client Secret ve Entra ID dizin uç noktası (Client Endpoint / Tenant Endpoint) bilgilerini temin edin.
İlgili Azure Storage Account ve Container üzerinde bu uygulamaya Storage Blob Data Contributor veya Storage Blob Data Reader IAM rollerinin atandığını doğrulayın.

Azure Cloud Storage 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 Version	Evet (Açılır Menü)	Doğru istemci sürücülerinin eşleşmesi için seçilen Azure SDK/API sürüm bilgi alanıdır.
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.
Authentication Type	Salt Okunur	Kimlik doğrulama yöntemini belirtir. Bu panel için varsayılan ve sabitleşmiş değer `OAuth`'tur.
Client Id	Evet	Microsoft Entra ID üzerinde kayıtlı uygulamanın İstemci Kimliğidir (Application / Client ID).
Client Endpoint	Evet	OAuth belirteci (token) almak için kullanılacak Entra ID uç noktası URL'sidir (Örn: `https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token`).
Client Secret	Evet	Uygulamaya ait gizli istemci anahtarıdır (Göz ikonu ile gizlenebilir/gösterilebilirdir).
Storage Account	Evet	Azure üzerindeki hedef Depolama Hesabının (Storage Account) adıdır.
Container Name	Evet	Dosyaların okunacağı veya yazılacağı depolama konteynerının (Container/FileSystem) adıdır.
Root Directory Path	Evet	İşlemlerin yürütüleceği kök dizin yoludur. Varsayılan olarak konteynerın kökünü temsil eden `/` değerini alır.
Optional Parameters (Name / Value)	Hayır	Bağlantıya özel ek parametreler (Örn: `timeout`, `sasToken`) eklemek için kullanılan dinamik alandır.
Is Secret (Optional Parameters)	Evet (Toggle)	Girilen özel parametre değerinin şifrelenip gizlenmesini sağlar.

Azure Cloud Storage Bağlantısı Oluşturma Süreci

Bulut Depolama seçim panelinden Azure Cloud Storage seçeneğine tıklayarak bu formu açın.
Bağlantıya ait benzersiz Connection Name bilgisini girin ve Database Version seçimini yapın.
Microsoft Entra ID portalınızdan aldığınız Client Id, Client Endpoint ve Client Secret OAuth bilgilerini doldurun.
Hedef Azure depolama hesabınıza ait Storage Account, Container Name ve çalışılacak Root Directory Path dizin yolunu tanımlayı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, Client Id, Client Endpoint, Client Secret, Storage Account ve Container Name alanları boş bırakılamaz.
Client Endpoint geçerli bir HTTPS URL formatında olmalıdır.
Root Directory Path alanı geçerli bir dizin yolu formatında olmalıdır (Örn: / veya /raw/landing/).