:Eş anlamlı sözlük dosyalarını yönetin

Kullanım notları ve en iyi uygulamalar

Eş anlamlı sözlük dosyalarını yüklemeden veya yönetmeden önce aşağıdaki kritik noktaları gözden geçirin.

Küme durumu ve yeniden başlatma etkisi

• Küme sağlığı: Yükleme işleminden önce Elasticsearch kümenizin sağlıklı durumda olduğundan emin olun.

• Otomatik yeniden başlatma: Yeni bir eş anlamlı sözlük dosyası yüklemek, kümenizin otomatik olarak rolling (yuvarlanan) şekilde yeniden başlatılmasına neden olur. Yeniden başlatma sırasında sistem, tüm düğümlerdeki eş anlamlı sözlükleri günceller.

• Yeniden başlatma süresi: Yeniden başlatmanın tamamlanması ve sözlük güncellemelerinin etkin hale gelmesi için gereken süre; kümenizin teknik özelliklerine, veri hacmine ve mevcut yüküne bağlıdır.

• Kesinti riski:

  • Düşük etki (Önerilen): İndekslerinizde çoğaltma parçaları bulunuyorsa ve küme yükü normal seviyedeyse (CPU ~%60, heap ~%50, NodeLoad_1m < vCPU sayısı), kümeniz rolling yeniden başlatma sırasında genellikle hizmet vermeye devam edebilir.

  • Yüksek etki (Kaçınılmalı): İndekslerinizde çoğaltma parçaları yoksa veya küme yoğun yazma/sorgu işlemleri nedeniyle aşırı yüksek yük altındaysa, yeniden başlatma sırasında kümeye erişim zaman aşımına uğrayabilir. İş etkisini en aza indirmek için istemci uygulamalarınızda erişim yeniden deneme mekanizması uygulayın.

• Zamanlama: Küme yeniden başlatması ve olası kaynak tüketimi nedeniyle eş anlamlı sözlük dosyalarını yoğun olmayan saatlerde yüklemenizi şiddetle tavsiye ederiz.

Mevcut indeksler üzerindeki etkisi

• Yeni sözlük dosyaları ve mevcut indeksler: Yeni yüklenen veya güncellenen bir eş anlamlı sözlük dosyası, mevcut indeksler için otomatik olarak etkinleşmez. Bunun nedeni, mevcut indekslerin analizör yapılandırmalarını otomatik olarak yeniden yüklememesidir.

• Mevcut indekslere uygulamak için: Yeni sözlüğün mevcut indeksleri etkilemesini istiyorsanız aşağıdaki yöntemlerden birini seçin:

  • Verileri yeniden dizine ekleyin: Eş anlamlı sözlük güncellendikten sonra bu indekslerdeki verileri yeniden dizine ekleyin (reindex). Bu işlem genellikle hizmetleri kesintiye uğratmaz.

  • İndeksleri yeniden açın: Etkilenen indeksleri kapatıp tekrar açın. Bu işlem, ilgili indeksler için hizmet kesintisine neden olur.

    ---index_name specifies the name of an index.
    POST <index_name>/_close
    POST <index_name>/_open

Eş anlamlı sözlük dosya biçimi ve kuralları

• Dosya türü: Eş anlamlı sözlük dosyası, UTF-8 kodlamalı düz bir TXT dosyası olmalıdır.

• İçerik: Dosyadaki her satır yalnızca bir eş anlamlı ifade içermelidir.

• Kural türleri: Eş anlamlı ifadeler hem Solr kurallarını hem de WordNet kurallarını destekler.

• Örnek biçimler:

  ipod, i-pod, i pod
  computer, pc, laptop

Çakışmalar ve adlandırma kuralları

• Durma kelimesi çakışmaları: Elasticsearch kümenizin durma kelimesi (stopword) listesi, eş anlamlı sözlük dosyanızda belirtilen anahtar kelimeleri içermemelidir. Çakışmalar, sözlüğü yüklediğinizde veya başka değişiklikler yaptığınızda küme günlüklerinde hatalara neden olur.

• Dosya adı değişiklikleri: Kullanımda olan bir eş anlamlı sözlük dosyasının adını değiştirmekten kaçının. Bu işlem, ilgili sözlüğe bağlı olan indekslerde anormalliklere yol açabilir.

Yordam

Sonraki adımlar: Eş anlamlıları uygulama ve doğrulama

Eş anlamlı sözlük dosyasını yükledikten ve kümenin yeniden başlamasına izin verdikten sonra, indeks analizörlerinizi yeni sözlüğü kullanacak şekilde yapılandırın.

1. Kümenin Kibana konsolunda oturum açın.

2. Eş anlamlı analizörü kullanan bir indeks oluşturun (veya mevcut bir indeksi yeniden dizine ekleyin/yeniden açın). İndeks ayarlarınızı ve eşlemelerinizi tanımlarken, yüklenen sözlük dosyanızı işaret etmek üzere synonyms_path parametresini belirtin (örneğin, "synonyms_path": "analysis/your_dict_name.txt").

   Ayrıntılı talimatlar için bkz.: Use synonyms ve Using Synonyms (Elasticsearch belgeleri).

3. Test verilerini yükleyin ve eş anlamlıların beklendiği gibi çalıştığını doğrulamak için arama testleri gerçekleştirin.