Arama Sorgusu Dili

Arama sorgusu dili, Google Sorun Takip'te sorun aramaları yapmak için kullandığınız söz dizimidir. Bu dili, arama çubuğuna girdiğiniz arama sorgularında kullanabilirsiniz. Ölçütleri grafiksel olarak seçmek için arama oluşturucuyu da kullanabilirsiniz. Arama oluşturucu kapatıldığında ölçütler sorgu diline dönüştürülür.

Sorgu dili, aşağıdaki ölçütlere göre arama yapmanıza olanak tanır:

  • Anahtar kelimeler
  • Alan/değer çiftleri

Yaptığınız aramalar, anahtar kelimeler ve alan:değer çiftlerinin bir kombinasyonu da dahil olmak üzere birden fazla ölçüt içerebilir. Sorgu dili söz dizimi, mantıksal operatörleri, parantezleri ve tırnak işaretlerini kullanarak ölçütlerin dikkate alınma ilişkisini ve sırasını belirtmenize olanak tanır.

Anahtar kelime aramaları

Anahtar kelimeler, sorunlarda belirli alanlarda arama yapmak için kullanabileceğiniz metin dizeleridir. Bu alanlar şunlardır:

  • Başlık
  • Yorumlar
  • Eklerin adları
  • Kullanıcı içeren alanlar (ör. Atanan veya CC)
  • Dahili kimlik numarası içeren alanlar (ör. bileşeni belirten veya sorun içeren önemli listeler)
  • Sürüm numaralarını içeren alanlar
  • Özel alanlar

Anahtar kelime arama ölçütlerine örnek olarak configuration properties dizesi verilebilir. Bu ölçütleri bir aramaya girdiğinizde, Sorun Takip Aracı tüm bileşenlerdeki sorunları dünya genelinde arar ve erişim denetimi izinleriniz doğrultusunda, alanları her iki anahtar kelimeyi de içeren sorunları döndürür. Anahtar kelimeler farklı alanlarda veya aynı alanlarda olabilir.

Anahtar kelimeler bazı temel eş anlamlı kelimelerle de eşleşeceğinden, property araması yaparken properties kelimesini içeren bir hata da bulunabilir. Aksi takdirde aramalar, sorguyu alt dize olarak ele almak yerine yalnızca tam kelime jetonlarını eşleştirir.

Çoğu özel karakter, arama yapmadan önce anahtar kelimelerden kaldırılır. Örneğin, my-query_text gibi bir sorgu my ve query_text jetonlarına bölünür ve her iki jetonla da eşleşen hataları döndürür.

