Tüm Ürünler
Search
Belge Merkezi

OpenSearch:Dizin araması - sorgu yan tümcesi

Son Güncelleme:Oct 06, 2026

Bu konu, dizin araması için query yan tümcesinin sözdizimini ve kullanımını açıklar.

Genel Bakış

Her arama isteğinde query yan tümcesi gereklidir. Bu yan tümce, belirli bir dizin alanında neyin aranacağını belirtir; AND, OR, ANDNOT ve RANK gibi mantıksal işleçler kullanarak birden çok sorgu koşulu arasındaki ilişkiyi tanımlar.

Örneğin, title ve subject gibi iki TEXT türü alanı, default adlı tek bir bileşik dizinde birleştirebilirsiniz. default dizininde arama yaptığınızda sistem, arama sorgusunun title veya subject kaynak alanlarının içeriğiyle eşleştiği belgeleri döndürür.

Alternatif olarak, yalnızca title alanına dayalı title_search adlı bir dizin oluşturursanız title_search dizinine yönelik sorgular, yalnızca arama sorgusunun title alanının içeriğiyle eşleştiği belgeleri döndürür.

Sözdizimi

Sorgu koşulları aşağıdaki biçimleri kullanır:

Standart sorgu: index:'arama_sorgusu'^boost

Aralık araması: index:'circle(boylam_enlem,yarıçap)'

Aralık araması: index:[değer1,değer2]

  • index: İndeks şemanızda tanımlandığı şekilde aranacak dizin alanının adıdır. Arama, bu dizin alanını oluşturan kaynak alanlardan herhangi birinde arama sorgusunun geçtiği belgeleri bulur.

  • search query: Aramak istediğiniz içeriktir.

  • boost: Arama sorgusuna uygulanacak alaka artışıdır. Değer 0 ile 99 arasında bir tam sayı olmalıdır. Belirtilmezse varsayılan değer 99'dur. Bu parametre isteğe bağlıdır ve yalnızca kaba sıralama ifadesinde exact_match_boost() işlevi yapılandırıldığında etkili olur.

  • Aşağıdaki mantıksal işleçleri kullanarak birden çok sorgu koşulunu birleştirebilirsiniz: (), AND, OR, ANDNOT ve RANK. Bu işleçler büyük harfle yazılmalıdır. İşleçler öncelik sırasına göre en düşükten en yükseğe doğru şu şekilde değerlendirilir: RANK<OR<AND<ANDNOT<().

  • Tam ifade sorgusu yapmak için arama sorgusunu çift tırnak içine ("") alın. Tam ifade sorgusu, analiz edilen terimlerin orijinal ifadedekiyle aynı sırada ve konumda göründüğü belgeleri bulur.

  • Aralık araması, coğrafi konumlar ve sayısal aralıklar üzerinde sorguları destekler. Daha fazla bilgi için bkz. aralık araması.

Kullanım notları

  • **query yan tümcesi gereklidir ve boş bırakılamaz.**

  • **ANDNOT işleci tek başına kullanılamaz. ANDNOT işlecinin solundaki sorgu koşulu boş olmamalıdır; örneğin index_name:'' şeklinde olamaz.**

  • RANK işleci sorgunun sonunda değilse, örneğin index1:'xxx' RANK index2:'xxx' AND index3:'xxx' gibi bir durumda, RANK işlemini parantezlerle gruplamanız gerekir; örneğin: (index1:'xxx' RANK index2:'xxx') AND index3:'xxx'. Aksi takdirde sonraki tüm koşullar RANK işlemine dahil edilir ve sorgu index1:'xxx' RANK (index2:'xxx' AND index3:'xxx') olarak yorumlanır.

  • **Arama sorgusunu tek (' ') veya çift (" ") tırnak içine almanız gerekir. Aksi takdirde sorgu başarısız olabilir, sonuç döndürmeyebilir veya beklenmeyen davranışlar sergileyebilir.**

  • Bileşik bir dizin oluşturmak için yalnızca TEXT veya SHORT_TEXT alanlarını kullanabilirsiniz.

  • boost değeri 0'dan küçükse 0 olarak, 99'dan büyükse 99 olarak değerlendirilir.

  • Farklı arama türlerinin nasıl işlendiğine ilişkin daha fazla bilgi için bkz. yerleşik çözümleyici.

Örnekler

  1. title dizin alanında "Peking University" içeren belgeleri arayın:

    query=title:'Peking University'
  2. title dizin alanında hem "Peking University" hem de "Zhejiang University" içeren belgeleri arayın:

    query=title:'Peking University' AND title:'Zhejiang University'
  3. title dizin alanında "Peking University" veya "Zhejiang University" içeren ve type alanı "1" olan belgeleri arayın:

    query=(title:'Peking University' OR title:'Zhejiang University') AND type:'1'
  4. title dizin alanında "Peking University" veya "Zhejiang University" içeren belgeleri arayın. **Bu örnek, OR için alternatif bir sözdizimi gösterir**:

    query=title:'Peking University'|'Zhejiang University'
  5. title dizin alanında Peking University içeren ancak Tsinghua içermeyen belgeleri arayın. title ayrıca President içeriyorsa bu belgeleri daha yüksek sıralayın:

    query=(title:'Peking University' ANDNOT title:'Tsinghua') RANK title:'President'
    // The fine sort expression is: text_relevance(title)
  6. title dizin alanında tam olarak Peking University ifadesini içeren belgeleri arayın. Bu, "University of Beijing" gibi benzer ancak ayrı terimler içeren belgelerin eşleşmesini engeller:

    query=title:"Peking University"
  7. INT_ARRAY türünde bir alanı arayın:

    // Assume you have an INT_ARRAY field indexed as arr_index_1.
    // This query retrieves any document where the array contains the value 1.
    query=arr_index_1:'1'
  8. LITERAL_ARRAY türünde bir alanı arayın: LITERAL_ARRAY, her bir öğesi belirteçlere ayrılmayan ve yalnızca tam eşleşmeyi destekleyen dize sabitlerinden oluşan bir dizidir. tags_index olarak indekslenmiş bir LITERAL_ARRAY alanınız olduğunu varsayalım:

    // The document is retrieved if any element in the array is an exact match for 'Red'.
    // Note: Because LITERAL_ARRAY performs an exact match, the search query must be identical to an array element. For example, if an element is 'Peking University', a search for 'Peking' does not return a match.
    query=tags_index:'Red'
    
    // Search for documents where the array contains either 'Red' or 'Blue'.
    query=tags_index:'Red' OR tags_index:'Blue'