Dilerseniz \u00f6ncelikle biraz NEST k\u00fct\u00fcphanesinden\u00a0bahsedelim.<\/p>\n NEST: ElasticSearch’e ba\u011flant\u0131 kurabilmemizi, indexleme ve sorgulama gibi i\u015flemleri yapabilmemizi sa\u011flayan ve ayn\u0131 zamanda\u00a0strongly typed ve fluent request’ler olu\u015fturabilmemize imkan tan\u0131yan bir k\u00fct\u00fcphanedir.<\/p><\/blockquote>\n NEST hakk\u0131nda detayl\u0131 bilgilere eri\u015fmek isterseniz\u00a0buradan<\/a>\u00a0inceleyebilirsiniz.\u00a0ElasticSearch makale serilerimiz boyunca NEST k\u00fct\u00fcphanesini kullan\u0131yor ve tan\u0131yor olaca\u011f\u0131z.<\/p>\n Kodlamaya ba\u015flayabilmek i\u00e7in “ElasticSearch” isminde bir Blank Solution olu\u015fturuyorum. ElasticSearch makale serisi boyunca bu solution alt\u0131ndan ilerlemeyi d\u00fc\u015f\u00fcn\u00fcyorum. Olu\u015fturmu\u015f oldu\u011fumuz solution’a, “ElasticSearch.Core.Common” ismine sahip bir Class Library ekleyelim. Bu Library i\u00e7erisinde\u00a0ihtiya\u00e7 duyaca\u011f\u0131m\u0131z ortak noktalar\u0131 toplayaca\u011f\u0131z. Bu i\u015flemin ard\u0131ndan Nuget Package Manager’a girerek, “ElasticSearch.Core.Common” projesine a\u015fa\u011f\u0131daki NEST k\u00fct\u00fcphanesini kural\u0131m.<\/p>\n Kurulum i\u015flemlerinin ard\u0131ndan, “ElasticHelper” isminde bir class ekleyelim ve i\u00e7erisini a\u015fa\u011f\u0131daki gibi kodlayal\u0131m.<\/p>\n ElasticHelper s\u0131n\u0131f\u0131 i\u00e7erisinde,\u00a0ihtiya\u00e7 duyabile\u011fimiz yard\u0131mc\u0131 niteli\u011findeki method’lar\u0131m\u0131z\u0131 kodlayaca\u011f\u0131z. \u00a0Burada Lazy\u00a0<\/strong>class’\u0131ndan faydalanarak ilgili helper’\u0131m\u0131z\u0131n tek bir instance’a sahip olmas\u0131n\u0131 sa\u011flad\u0131k. “GetConnectionSettings” method’unda ise, ElasticSearch’\u00fcn Client objesini yaratabilmemiz i\u00e7in ihtiya\u00e7 duydu\u011fu “ConnectionSettings” tipindeki instance’\u0131n\u0131\u00a0yarat\u0131p geriye d\u00f6n\u00fcyoruz. Instance yaratma i\u015flemi s\u0131ras\u0131nda ihtiya\u00e7 duydu\u011fu Elastic URI’\u0131n\u0131 ise, “System.Configuration” namespace’i alt\u0131nda bulunan “ConfigurationManager” arac\u0131l\u0131\u011f\u0131 ile “AppSettings” \u00fczerinden veriyoruz.<\/p>\n \u015eimdi\u00a0domain\u00a0entity’lerini tan\u0131mlamaya giri\u015f yapabiliriz.\u00a0Bunun\u00a0i\u00e7in bir Entity katman\u0131 olu\u015fturaca\u011f\u0131z.\u00a0“ElasticSearch.Data.Entities” isminde bir Class Library ekleyelim. Bu Library i\u00e7erisinde bahsetti\u011fimiz gibi elastic i\u00e7erisine index’leyecek oldu\u011fumuz domin entity’leri yer alacak. Library’i ekleme\u00a0i\u015fleminden sonra “Product” isminde ilk entity’mizi olu\u015ftural\u0131m. Bu entity a\u015fa\u011f\u0131daki gibi property’lere sahip olacak.<\/p>\n Burada dikkat etmemiz gereken baz\u0131 \u00f6nemli noktalar bulunmakta. Elastic \u00fczerinde verilerimizi store ederken, ilgili dok\u00fcman\u0131n yan\u0131 entity’nin her property’sini index’lememeliyiz<\/strong>. ElasticSearch sadece search<\/strong> i\u015flemlerimizi<\/strong> h\u0131zl\u0131 bir \u015fekilde yapabilmemizi sa\u011flayan bir ara\u00e7t\u0131r, veritaban\u0131 de\u011fildir. Evet veritaban\u0131 olarak da\u00a0kullanabilirsiniz fakat bu i\u015flem sonucunda getirece\u011fi olumsuz etkilerle y\u00fczle\u015fmekte pek de ho\u015f olmayacakt\u0131r. \u00d6rnek vermek gerekirse, g\u00fcn ge\u00e7tik\u00e7e dok\u00fcman boyutlar\u0131n\u0131z artacak, search i\u015flemleri nispeten daha yava\u015f \u00e7al\u0131\u015fmaya ba\u015flayacak (ki i\u015fin i\u00e7ine aggregation’lar vb. girdik\u00e7e) ve verilerinizi\u00a0elastic’e aktar\u0131m s\u00fcreleriniz daha da uzayacakt\u0131r. B\u00fcy\u00fck\u00a0scale’e sahip ortamlarda i\u015fler git gide daha da zor olacakt\u0131r.<\/p>\n Kodlamam\u0131za \u015fimdi\u00a0Resource Access i\u015flemlerini yani indexing i\u015flemlerini ger\u00e7ekle\u015ftirecek oldu\u011fumuz Data katman\u0131 ile devam edelim. Bunun i\u00e7in Solution’a “ElasticSearch.Data” olarak bir Class Library daha ekleyelim. Eklemi\u015f oldu\u011fumuz Data katman\u0131na yine Nuget Package Manager \u00fczerinden NEST k\u00fct\u00fcphanesini kural\u0131m. Hen\u00fcz i\u00e7erisine hi\u00e7 bir class eklemeden, “ElasticSearch.Data.Contracts” isminde bir Class Library ekleyelim ve i\u00e7erisine a\u015fa\u011f\u0131daki gibi “IElasticContext” isminde bir interface tan\u0131mlayal\u0131m.<\/p>\n Bu interface ElasticContext’inin bar\u0131nd\u0131raca\u011f\u0131 method imzalar\u0131n\u0131 i\u00e7erecek. \u015eimdilik sadece “CreateIndex” method’u ile devam edece\u011fiz. Bu method elastic \u00fczerinde bir adet index yaratmam\u0131z\u0131 sa\u011flayacak. ElasticSearch’e giri\u015f makalesinde bahsetti\u011fimiz gibi index’ler, verilerimizin tutuldu\u011fu bir nevi veritaban\u0131d\u0131r. Bu sebeple herhangi bir dok\u00fcman eklemeden \u00f6nce bir index yaratmam\u0131z gerekmektedir.<\/p>\n Interface’i olu\u015fturduktan sonra geri d\u00f6n\u00fc\u015f tipimiz olan “IndexResponseDTO” objesini de tan\u0131mlayal\u0131m.<\/p>\n IndexResponseDTO ile de\u00a0olu\u015fturacak oldu\u011fumuz index sonu\u00e7lar\u0131n\u0131 geri d\u00f6n\u00fcyor olaca\u011f\u0131z.\u00a0\u015eimdi kald\u0131\u011f\u0131m\u0131z yerden devam edebiliriz ve olu\u015fturmu\u015f oldu\u011fumuz “ElasticSearch.Data” Library’sine “ElasticSearch.Data.Contracts” Library’sini Referans olarak g\u00f6sterip, i\u00e7erisine “ElasticContext” isminde yeni bir class olu\u015ftural\u0131m.<\/p>\n ElasticContext class’\u0131nda constructor injection y\u00f6ntemi ile d\u0131\u015far\u0131dan bir adet “ElasticClient” al\u0131yoruz. “CreateIndex<T>” method’unda ise “CreateIndexDescriptor” yaratarak, i\u00e7erisinde fluently bir \u015fekilde “Mappings” ve “Aliases” tan\u0131mlamalar\u0131m\u0131z\u0131 yap\u0131yoruz. Mappings<\/strong> ile elastic \u00fczerinde verilerimizin\u00a0nas\u0131l tutulaca\u011f\u0131n\u0131 tan\u0131mlarken, Aliases<\/strong> sadece index’imizin takma ismidir. Yani sorgulama yaparken daha k\u0131sa bir isim \u00fczerinden ilgili index’e eri\u015febilmek i\u00e7indir.<\/p>\n Not<\/strong>: Aliases’\u0131n bir ba\u015fka faydas\u0131 ise, production ortamlar\u0131nda bir index \u00fczerinde \u00e7al\u0131\u015f\u0131rken g\u00fcncelleme veya yeniden atma(reindex) gibi ihtiya\u00e7lar\u0131m\u0131z do\u011fdu\u011funda, production \u00fczerindeki index’i bozmadan farkl\u0131 bir index ismi ile veri ba\u015ftan at\u0131l\u0131r\/g\u00fcncellenir. Daha sonra sadece saniyeler i\u00e7erisinde ilgili alias<\/strong>\u00a0eski index \u00fczerinden\u00a0silinir, yeni at\u0131lan index’e verilir. Bu sebeple alias’lar unique<\/strong> olmal\u0131d\u0131r. Bu sayede hi\u00e7bir risk ve kesinti olmadan index de\u011fi\u015ftirebilmek m\u00fcmk\u00fcn olacakt\u0131r.<\/p><\/blockquote>\n Daha sonra d\u0131\u015far\u0131dan inject etti\u011fimiz “_elasticClient” \u00fczerinden “CreateIndex” method’unu \u00e7a\u011f\u0131rarak, tan\u0131mlam\u0131\u015f oldu\u011fumuz “createIndexDescriptor”\u00fc parametre olarak set ediyoruz. Bu i\u015flemlerin ard\u0131ndan ElasticClient<\/strong> bizim i\u00e7in HTTP \u00fczerinden bir REST\u00a0\u00e7a\u011fr\u0131s\u0131\u00a0ger\u00e7ekle\u015ftirecek. REST\u00a0\u00e7a\u011fr\u0131s\u0131 sonucunda elde edece\u011fimiz\u00a0response’u ise, “IndexResponseDTO” objesine map ederek, geriye d\u00f6n\u00fcyoruz.<\/p>\n \u015euan neredeyse haz\u0131r gibiyiz. Elastic’e verilerimizi aktar\u0131m i\u015flemlerimizi ger\u00e7ekle\u015ftirmek i\u00e7in ben bir adet Console Application se\u00e7iyorum. (On-Demand olarak \u00e7al\u0131\u015faca\u011f\u0131 i\u00e7in) Solution i\u00e7erisine “ElasticSearch.DataTransfer” isminde bir Console Application ekliyorum ve Referans olarak “ElasticSearch.Core.Common”, “ElasticSearch.Data.Contracts”, “ElasticSearch.Data.Entities” ve “ElasticSearch.Data” projelerini ekliyorum. Hemen Nuget Package Manager’\u0131 a\u00e7arak, NEST k\u00fct\u00fcphanesini buraya da y\u00fckl\u00fcyorum. Art\u0131k bu proje i\u00e7erisinde\u00a0index<\/strong>, reindex<\/strong> veya\u00a0dok\u00fcman indexleme<\/strong> gibi i\u015flemleri ger\u00e7ekle\u015ftiriyor olaca\u011f\u0131z.<\/p>\n Program.cs i\u00e7erisini a\u015fa\u011f\u0131daki gibi kodlayal\u0131m.<\/p>\n \u0130lk olarak “Main” method’u i\u00e7erisine bakt\u0131\u011f\u0131m\u0131zda “indexName” ve “aliasName” field’lar\u0131n\u0131 AppSettings \u00fczerinden dolduruyoruz. “indexName” olu\u015ftururken dikkat edersek, ilk ba\u015fa index ismi ve alttan \u00e7izgi ile ay\u0131rd\u0131ktan sonra o anki tarih format\u0131n\u0131 saniyesine kadar al\u0131yoruz. Bunu yapmam\u0131zdaki sebep yukar\u0131da alias<\/strong>‘\u0131n \u00f6neminden bahsederken mevcut index’i bozmadan farkl\u0131 bir index’de atabilece\u011fimizden bahsetmi\u015ftik. \u0130\u015fte bu noktada\u00a0en son ne zaman index att\u0131\u011f\u0131m\u0131z\u0131 takip edebiliriz. Daha sonras\u0131nda\u00a0ise ElasticHelper’\u0131n “GetConnectionSettings” method’unu parametre olarak kullan\u0131p,\u00a0bir ElasticClient yarat\u0131yoruz. Yaratm\u0131\u015f oldu\u011fumuz bu ElasticClient’\u0131 “Data” katman\u0131 i\u00e7erisinde olu\u015fturmu\u015f oldu\u011fumuz ElasticContext’in constructor’\u0131na inject ediyoruz. Art\u0131k Context’imiz haz\u0131r durumda.<\/p>\n Daha fazla kod kalabal\u0131\u011f\u0131 yaratmamak i\u00e7in\u00a0private olarak “CreateIndex” isminde bir method yarat\u0131yoruz ve parametre olarak “ElasticContext, IndexName ve AliasName”\u00a0objelerini al\u0131yoruz. Daha sonra bu parametreleri kullanarak “elasticContext” \u00fczerindeki “CreateIndex<T>” method’unu \u00e7a\u011f\u0131rarak, “indexName” ve “aliasName” property’lerini set ediyoruz. Bu i\u015flemlerin sonucunda ise elde edecek oldu\u011fumuz response i\u00e7erisindeki “StatusMessage” property’sini Console yard\u0131m\u0131 ile ekrana yazd\u0131r\u0131yoruz.<\/p>\n Test i\u015flemlerine ba\u015flamadan \u00f6nce ilgili de\u011ferlerimizi\u00a0“App.config” i\u00e7erisine ekleyelim.<\/p>\n Dilerseniz “CreateIndex” method’u i\u00e7erisindeki “response” alan\u0131na bir debug koyal\u0131m ve QuickWatch’da \u00a0bir bakal\u0131m.<\/p>\n G\u00f6rd\u00fc\u011f\u00fcm\u00fcz\u00a0ilk index’imiz ba\u015far\u0131l\u0131 bir \u015fekilde olu\u015ftu. \u0130lgili sorgumuz Valid durumda ve “StatusMessage” i\u00e7eri\u011fine de bakarsak e\u011fer, “Valid NEST response built from a successful…” \u015feklinde devam ediyor. \u015eimdi do\u011frulamak ad\u0131na Sense plugin’i \u00fczerinden bir bakal\u0131m.<\/p>\n \u0130lk olarak Sense \u00fczerinden Mapping’i bir kontrol edelim. Bunun i\u00e7in a\u015fa\u011f\u0131daki sorguyu kullanal\u0131m.<\/p>\n Dikkat edersek GET verb’\u00fcnden sonra vermi\u015f oldu\u011fumuz aliasName’i kullan\u0131yoruz.<\/p>\n![\"elasticsearch-nest\"](\"\/wp-content\/uploads\/2016\/07\/elasticsearch-nest.png\")
<\/a><\/p>\nusing System;\r\nusing System.Configuration;\r\nusing Nest;\r\n\r\nnamespace ElasticSearch.Core.Common\r\n{\r\n public class ElasticHelper\r\n {\r\n private static readonly Lazy<ElasticHelper> _Instance = new Lazy<ElasticHelper>(() => new ElasticHelper());\r\n\r\n private ElasticHelper()\r\n {\r\n\r\n }\r\n\r\n public static ElasticHelper Instance\r\n {\r\n get\r\n {\r\n return _Instance.Value;\r\n }\r\n }\r\n\r\n #region Public Methods\r\n public ConnectionSettings GetConnectionSettings()\r\n {\r\n var connectionSettings = new ConnectionSettings(new Uri(ConfigurationManager.AppSettings[\"ElasticSearchURI\"]));\r\n\r\n return connectionSettings;\r\n }\r\n #endregion\r\n }\r\n}<\/pre>\nnamespace ElasticSearch.Data.Entities\r\n{\r\n public class Product\r\n {\r\n public int Id { get; set; }\r\n public string Name { get; set; }\r\n public string Description { get; set; }\r\n public decimal Price { get; set; }\r\n }\r\n}<\/pre>\nnamespace ElasticSearch.Data.Contracts\r\n{\r\n public interface IElasticContext\r\n {\r\n IndexResponseDTO CreateIndex<T>(string indexName, string aliasName) where T : class;\r\n }\r\n}<\/pre>\nusing System;\r\n\r\nnamespace ElasticSearch.Data.Contracts\r\n{\r\n public class IndexResponseDTO\r\n {\r\n public bool IsValid { get; set; }\r\n public string StatusMessage { get; set; }\r\n public Exception Exception { get; set; }\r\n }\r\n}<\/pre>\nusing ElasticSearch.Data.Contracts;\r\nusing Nest;\r\n\r\nnamespace ElasticSearch.Data\r\n{\r\n public class ElasticContext : IElasticContext\r\n {\r\n private readonly ElasticClient _elasticClient;\r\n\r\n public ElasticContext(ElasticClient elasticClient)\r\n {\r\n _elasticClient = elasticClient;\r\n }\r\n\r\n public IndexResponseDTO CreateIndex<T>(string indexName, string aliasName) where T : class\r\n {\r\n var createIndexDescriptor = new CreateIndexDescriptor(indexName)\r\n .Mappings(ms => ms\r\n .Map<T>(m => m.AutoMap())\r\n )\r\n .Aliases(a => a.Alias(aliasName));\r\n\r\n var response = _elasticClient.CreateIndex(createIndexDescriptor);\r\n\r\n return new IndexResponseDTO()\r\n {\r\n IsValid = response.IsValid,\r\n StatusMessage = response.DebugInformation,\r\n Exception = response.OriginalException\r\n };\r\n }\r\n }\r\n}<\/pre>\nusing System;\r\nusing ElasticSearch.Core.Common;\r\nusing ElasticSearch.Data;\r\nusing ElasticSearch.Data.Entities;\r\nusing Nest;\r\nusing System.Configuration;\r\n\r\nnamespace ElasticSearch.DataTransfer\r\n{\r\n class Program\r\n {\r\n static void Main(string[] args)\r\n {\r\n string indexName = string.Format(\"{0}_{1}\", ConfigurationManager.AppSettings[\"ElasticSearchIndexName\"],\r\n DateTime.Now.ToString(\"yyyyMMddHHss\"));\r\n string aliasName = ConfigurationManager.AppSettings[\"ElasticSearchIndexName\"];\r\n\r\n var elasticClient = new ElasticClient(ElasticHelper.Instance.GetConnectionSettings());\r\n var elasticContext = new ElasticContext(elasticClient);\r\n\r\n CreateIndex(elasticContext, indexName, aliasName);\r\n\r\n Console.ReadKey();\r\n }\r\n\r\n private static void CreateIndex(ElasticContext elasticContext, string indexName, string aliasName)\r\n {\r\n var response = elasticContext.CreateIndex<Product>(indexName, aliasName);\r\n\r\n Console.WriteLine(response.StatusMessage);\r\n }\r\n }\r\n}<\/pre>\n<?xml version=\"1.0\" encoding=\"utf-8\" ?>\r\n<configuration>\r\n <startup>\r\n <supportedRuntime version=\"v4.0\" sku=\".NETFramework,Version=v4.5.2\" \/>\r\n <\/startup>\r\n <appSettings>\r\n <add key=\"ElasticSearchURI\" value=\"http:\/\/localhost:9200\"\/>\r\n <add key=\"ElasticSearchIndexName\" value=\"product_search\"\/>\r\n <\/appSettings>\r\n<\/configuration><\/pre>\n
![\"create-index-elastic\"](\"\/wp-content\/uploads\/2016\/07\/create-index-elastic.jpg\")
<\/a><\/p>\nGET product_search\/_mapping<\/pre>\n
![\"sense-mapping\"](\"\/wp-content\/uploads\/2016\/07\/sense-mapping.jpg\")
<\/a><\/p>\n