Sorun Takip Aracı, arama ölçütlerini ayıran boşluk karakterini gizli bir AND operatör olarak kabul eder. Birden fazla kelimeden oluşan bir dizenin tek bir anahtar kelime olarak kabul edileceğini belirtmek için tırnak işareti (") kullanabilirsiniz. Issue Tracker'daki tüm aramalar, tırnak işareti kullanıp kullanmadığınıza bakılmaksızın büyük/küçük harfe duyarlı değildir.

Alan:değer çifti aramaları

Arama ölçütlerini alan:değer çifti olarak da belirtebilirsiniz. Temel söz dizimi [field]:[value] şeklindedir. Metin alanları için bu söz dizimi, belirtilen alanın değeri içerdiği sorunları eşleştirir. Diğer alan türleri için, alan değerinin eşdeğer olduğu sorunları eşleştirir.

Örneğin, title:latency araması, Başlık alanında latency kelimesinin bulunduğu sorunları eşleştirir. priority:p0 için yapılan aramada, önceliği p0 olan sorunlar bulunur.

Tanınmayan alanlar anahtar kelime araması olarak yorumlanır.

Zaman ve sayı alanları için iki nokta karakterinin yanı sıra diğer ilişkisel sembolleri de kullanabileceğinizi unutmayın. İlişkisel operatörler başlıklı makaleyi inceleyin.

any ve none kullanılan özel değer aramaları

İsteğe bağlı alanlar any ve none özel değerleriyle sorgulanabilir. any, boş olmayan tüm değerlerle eşleşir. none, null değerlerle eşleşir. Arama sorgusu dilinde desteklenen tüm alan etiketlerinin listesi için Arama Sorgusu Referansı başlıklı makaleyi inceleyin.

Mantıksal operatörler

Mantıksal operatörler, birden fazla ölçüt belirtmenize ve bunlar arasındaki ilişkiyi belirtmenize olanak tanır. Tırnak işaretlerinin dışındaki boşluk karakterleri, gizli AND operatörleri olarak çalışır. Sorun Takip Aracı, aşağıdaki açık mantıksal operatörleri destekler:

Operatör Alternatif simge Açıklama Örnek
VE {whitespace} Sorun her iki ölçütü de içeriyorsa eşleşir star:true AND componentid:46046
VEYA | Sorun bu ölçütlerden birini içeriyorsa eşleşme type:(Bug|feature_request)
DEĞİL - Sorun ölçütleri içermiyorsa eşleşir -assignee:jim
"..." Sorun, tırnak içine alınmış bir ifade içeriyorsa (tırnak içindeki kelimeler aynı sırada görünüyorsa) eşleşir. comment:"We have a problem"
( ) Değerleri veya arama ölçütlerini bir arada gruplandırır. status:open AND (priority:(p0|p1) OR severity:(s0|s1))

Aşağıdakileri göz önünde bulundurun:

  • AND, OR ve NOT için tümüyle büyük harf kullanmanız gerekir.

  • NOT operatörü, alan adından veya alan değerinden önce gelip gelmediğine bakılmaksızın aynı anlama sahiptir. Bu, -assignee:jim ve assignee:-jim'un eşdeğer olduğu anlamına gelir.

  • Arama sorgusundaki terimleri net bir şekilde gruplandırmak için parantez kullanın. Varsayılan olarak Sorun Takip Aracı, NOT terimini yalnızca hemen ardından gelen terimle ilişkilendirir ve OR terimini, etrafını saran iki terimle gruplandırır. Örneğin, title:(a OR b NOT c AND d) arama sorgusu title:((a OR b) AND (NOT c) AND d) ile eşdeğerdir.

Kısa Çizgiler

kısa çizgi karakterinin (-) arama sorgusundaki bağlama göre farklı anlamları vardır:

  • Sorun Takip Aracı, aramadaki bir kelimeden önce gelen kısa çizgiyi NOT operatörü olarak değerlendirir. Örneğin, -assignee:none veya assignee:-none arama ölçütü, atanmış kullanıcısı olan tüm sorunları döndürür.

  • Sorun Takip Aracı, tire karakteriyle bağlanan dizeleri tırnak içine alınmış olarak değerlendirir. Örneğin, state-of-the-art arama ölçütü "state of the art" ile eşdeğerdir.

  • Sorun Takip Aracı, sorun alanındaki kısa çizgiyle birleştirilmiş kelimeleri boşlukla ayrılmış bağımsız kelimeler olarak kabul eder. Yani, başlığında state-of-the-art kelimesi bulunan bir sorun için title:(of art state the) veya title:("state of the art") arama sorgusunu çalıştırırsanız sorun, arama sonuçlarının bir parçası olarak döndürülür.

İlişkisel operatörler

Alan:değer arama ölçütlerinin temel söz dizimi [field]:[value]'tür. Burada iki nokta üst üste karakteri (:), bir sorunun arama sonuçlarında döndürülebilmesi için belirtilen alanın belirtilen değere eşit veya bu değeri içermesi gerektiğini belirtir.

Zaman değeri (created, modified, resolved, verified ve belirli özel alanlar) veya sayı değeri (duplicatecount, votecount, commentcount ve cccount) içeren alanlar aşağıdaki ek ilişkisel operatörleri destekler:

Sembol Açıklama
< Değeri, arama değerinizden küçük veya arama değerinizden önceyse bir sorunla eşleşir.
<= Değeri arama değerinizden az, arama değerinizden önce veya arama değerinize eşitse bir sorunla eşleşir.
> Değeri, arama değerinizden büyük veya arama değerinizden sonra geliyorsa bir sorunla eşleşir.
>= Değeri arama değerinizden büyük, arama değerinizden sonra veya arama değerinize eşitse bir sorunla eşleşir.

Zaman aramaları

Arama sorgusu dili, zaman değeri içeren alanları eşleştirmek için özel bir söz dizimi sağlar. Bu sayede Sorun Takip Aracı, gerektiğinde bir zaman aralığında veya göreli zamanlarda arama yapabilir.

Mutlak saat biçimi

Saat belirtmek için kullanılan biçim:

[yyyy]-[MM]-[dd]T[HH]:[mm]:[ss].

Bu biçimde [yyyy] 4 basamaklı yıl, [MM] 2 basamaklı ay, [dd] 2 basamaklı gün, [HH] 24 saatlik saatin 2 basamaklı saati, [mm] dakika ve [ss] saniyedir. Tarih ve saat ayarlarınızda farklı bir saat dilimi seçmeniz durumunda bile aramalardaki tüm saatler UTC olarak yorumlanır.

Belirli bir zamanda veya zamandan önce ya da sonra oluşturulan sorunları ararken ayrıntı düzeyini belirtebilirsiniz. Örneğin, Haziran 2014'te herhangi bir zamanda oluşturulan sorunları bulmak için created:2014-06 değerini belirtebilirsiniz. Daha ayrıntılı arama yapmak için created:2014-06-03T04 ile 3 Haziran 2014'te 4. saatte (UTC saatine göre 04:00 ile 05:00 arasında) oluşturulan sorunları arayabilirsiniz.

Zaman aralıkları

alan:değer arama ölçütlerinde bir zaman aralığı belirtmek için iki nokta karakteri (..) kullanabilirsiniz. Söz dizimi [field]:[start time]..[end time]. Başlangıç ve bitiş zamanları istediğiniz düzeyde ayrıntılı olabilir. Örneğin, verified:2013..2015 2013, 2014 veya 2015'te doğrulanan tüm sorunları döndürür.

Göreceli saat biçimi

Ayrıca, bugünden önceki gün sayısı olarak bir saat de belirtebilirsiniz. Bunu yapmak için [days]d biçimini kullanın. Burada [days], arama sonuçlarına dahil etmek istediğiniz geçmişteki gün sayısıdır. Örneğin, son beş gün içinde değiştirilen sorunları bulmak için modified:5d simgesini kullanabilirsiniz.

Göreli saat biçimi kullanıldığında operatör, created:5d gibi iki nokta üst üste karakteri (:) olmalıdır. Aralığa girmeyen sorunları bulmak istiyorsanız NOT veya - operatörünü kullanabilirsiniz.

Örneğin, -verified:10d son 10 gün içinde doğrulanmamış sorunları döndürür. Doğrulanmış ancak son 10 gün içinde doğrulanmamış sorunları bulmak için (-verified:10d) AND status:verified'ü kullanabilirsiniz.

Gün aritmetiği içeren "Bugün" aramaları

Zaman aramalarında today jetonunu mevcut tarihin yerine kullanabilirsiniz. today+10 ve today-2 gibi gün aritmetiğini destekler. today jetonu, today-2..today+3 gibi zaman aralıklarında da kullanılabilir. Kayıtlı aramalarda today jetonunu kullanmak, sorgunun yeniden kullanılabilir hale gelmesine yardımcı olur.

Örnekler:

  • created:today
  • modified<=today-10
  • nearestslo:today+10
  • resolved:2024-02-29..today+2
  • customfield1002:today..today+5

Uyarı: Mutlak saat biçiminde belirtildiği gibi, Sorun Takip'teki saat aramaları UTC'dedir. Aynı durum today kullanan aramalar için de geçerlidir.