Lunex’te bir veritabanını, akışınızın veri okuduğu veya yazdığı bir kaynak olarak kullanırsınız. Gelen isteğe göre kayıt arayabilir, başka sistemden gelen veriyi kaydedebilir veya mevcut bir kaydı güncelleyebilirsiniz. Bunu yapmak için yeni bir veritabanı ya da bu kılavuzdaki örnek tabloları oluşturmanız gerekmez.
Elinizdeki veritabanının türünü, erişeceğiniz tabloları ve yapmak istediğiniz işi esas alın. Bağlantı, nereye ve hangi kullanıcıyla erişileceğini; SQL adımı, o bağlantıyla hangi işlemin yapılacağını belirler. Aynı bağlantıyı birden fazla akış kullanabilir.
Nereden başlamalısınız?
| İhtiyacınız | İzleyeceğiniz yol |
|---|---|
| Mevcut veritabanıma ilk kez bağlanacağım | Veritabanına bağlanın |
| Bağlantım hazır; bir kayıt veya liste okuyacağım | Veritabanından veri okuyun |
| Gelen veriyi kaydedecek veya mevcut kaydı değiştireceğim | Kayıt ekleyin ve güncelleyin |
| Birkaç değişiklik ya hep birlikte olmalı ya hiç olmamalı | Transaction ve geri alma |
| Hata aldım veya tekrar göndermeli miyim bilmiyorum | Doğrulama ve hata teşhisi |
| Hazır bir uygulamayı kurup deneyerek öğrenmek istiyorum | İsteğe bağlı sipariş ve stok örneği |
Başlamadan önce hangi bilgileri bilmelisiniz?
Veritabanı yöneticinizden sunucu adresi, veritabanı adı, kullanıcı, parola veya Secret referansı, JDBC sürücüsü ve gerekiyorsa TLS ayarlarını alın. Hangi schema ve tablolara erişeceğinizi, bu kullanıcıya hangi işlemlerin verildiğini öğrenin. SQL Server, Oracle, MySQL, PostgreSQL veya başka bir JDBC hedefi için sürücü, URL ve bazı SQL ifadeleri farklıdır; hazır bir bağlantı şablonunun varlığı tek başına ortamın hazır olduğunu göstermez.
Tablo oluşturma görevi bu entegrasyonun parçası değilse mevcut tablolarla çalışın. Yeni tablo gerekiyorsa tasarımını ve oluşturulmasını veritabanından sorumlu kişiyle ayrı hazırlayın. Entegrasyon kullanıcısına yalnızca işinin gerektirdiği okuma/yazma yetkilerini verin.
Bir veritabanı işlemi akışta nasıl ilerler?
- Mesaj gelir. Bu bir API isteği, kuyruk mesajı, dosya veya zamanlanmış çalışma olabilir.
- Girdi hazırlanır. JSON metni nesneye çevrilir, gereken alanlar kontrol edilir ve sorgu parametreleri belirlenir.
- SQL adımı çalışır. Adım, seçtiğiniz bağlantıyı ve sorguyu kullanır.
- Sonuç değerlendirilir. Okumada gelen satırlar; yazmada değişen satır sayısı ve işin son durumu kontrol edilir.
- Akış devam eder. Sonuç başka adıma gönderilir, API yanıtına çevrilir veya gerekiyorsa hata yolu seçilir.
Veritabanı adımı kullanmak için bir API oluşturmak zorunda değilsiniz. API, uygulamalı örnekte farklı girdileri kolayca göndermek ve sonucu görmek için kullanılan giriş yoludur.
Sık karşılaşacağınız birkaç kavram
| Kavram | İşinizdeki karşılığı |
|---|---|
| Bağlantı / Data Source | Veritabanına erişen, adı olan ortak kaynak |
| Bean | Bağlantı gibi yapılandırılmış bir nesnenin projede isimle kullanılabilmesi |
| Body | O adımda işlenen içerik; SQL gibi adımlar bunu değiştirebilir |
| Header | Mesaja eşlik eden bilgi; API parametresi veya yazmadan etkilenen satır sayısı gibi |
| Exchange property | Aynı çalışma sırasında sonra kullanmak üzere sakladığınız bilgi; kalıcı kayıt değildir |
| Parametre bağlama | Gelen değeri SQL komutunun bir parçası yapmak yerine sorguya veri olarak vermek |
| Transaction | Bir grup değişikliği tek bir commit veya rollback sonucuna bağlamak |
Bu kavramların ayrıntısını ilgili işi yaparken göreceksiniz. İlk hedefiniz küçük bir okuma işlemini gerçek bağlantıyla doğrulamak; sonra yazma ve hata davranışını eklemektir.
Ne zaman örneğe geçmelisiniz?
Kendi bağlantınız veya şemanız hazırsa doğrudan ilgili genel rehberden ilerleyin. Deneme ortamınız yoksa sipariş ve stok uygulaması ayrı bir PostgreSQL veritabanı, örnek tablolar ve indirilebilir proje sağlar. O bölümdeki ürün seçimi ve tablo isimleri yalnızca örneği aynı sonuçlarla tekrar edebilmek içindir.