Başlıkta SQL yazmasına takılmayın. Bu tavsiyelerim her veritabanı için geçerli olacaktır.

Veritabanı ve Okunaklı Kodlama İçin Tavsiyeler

Projelerimizde veritabanı olmazsa olmaz gibi bir şeydir. Her projemiz bir şeyleri takip etme (stok cari vs. vs.) amacı gütmese de yine de bir takım verileri saklamak için veritabanı kullanmak zorunda kalıyoruz. Bu veri tabanının ne olduğu aslında önemli değil. Biz programcılar için bir noktalama işaretinin bile çalışmayı engelleyecek bir öneme sahip olduğu aşikar. Bu sebeple yazdığımız sorgularda (query) bu noktalama işaretleri yüzünden çok fazla hata yapabiliyoruz.

Bu vereceğim tavsiyeler işte böylesi küçük sorunlara karşı daha hızlı bir çözüm olması ve okunaklı olması amacı güdüyor.

Incorrext Syntax Near ","

Gibi hayattan soğutan bu hatalarla daha az nasıl karşılabiliriz? Nasıl minimuma indirebiliriz?

Otomatik Query Oluşturma

Diğer veritabanı programlarını bilmiyorum ama SQL Management Studio‘da bu işlem var ve çok sık kullanırım.

SQL Management Studio ‘da bir tablo üzerinde sağ tık yapın ve “Script Table As” > “INSERT To” > “New Query Editor Window” deyin. Açılan Query sayfasında o tabloya bir insert yapmak için gerekli query otomatik oluşmuş oluyor. Query’i kopyalıyoruz ve kod sayfamıza yapıştırıyoruz.

Her satırın başına ( +” ) ve sonuna ( ” ) ekliyoruz. Sorgumuzu bir string değişkene atıyoruz ve gerekli yerleri düzeltiyoruz. Yani VALUES kısmından sonraki satırlara verileri alacağımız nesneleri yazıyoruz.

Genelde kullanılan şekli aşağıdaki gibidir değil mi? Ne kadarda okunaksız. Birde burada 60, 70 kolon olduğunu ve böyle uzayıp gittiğini düşünün. Ne kadar zorlanırsınız? Arada bir virgülün eksik olduğunu düşünün… Ya da fazla olduğunu…

INSERT INTO [dbo].[Kullanicilar]([ku_kodu],[ku_adi],[ku_sifre],[ku_yetki])
     VALUES ('5','Mustafa BÜKÜLMEZ','123465','Administrator')

Şimdi yukarıda bahsettiğim şeyi yapalım ve görelim…

INSERT INTO [dbo].[Kullanicilar]
 	 ([ku_kodu]
	 ,[ku_adi]
	 ,[ku_sifre]
	 ,[ku_yetki])
VALUES (
	 '5'
	 ,'Mustafa BÜKÜLMEZ'
	 ,'123465'
	 ,'Administrator')

Böyle bir yazım şeklinde eksik veya fazla virgülü neredeyse anında bulabilirsiniz değil mi? Ama burada virgülleri kolon adlarının sol tarafında olmasına dikkat edin. Otomatik olarak solda geliyor ama bazen üzerinde düzenleme yapmamız gerekebiliyor. Sağ tarafında olursa pek bir anlamı kalmıyor.

Okunaklı Kod ve Sorgu

Benim kullanım şeklim bir adım daha ileri gidersek şöyle oluyor.

INSERT INTO [dbo].[Kullanicilar]
           ([ku_kodu]
           ,[ku_adi]
           ,[ku_sifre]
           ,[ku_yetki])
     VALUES
           ('5' -- <ku_kodu, nvarchar(50),>
           ,'Mustafa BÜKÜLMEZ' --<ku_adi, nvarchar(50),>
           ,'123465' --<ku_sifre, nvarchar(50),>
           ,'Administrator' ) -- <ku_yetki, nvarchar(50),>)

