1. Kuika platformuna giriş yapın ve Apps ekranından çalışacağınız projeyi açın.
2. Üst menüden Datasources modülünü açın. Bu modülde uygulamanızdaki veri kaynaklarını ve aksiyonları Recently modified ve Data sources sekmeleri altında görüntüleyebilir, Search by name alanı ile arama yapabilir ve yeni bir veri kaynağı ekleyebilirsiniz.
3. Ekranın üst kısmındaki kartlardan Create a Database kartına tıklayın. Bu kart MS SQL Server, PostgreSQL ve Oracle veritabanlarına bağlanmanızı sağlar.
4. Açılan Databases listesinden MS SQL Server (Microsoft SQL Server database) seçeneğini belirleyin. Listede gezinmek için ↑/↓ tuşlarını, seçim yapmak için Enter tuşunu da kullanabilirsiniz.

5. Name alanına veri kaynağınız için bir isim girin (örn. userguidemssql). İsim girilene kadar CREATE butonu pasif durumdadır.
6. CREATE butonuna tıklayarak işlemi tamamlayın. İşlemden vazgeçmek için CANCEL butonunu, veritabanı seçimine geri dönmek için < MS SQL Server bağlantısını kullanabilirsiniz.

Not: Sol paneldeki Sources başlığının yanında yer alan + ikonu ile de yeni veri kaynağı ekleme işlemini başlatabilirsiniz.

Bu adımların ardından MSSQL bağlantı ayarları ekranı açılır. Ekranın üst kısmında geri butonu (←), veri kaynağının adı (adı düzenlemek için kalem ikonu) ve ayarları kaydetmek için CREATE butonu yer alır. Bağlantı bilgilerini Endpoint bölümündeki Enter fields veya Connection string sekmelerinden biriyle girebilirsiniz.

Local'de çalıştığınız bir MSSQL veritabanına bağlanabilmek için MSSQL Server'ın internete açık olması gerekmektedir.

Endpoint bölümünde Enter fields sekmesini seçin ve aşağıdaki alanları doldurun.

01 Endpoint

Kuika'nın bağlanacağı sunucu bilgilerini içerir.

• Server (zorunlu): MSSQL veritabanı sunucu adresini girin. Örnek: myServerAddress
• Database (zorunlu): Bağlanmak istediğiniz veritabanının adını yazın. Örnek: myDataBase

02 Credentials

Connection string'in parçası olan kimlik bilgileridir.

• User ID: Kullanıcı adını girin. Örnek: myUsername
• Password: Şifrenizi girin. Örnek: myPassword. Göz ikonu ile şifreyi gösterebilir veya gizleyebilirsiniz.

03 Parameters

Connection string'e eklenecek ek parametreleri Key ve Value sütunlarından oluşan tabloya girebilirsiniz. Bir satırı doldurduğunuzda altında yeni bir boş satır oluşur; eklenen bir satırı çöp kutusu ikonuyla silebilirsiniz.

Örnek parametreler:

Encrypt: true

Connection Timeout: 30

Parametre girdiğinizde sağ taraftaki Resolves To alanında, girdiğiniz bilgilerden oluşturulan connection string'in önizlemesini görebilirsiniz.

Yukarıdaki örnek bilgilerle oluşan connection string şu şekilde olur:

data source=myServerAddress;initial catalog=myDataBase;user id=myUsername;password=myPassword;Encrypt=true;Connection Timeout=30;

1. Endpoint bölümünde Connection string sekmesini seçin.
2. Connection string (zorunlu) alanına MSSQL veritabanınıza ait connection string bilgisini girin. Alan varsayılan olarak şu şablonla gelir: data source=;initial catalog=;user id=;password=

Örnek format:

data source=myServerAddress;initial catalog=myDataBase;user id=myUsername;password=myPassword;

Bağlantıyı Test Etme ve Kaydetme

1. Sağ taraftaki Connection bölümünde yer alan Test connection butonuna tıklayarak bağlantının çalışıp çalışmadığını kontrol edin.
2. Bağlantı başarılıysa sağ üstteki CREATE butonuna tıklayarak işlemi tamamlayın.

Kayıt işleminin ardından veritabanınızdaki tablolar otomatik olarak okunur ve Kuika'da kullanılabilir hale gelir.

1. TLS 1.2 kullanın: Veri iletişimini güvenli hale getirmek için TLS 1.2 protokolünü etkinleştirin.
2. Port ayarları: SQL Server'ın varsayılan olarak kullandığı 1433 numaralı TCP portunun sunucu ve güvenlik duvarı üzerinde açık olduğundan emin olun. Named instance kullanıyorsanız SQL Server Browser servisinin çalıştığını ve 1434 numaralı UDP portunun açık olduğunu kontrol edin.
3. Dış IP'lere izin verin: Sunucunuzun dış IP adreslerinden gelen bağlantılara açık olduğundan emin olun.
4. Connection string testi yapın: Bağlantınızı harici bir ağ üzerinden test edin.
5. SQL Server Configuration Manager ayarları:
   
   • SQL Server Network Configuration > Protocols for [instance adı] bölümünde TCP/IP protokolünü etkinleştirin.
   • Değişikliklerin uygulanması için SQL Server servisini yeniden başlatın.

MSSQL Tablolarını Harici Bir Araçla Görüntüleme

Bağlandığınız veritabanındaki tabloları kontrol etmek için SQL Server Management Studio (SSMS) veya MSSQL eklentisi yüklü Visual Studio Code kullanabilirsiniz.

1. Aracı indirip kurun.
2. Sunucuya bağlanın: Sunucu adı, veritabanı adı ve kimlik bilgilerinizi girerek bağlantıyı tamamlayın.
3. Veritabanını seçin: Sol taraftaki Databases bölümünden istediğiniz veritabanını açın.
4. Tabloları görüntüleyin: Tables klasörünü genişletin ve tablolara erişin.
5. SQL sorgusu çalıştırın:

SELECT * FROM [TabloAdı];

Sorguyu çalıştırmak için F5 tuşuna basın veya Execute/Run butonuna tıklayın.

Bu adımları takip ederek MSSQL veri kaynağını Kuika uygulamalarınıza bağlayabilirsiniz.

1. Azure Data Studio'yu indirip kurun.
2. Sunucuya bağlanın:
   
   • Bağlan butonuna tıklayın.
   • Sunucu adı, veri tabanı adı ve kimlik bilgilerinizi girerek bağlantıyı tamamlayın.
3. Veri tabanını seçin:
   
   • Sol taraftaki "Veri Tabanları" bölümünden istediğiniz veri tabanını açın.
4. Tabloları görüntüleyin:
   
   • "Tablolar" klasörünü genişletin ve tablolara erişin.
5. SQL sorgusu çalıştırın:

SELECT * FROM [TabloAdı];

• F5 tuşuna basarak sorguyu çalıştırın.

Bu adımları takip ederek MSSQL veri kaynağını Kuika uygulamalarınıza bağlayabilirsiniz.