Google Cloud Storage Paneli

Genel Bakış

Google Cloud Storage paneli, Google Cloud Platform (GCP) üzerinde barındırılan nesne depolama kovalarının (GCS Buckets) DataFloem platformuna güvenli bir şekilde entegre edilmesini sağlar.

Bu panel üzerinden tanımlanan bağlantılar; GCS kovaları 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 Google 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 Google Cloud Storage bağlantısı oluşturmadan önce aşağıdakilerden emin olun:

GCP Console üzerinden ilgili depolama kovasına (Bucket) erişim yetkisine sahip bir Servis Hesabı (Service Account) oluşturun.
Servis hesabına ait Storage Object Admin veya Storage Object Viewer/Creator IAM rollerinin atandığından emin olun.
Servis hesabına ait JSON anahtar dosyasından Project Id, Service Account Email, Service Account Private Id ve Service Account Private Key bilgilerini temin edin.

Google 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 GCS istemci 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.
Project Id	Evet	Google Cloud Platform üzerindeki ana proje kimliğidir (Örn: `my-gcp-project-id`).
Service Account Email	Evet	Kimlik doğrulama için kullanılan servis hesabının e-posta adresidir.
Service Account Private Id	Evet	Servis hesabına ait özel anahtarın benzersiz kimlik (Key ID) bilgisidir (Göz ikonu ile gizlenebilir/gösterilebilirdir).
Service Account Private Key	Evet	Servis hesabına ait gizli anahtar (Private Key) içeriğidir.
Bucket Name	Evet	Verilerin okunacağı veya yazılacağı GCS 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.
Optional Parameters (Name / Value)	Hayır	Bağlantıya özel ek parametreler (Örn: `location`, `kmsKeyName`) eklemek için kullanılan dinamik alandır.
Is Secret (Optional Parameters)	Evet (Toggle)	Girilen özel parametre değerinin şifrelenip gizlenmesini sağlar.

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

Bulut Depolama seçim panelinden Google 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.
GCP ortamınızdan aldığınız Project Id, Service Account Email, Service Account Private Id ve Service Account Private Key kimlik bilgilerini eksiksiz doldurun.
Hedef Bucket Name bilgisini 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, Project Id, Service Account Email, Service Account Private Id, Service Account Private Key ve Bucket Name alanları boş bırakılamaz.
Service Account Email alanı geçerli bir e-posta formatında olmalıdır (Örn: account@project.iam.gserviceaccount.com).
Root Directory Path alanı geçerli bir dizin yolu formatında olmalıdır (Örn: / veya /input/data/).