Bu şekilde yaptığımda hangi satırda hangi kolon bilgisi var ve olması gerekeni görebiliyorum. Üst kısım ile karşılaştırıp eksik kolon var mı görebiliyorum. Burada dikkat edilmesi gereken nokta son satırdaki parantezi unutmamak.. (–) yaptıktan sonra parantezde yorum olarak kalıyor ve parantez hatası alıyoruz. Bu yöntemi her zaman kullanmıyorum. Çok fazla kolonu olan tablolarda kullanıyorum.

Ayrıca genellikle bu yorum olarak işaretleme işlemini C# tarafında yapıyorum. ilgili texbox’u yazdıktan sonra kolon adı ve veri tipi kısmından önce // kullanıyorum.

Aynı şekilde Select, Update gibi tüm işlemler için gereken sorguları alabiliyoruz.

Ben C# kullandığım için Visual Studio’da şöyle görünüyor.

                comm.CommandText =""
                        + "  INSERT INTO [dbo].[Kullanicilar] "
                        + "       ( ku_kodu " 
                        + "       , ku_adi "
                        + "       , ku_sifre "
                        + "       , ku_yetki) "
                        + "  VALUES "
                        + "       ( '" + txt_kod.Text + "' "
                        + "       , '" + txt_adi.Text + "' "
                        + "       , '" + txt_sifre.Text + "' "
                        + "       , '" + cmb_yetki.Text + "'    )";

Yaşadığım şehir olan Kahramanmaraş’ta “İp Gibi” (Gergin bir ip gibi dümdüz) diye bir deyim vardır.  Tam uyuyor. 😀 Bu konuda ilk zamanlarda çok sıkıntı çektiğim için takıntılı oldum. Her virgül ve + aynı hizanda olmazsa rahat edemiyorum. 🙂 Mesleki deformasyon gibi bir şey. 🙂 

NOT: Buradaki yazıda bir SQL ‘de Entity Class Oluşturma dersini de inceleyebilirsiniz. Tablolarınızı SQL üzerinde bu şekilde modelleyerek ve sorgularınızı yukarıdaki gibi okunaklı olarak yazarak güzel kodlar yazabilirsiniz. 🙂

Kolonlarda Tablo İşaretçileri

Yukarıdaki örneklerde görebiliyorsunuz. Tablomun adı Kullanıcılar. Bu Kullanıcılar tablomdaki her kolon adının başında ( ku_ ) işaretçisi var. Bu işaretçi, bu kolonların Kullanıcılar tablosuna ait olduğunu işaret ediyor. 5, 10 tablolu projelerde önemsemeyebilirsiniz ancak büyük projelerde olması gerektiğini düşünüyorum. Çünkü projeler büyüdükçe, daha karmaşık konulara girmeniz gerekiyor.

Örnek olarak cari, stok, borç, alacak, çek, senet, banka, fatura, tahsilat gibi bir çok modülü olan bir projede bir carinin ekstresi’ni çıkarmak için kaç tane tabloya dokunmanız gerekiyor. Nasıl bir karmaşıklıkta sorgu yazmanız gerekiyor? Bu tabloların her birinde cari kodunun tutulduğu kolonun adı Cari_Kodu olduğunu varsayalım.

Cari Extresi’nde birleştirici nokta Cari_Kodu kolonudur. Ancak biz her tabloda aynı adı verdiğimizde, where kısmını veya iç sorguları hazırlarken hangi tablonun Cari_Kodu’nu, hangi tablonun Cari_Kodu’na eşitlediğimizi nasıl anlayacağız?

• Tahsilatlar, tah_Cari_Kodu
• Bankalar, ban_Cari_Kodu
• Faturalar, fat_Cari_Kodu
• Çekler, cek_Cari_Kodu

gibi tablo işaretçileri ile kolon adlarını yazdıktan sonra where kısmını hazırlarken en ufak bir şüphe olmadan sorgumuzu yazabilir ve yanlış kolon eşitlemeleri yüzünden saçma sapan sorunlar ile uğraşmak zorunda kalmamış oluruz.

Kolon Adları ve Veri Tipleri

