Amaç
ElasticSearch (Aslında ElasticSearch eski adı, artık Elastic olarak anılıyor fakat bende alışkanlık oldu, ElasticSearch olarak yazacağım), büyük ölçekli, açık kaynak kodlu bir arama motorudur. Apache Lucene üzerine kurulmuş bir yapısı vardır ve kulağa en hoş gelen özelliği sunduğu REST API sayesinde, kolaylıkla kullanılabilir olmasıdır. Bu tutorialde sizlere Elasticsearch’ün anahtar konseptlerinden bahsetmeye çalışacağım.
Sense ile Elasticsearch REST API Kullanımı
Elastic’i indirip, bir instanceına sahip olduğunuz andan itibaren, artık sizinle REST API üzerinden JSON bazlı olarak localhost’un 9200 portundan konuşan bir Elasticsearch cluster’ına sahip olmuş oluyorsunuz. Bu durumun doğal sonucu olarak, herhangi bir HTTP Client’ı kullanarak, Elastic ile konuşabilir hale geliyorsunuz. Elasticsearch’ün kendi dökümantasyonunda genelde Sense ya da CURL komutları ile örneklemeler yapılmıştır. Herneyse, eğer siz Sense ya da CURL kullanmaya istekli değilseniz, herhangi bir grafiksel HTTP client uygulamasını bilgisayarınıza indirerek kurabilirsiniz.
Daha proaktif olsun farklı bir çözüm ama kullanışlı bir çözüm arıyorum diyorsanız, size Google Chrome’un bir extensionu olan Sense pluginini önerebilirim. Plugini buradan ekleyebilirsiniz. Sense plugin sayesinde Elastic’in REST API’sine basit ve prettify edilmiş bir UI üzerinden ulaşmanız mümkün. Burada ayrıca pluginin bir özelliği olarak Autocomplete ile Elastic’in query syntaxına kolaylıkça adapte olabilirsiniz. Bir request’i run etmeniz için CTRL+Enter demeniz yeterli.
Bu tutorial boyunca, sizlere Marvel -> Sense üzerinden Curl requestleri kullanarak elastic üzerinde işlem yapma konusunda bilgi aktarımı sağlayacağım. Bu nedenle sizlere önceki yazımda anlattığım Marvel plugin’ini kurmayı şiddetle tavsiye ediyorum.
CRUD
İlk aşama olarak her ne kadar Elastic’i arama işlemleri için kullanmayı istesek de, ilk aşamada yapmamız gereken, bir index populate etmek ve içerisine data yerleştirmek. Elastic açısından aslında CRUD işlemi bir indexleme işlemidir ve ilk öğrenmemiz gereken şey, update, read, delete ve create işlemlerinin nasıl olduğudur.
Indexleme İşlemi Ne Demektir ?
Elasticsearch için indexleme işlemi, CRUD metninin içerisinde geçen iki harfin yani “Create” ve “Update” in karşılığıdır. Eğer bir dökümanı bir type ve document id ile indexlersek, aslında eğer böyle bir döküman yoksa ekleme yapılır, ya da aynı tip ve document id içeren bir kayıt varsa bu durumda da overwrite işlemi yapılır yani mevcut silinir, üzerine yazma işlemi yapılır.
Dilerseniz hep birlikte, ilk indexleme işlemimizi yapalım. HTTP açısından bir JSON objemizi Elastic Engine’e göndermek için POST ya da PUT request göndermemiz gerekmektedir. Eğer dökümanın ID değerini biliyorsak, bu durumda PUT, bilmiyorsak POST kullanmamız gerekiyor.
Gelin index, type, document id terimleri iyice kafamızı karıştırmadan önce bir bu terimlere değinelim.
Index
Index, relational bir veritabandaki veritabanına benzer anlam taşır. İçerisinde çok sayıda type barındırabilir. Bir index aslında, bir ya da daha fazla shard’ın mantıksal namespace’i anlamına gelmektedir. Elasticsearch’e bir indexleme işlemi yapılırken, ilgili index henüz yaratılmamış ise, Elastic kendisi bu indexi otomatik olarak yaratır.
Type
Type aslında, ilişkisel bir veritabanındaki tablolara benzemektedir. Her bir type içerisinde field listesi barındırır ve ilgili type’a özeldir. Elasticsearch indexleme sürecindeki mapping süreci aslında, type içerisindeki field’lerin nasıl analiz edildiği ile ilgilidir.
Document
Document aslında bir JSON metninin Elastic’de tutulan haline deniyor. Nasıl index database i , type o database in içerisindeki bir tabloyu ve field o tablonun sütunlarını ifade ediyorsa, document’de tablodaki bir satırı ifade ediyor. Her bir döküman aslında index + type + id den oluşan bir bilgi anlamına geliyor. Elastic ile aklınıza gelen tüm JSON metinlerini indexlemeniz mümkündür.
Field
Bir döküman, aslında bir tablodaki bir satırı ifade eder dediğimize göre, bu tablodaki sütunları ifade eden döküman, aslında field listesinden meydana gelmektedir. Herhangi bir field’a gelen değer, bir simple data da olabilir (integer, long, date, string vb. ) , kompleks bir tip de olabilir (array ya da obje vb.). Yani field, bir tablodaki sütunlar anlamına gelmektedir. Field’lar map edilirken, her bir field’in tipi, Elastic tarafından otomatik olarak algılanır.
İlk Index
Terimlerin anlamlarını da kavradığımıza göre, pratik kazanmak için ilk request’imizi gönderelim.
|
1 2 3 4 5 6 7 8 9 10 |
PUT /library/books/1 { "title":"Oben On Elasticsearch", "name" : { "first":"Oben", "last":"Isik" }, "publish_date":"2015-06-21", "price":100.49 } |
Bu request içerisinde library -> index , books -> type ve 1 -> document id anlamına gelmektedir. İlgili dökümanın fieldları, title, name.first, name.last, publish_date ve price ‘dır.
Bu çağrıyı Elastic’e yaptığımız anda aşağıdaki yanıtı alırız;
|
1 2 3 4 5 6 7 |
{ "_index": "library", "_type": "books", "_id": "1", "_version": 1, "created": true } |
