FastReport .NET'te Greenplum Database'e bağlanma
FastReport .NET’in 2027.1 sürümünden itibaren Greenplum Database ile çalışma desteği eklenmiştir. Bu makalede, özel bir eklenti yardımıyla rapor tasarımcısından Greenplum’a bağlantıyı nasıl kuracağınızı ve konektörü kendi .NET uygulamanızda nasıl kaydedeceğinizi ayrıntılı olarak ele alacağız. Eklenti, Npgsql.dll kütüphanesi üzerine kurulmuştur: Greenplum, mimari olarak PostgreSQL ile uyumludur; bu nedenle bağlantı, standart PostgreSQL protokolü üzerinden kurulur.
Bu makaleden şunları öğreneceksiniz:
- FastReport.Data.Greenplum eklentisini kaynak koddan nasıl derleyeceğiniz;
- eklentiyi FastReport rapor tasarımcısına nasıl bağlayacağınız;
- tasarımcıda Greenplum veri kaynağını nasıl oluşturacağınız;
- uygulamanın C# kodunda konektörü nasıl kaydedeceğiniz.
Bölüm 1. Fastreport'u inşa ediyoruz.Veri.Greenplum Eklentisi
Öncelikle, Greenplum Veritabanına bağlanmak için konektörü derlemeniz gerekir.
Adım 1. Proje dizinine gitme
FastReport .NET'in yüklü olduğu klasörü açın ve yola gidin:
Extras\Core\FastReport.Data\FastReport.Data.Greenplum
Adım 2. Projenin açılması
Visual Studio'da FastReport.Data.Greenplum.csproj proje dosyasını açın.
Adım 3. Referans hatalarını çözme (görünürlerse)
Projeyi ilk kez açarken, FastReport kitaplığına eksik veya bozuk bir başvuru nedeniyle yapı hataları oluşabilir. Sorunu çözmek için aşağıdaki adımları uygulayın:
- Proje bağımlılıkları listesinden bozuk veya eksik olan bağımlılığı (FastReport projesine olan bağlantıyı) silin.
- “Bağımlılıklar” (veya “Bağlantılar”) bölümüne sağ tıklayın ve “Bağlantı Ekle...” (Add Reference) seçeneğini seçin.
- “Gözat...” (Browse) düğmesine tıklayın ve kurulu FastReport .NET'in kök dizinine gidin.
- Dosya listesinden FastReport.dll dosyasını seçin ve eklenmesini onaylayın.
- Projeyi derleyin (Build / Rebuild). Bundan sonra tüm hatalar ortadan kalkacak ve hedef klasörde derlenmiş FastReport.Data.Greenplum.dll dosyası görünecektir.
Bölüm 2. Eklentiyi Rapor Tasarımcısına Bağlama
Artık Greenplum bağlayıcısı derlendiğine göre, onu FastReport rapor tasarımcısına ekleyelim.
FastReport rapor tasarımcısı'nı açın.
Dosya → Ayarlar menüsüne gidin ve “Eklentiler” sekmesini seçin.
"Ekle" düğmesini tıklayın ve derlenen dosyanın yolunu belirtin:
Extras\Core\FastReport.Data\FastReport.Data.Greenplum\bin\Debug\net452\FastReport.Data.Greenplum.dll
(veya ilgili hedef çerçeveye giden yol).
Eklentinin doğru yüklenebilmesi için rapor tasarımcısını yeniden başlatın.
Bölüm 3. Greenplum ile Bağlantı Oluşturma
Tasarımcıyı yeniden başlattıktan sonra, “Veriler” (Data) sekmesine gidin ve “Yeni Veri Kaynağı” (New Data Source) seçeneğini seçin.
Görüntülenen sihirbazda “Yeni Bağlantı...” (New Connection) düğmesine tıklayın.
Bağlantı türleri listesinden Greenplum Database'i seçin.
Bağlantı parametrelerini girin: ana bilgisayar, bağlantı noktası, veritabanı adı, kullanıcı adı ve şifre.
Greenplum ile başarılı bir bağlantıyı doğrulamak için “Bağlantıyı Test Et” i tıklayın.
Bölüm 4. Greenplum'u C# Koduyla Bağlama
Doğrudan kendi .NET uygulamanızdan raporlarla çalışıyorsanız (görsel tasarımcı olmadan veya katıştırırken), bağlayıcı, raporu yüklemeden veya çalıştırmadan önce programlı olarak kaydedilmelidir.
Adım 1. Kitaplığa başvuru ekleme
Derlenmiş FastReport.Data.Greenplum.dll kitaplığı projenizin bağımlılıklarına ekleyin (References / Project References).
Adım 2. Uygulama başlangıcında bağlayıcıyı kaydetme
RegisteredObjects.AddConnection Raporlarla çalışmaya başlamadan önce yöntemi çağırın — örneğin Program.cs, Startup.cs veya Report.Load()yöntemi çağırmadan önce:
RegisteredObjects.AddConnection(typeof(GreenplumDataConnection));
Sonuç
Bu makalede, FastReport .NET'teki Greenplum Veritabanı ile iş akışının tamamını inceledik: bağlayıcının kaynak kodunu derlemekten ve eklentiyi rapor tasarımcısına entegre etmekten bağlantıyı C# koduna kaydetmeye kadar. Fastreport'un esnek eklenti sistemi sayesinde, Greenplum analitik dbms'ye bağlanmak hızlıdır ve karmaşık manipülasyonlar gerektirmez-artık doğrudan Greenplum veritabanınızdan raporlar oluşturabilirsiniz.