Kolonları hazırlarken, aşırı kısaltma kullanmamaya çalışın. Neden kısaltma kullanmak zorundasın ki? Örnek olarak bir kısaltma kullanalım ve bir kolon adı yazalım. fat_sat_ack1 bu kısaltmadan ne anlıyorsunuz? Bu kolonun amacı fatura 1. satır açıklaması idi. Bu kolonu kısaltmalı yazsam ne kaybederim? fat_satir_acikalama1 olarak yazsam ne kaybederim?

Net olarak bilmemekle ve yaptığım deneme ile 60 karakter uzunluğunda bir kolon başlığı yazabildim. Şahsen 60 karakter uzunluğunda da bir kolon başlığı yazmamı gerektirecek etiket düşünemiyorum. Yani aşırı kısaltma yapmadan yazabilecek kadar geniş bir alanımız var.

Aynı şey tablo adları içinde geçerli. Aşırı kısaltmalardan kaçınmamız gerektiğini düşünüyorum. CARI_HESAP_ADRESLERI olarak düşündüğümüz bir tabloyu CARI_HSP_ADR  gibi bir kısaltma ile yazmamızın hiçbir anlamı olmadığını düşünüyorum.

Programlamada SQL Sorgularını Okunaklı Yazmak yazımda bu kadardı arkadaşlar. Bu sektörde olduğum süre boyunca elde ettiğim tecrübelerden derlenmiş bir kaç nacizane tavsiyemdir. Elimden geldiğinde okunaklı kod yazmaya çalışıyorum ve çevremdekilere de veritabanı ve okunaklı kodlama konusuna dikkat etmeleri için tavsiyeler vermeye ve almaya çalışıyorum.

Dürüst olacağım, benden başkası anlamasın diye her şeyi aşırı kısaltmış ve şifreleri şeyler yazanlara çok küfür ediyorum.  Bu bir profesyonellik değildir. Tamam, başkasının anlamaması egolarını tatmin edebilir ama başka neye yarar? Böyle insanların arkasından herkes küfür eder. Bu sadece bana özgü bir şey değil.

Profesyonellik, başkasının anlayamamasını sağlamak değil, herkesin anlayabilmesini sağlayabilmektir.

Herkesin amacı bu olsaydı, internette tek bir kaynak bulamazdık. Bende alacağım tepkilere rağmen bu yazıyı ve bu yoruma zahmetine girmezdim.

Diğer yazılarıma gitmek isterseniz buraya tıklayabilirsiniz.

Bol kodlu günler… ^_^

Sağlıcakla ve takipte kalın.

Bana destek olmak isterseniz bir kahve ısmarlayabilirsiniz veya diğer hesaplarımdan takip edebilirsiniz.

The post Veritabanı ve Okunaklı Kodlama İçin Tavsiyeler appeared first on Dinamik Network.

SQL Server, T-SQL hakkında ilk yazımı yazıyorum. Esasında ilk başta temel yapılardan başlamayı düşünmüştüm ancak bu sefer farklı bir başlangıç yapmak istedim. Bu sebeple bu yazıyı okuyan kişilerin MS-SQL hakkında temel bilgileri bildiklerini varsayıyorum.

Bu yazıda piyasada Code Generator olarak bilinen yapıyı kendimiz oluşturacağız. Code Generator ne demek diyecek olursanız bizim Entity‘lerimizi kolayca üretmeyi sağlayan bir exedir. Entity nedir diye soracak olursanız da veritabanı üzerindeki tablolarımızın modelleridir diyebiliriz. Code Generator denen exe esasında arka tarafında birazdan yazacağımız bir SQL bloğu çalıştırmakta, sonuçlarını göstermektedir.

C# Entity Class Oluşturma

Evet, artık başlayalım. SQL Server’ı açalım. SQL Server verisyonum 2017 Developer Edition. Entity oluşturmak istediğim tablo da LogRecord tablosu. Aşağıdaki resimde de görebileceğiniz gibi çok olmasa da hatırı sayılabilecek alan sayısı olduğunu söylenebilir.

Şimdi bu kısımda SQL Server bize View’leri sayesinde yardımcı olacak. SQL Server’ın özel viewleri hakkında detaylı bilgiyi aşağıdaki linkten edinebilirsiniz.

https://docs.microsoft.com/en-us/sql/relational-databases/system-catalog-views/catalog-views-transact-sql?view=sql-server-ver15

Şimdi önce kolonlarımızı getirtelim. Aşağıdaki sorgu bize bu konuda yardımcı olacaktır.

SELECT * FROM sys.all_columns WHERE object_id = (SELECT OBJECT_ID ('LogRecord'))

Resimde sonuçlarını da görelim.

Artık kolonlarla ilgili olarak gerekli bilgiye sahibiz. Kolonların veri yapılarından kaynaklı olarak sahip oldukları özellikler de bu viewden bize gelmektedir. Şimdi bu tablodan bize system_type_id ve user_type_id isimli alanlar döndü. Yani aslında biz bu kolonların tiplerini de biliyoruz ama id değeri olarak biliyoruz. Bunların ne olduklarını bulabilmemiz için aşağıdaki sorgu bize yardımcı olacaktır.

SELECT * FROM sys.types

Sorgu sonucunu aşağıdaki resimde görebiliriz.

SQL Server üzerindeki tüm tipler ile ilgili bilgiler bu view üzerindedir. Şimdi tek yapmamız gereken sorguyu ayarlamak. Sorgumuzu parça parça yazıp geliştireceğiz. Şimdi bize lazım olan parçalar 2 view üzerinde olduğuna göre JOIN işlemi ile başlayabiliriz.

Şimdi sıra ihtiyacımız olan alanlar ile bu sorguyu düzenlemekte. Sorguyu aşağıdaki gibi düzenleyelim.

SQL Server – C# Veri Tipleri

Sorgumuz fena bir yere gelmedi aslında. Elimizde alan isimleri ve veri tipleri var ancak bu tipler SQL tipleri. Bizim oluşturacağımız entity hangi programlama dili içinse onun karşılığı veri tipini bulmalıyız. Esasında programlama dilleri içerisinde veri tipleri benzerlik göstermektedir. Ben C# programlama dilini baz alarak hareket edeceğim. C# veri tipleri ile ilgili detaylı bilgiye aşağıdaki linkten ulşabilirsiniz.

https://social.msdn.microsoft.com/Forums/tr-TR/379a88e0-ebd5-4666-9b73-e16f77698a38/c-deikenler-veri-tipleri?forum=csharptr

Şimdi sorgumuzun sondan bir önceki düzenlemesini yapalım. Sizin tablonuzda farklı tipler varsa yukarıdaki linkten yararlanarak C# karşılığını bulabilirsiniz. Ben sorgumu aşağıdaki hale getirdim.

Şimdi elimizde bir şeyler var. İsimler ve veri tipleri elimizde. Entity üzerinde değer setlenirken hiç bir kontrol yapmayacağım için Auto-implemented propertie haline getirmem yeterli olacaktır. Auto-implemeneted propertie kavaramının detaylı açıklamasına aşağıdaki linkten ulaşabilirsiniz.

https://docs.microsoft.com/tr-tr/dotnet/csharp/programming-guide/classes-and-structs/auto-implemented-properties

Sorguyu aşağıdaki hale getiriyoruz.

Şu an elimizde tablonun kolonları yani propertieleri var. Bu kadar yapmışken sınıfını da ayarlayalım. Sorguyu son kez değiştiriyorum.

Artık entitymiz hazır. Sorgu sonucunu alıp class yaratabiliriz. Bir DB üzerindeki tüm tabloları bu şekilde hızlıca Entity haline getirip modellerimizi hazırlayabilir, proje ya da projelerimize hızlıca entegre edebiliriz.

Bir sonraki yazıda yeniden görüşmek dileğiyle… Diğer T-SQL konularına ulaşmak için tıklayın.

The post SQL Server ile C# Entity Class Oluşturma appeared first on Dinamik Network.