Arama Sorgusu Dili

Arama sorgusu dili, Google Sorun İzleyici'de sorun aramaları yapmak için kullandığınız söz dizimidir. Arama çubuğuna girdiğiniz arama sorgularında bu dili kullanabilirsiniz. Ayrıca, ölçütleri grafiksel olarak seçmek için arama oluşturucuyu da kullanabilirsiniz. Bu daha sonra, arama oluşturucu kapatıldığında 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

Gerçekleştirdiğiniz aramalar, anahtar kelimelerin 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örler, parantez ve tırnak işaretleri kullanarak ölçütlerin dikkate alındığı ilişkiyi ve sıralamayı belirtmenize olanak tanır.

Anahtar kelime aramaları

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

  • Başlık
  • Yorum sayısı
  • Eklerin adları
  • Kullanıcı içeren alanlar (örneğin, Atanan veya CC)
  • Dahili kimlik numarası içeren alanlar (örneğin, bileşeni belirtenler veya sorun içeren etkin listeler)
  • Sürüm numaraları içeren alanlar
  • Özel alanlar

Anahtar kelime arama ölçütlerine örnek olarak configuration properties dizesi verilebilir. Bir aramaya bu ölçütleri girdiğinizde, Sorun İzleyici tüm bileşenlerdeki sorunları global olarak arar ve erişim denetimi izinlerinize tabi olduğu üzere yukarıdaki alanları her iki anahtar kelimeyi de içerenleri döndürür. Anahtar kelimeler farklı alanlarda veya aynı alanlarda olabilir.

Sorun İzleyici, boşluk karakterini ayıran arama ölçütlerini örtülü bir AND operatörü olarak işler. Birden çok kelimeden oluşan bir dizenin tek bir anahtar kelime olarak dikkate alınmasını belirtmek için tırnak işaretleri (") kullanabilirsiniz. Sorun İzleyici'deki hiçbir arama, 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ında bu söz dizimi, belirtilen alanın değeri içerdiği sorunlarla eşleşir. Diğer alan türleri için alan değerinin eşdeğer olduğu sorunlarla eşleşir.

Örneğin, title:latency araması, Başlık alanındaki latency kelimesiyle ilgili sorunlarla eşleşir. priority:p0 araması yapıldığında önceliği p0 olan sorunlar bulunur.

Süre ve sayı alanlarında iki nokta karakterinin yanı sıra başka ilişkisel semboller de kullanabilirsiniz. Aşağıdaki İlişkisel operatörler bölümüne bakın.

Özel değer aramaları "herhangi" ve "hiçbiri" kelimelerini kullanarak yapma

İsteğe bağlı alanlar, any ve none özel değerleri ile sorgulanabilir. any, null olmayan herhangi bir değerle eşleşir. none, null değerlerle eşleşir. Arama sorgusu dilinde desteklenen tüm alan etiketlerinin listesi için Arama Sorgusu Referansı'na bakın.

Mantıksal operatörler

Mantıksal operatörler, birden fazla ölçüt belirtmenize ve bunlar arasındaki ilişkiyi belirtmenize olanak tanır. Yukarıda belirtildiği gibi, tırnak işareti dışındaki boşluk karakterleri, örtülü AND operatörleri olarak hareket eder. Sorun İzleyici aşağıdaki ek mantıksal operatörleri destekler:

Operatör Alternatif simge Açıklama Örnek
VE {boşluk} Sorun her iki ölçütü de içeriyorsa eşleşir star:true AND componentid:46046
VEYA | Sorun iki ölçütten birini içeriyorsa eşleşir type:(Bug|feature_request)
DEĞİL - Sorun kriterleri içermiyorsa eşleşir -assignee:jim
"..." Sorun, tırnak içine alınmış bir ifade içeriyorsa eşleşir (tırnaktaki kelimeler aynı sırada görünür) comment:"We have a problem"
( ) Değerleri gruplandırır veya ölçütleri 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 tamamen büyük harf kullanmanız gerekir.

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

  • Arama sorgusundaki terimleri net bir şekilde gruplamak için parantez kullanın. Varsayılan olarak, Sorun İzleyici NOT'yi yalnızca hemen ardından gelen terimle ilişkilendirir ve OR öğesini parantez içine alan 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.

Çizgiler

Kısa çizgi karakteri (-), arama sorgusundaki bağlama göre farklı anlamlara sahiptir:

  • Sorun İzleyici, aramada bir kelimenin önündeki kısa çizgiyi NOT operatörü olarak değerlendirir. Örneğin, -assignee:none veya assignee:-none arama ölçütleri, atananı olan tüm sorunları döndürür.

  • Sorun İzleyici, kısa çizgi karakteriyle bağlanan dizeleri tırnak işareti içine alınmış gibi işler. Örneğin, state-of-the-art arama ölçütü "state of the art" ile eşdeğerdir.

  • Sorun İzleyici, sorun alanındaki kısa çizgili kelimeleri boşlukla ayrılmış bağımsız kelimeler olarak işler. Yani, başlığında state-of-the-art kelimesi varsa ve title:(of art state the) veya title:("state of the art") arama sorgusunu yürütürseniz sorunun, arama sonuçlarının bir parçası olarak döndürüleceği anlamına gelir.

İlişkisel operatörler

Alan/değer arama ölçütünün temel söz dizimi [field]:[value] şeklindedir. Burada iki nokta üst üste karakteri (:), arama sonuçlarında bir sorun döndürülmesi için belirtilen alanın belirtilen değere eşit olması 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üçükse veya ondan önceyse sorunla eşleşir.
<= Değeri arama değerinizden az/önce veya arama değerinize eşitse sorunla eşleşir.
> Değeri arama değerinizden büyük/sonra bir sorunla eşleşir.
>= Değeri arama değerinizden büyük/sonrasında ya da ona eşitse sorunla eşleşir.

Saat aramaları

Arama sorgusu dili, zaman değeri içeren alanları eşleştirmek için özel bir söz dizimi sağlar. Bu, Sorun İzleyici'nin gerektiği şekilde bir zaman aralığı veya göreli zaman üzerinden arama yapmasına olanak tanır.

Mutlak zaman biçimi

Saat belirtme biçimi şu şekildedir:

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

Bu biçimde; [yyyy] 4 haneli yıl, [MM] 2 haneli ay, [dd] 2 haneli gün, [HH] 24 saatlik biçimde 2 haneli saat, [mm] dakika ve [ss] ikinci rakamdır. Tüm saatler UTC saat dilimindedir.

Belirli bir zamanda, öncesinde veya sonrasında oluşturulan sorunları ararken istediğiniz düzeyde bir netlik sağlayabilirsiniz. Örneğin, Haziran 2014'ün herhangi bir zamanında oluşturulan sorunları bulmak için created:2014-06 değerini belirtebilirsiniz. Daha kesin bilgi edinmek için 3 Haziran 2014 tarihinde 4. saatte (04:00 - 05:00, UTC) oluşturulan sorunları created:2014-06-03T04 araması yapabilirsiniz.

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] şeklindedir. Başlangıç ve bitiş zamanları, ihtiyacınız olan herhangi bir kesinlik düzeyine sahip olabilir. Örneğin, verified:2013..2015 işlevi 2013, 2014 veya 2015'te doğrulanan tüm sorunları döndürür.

Göreli zaman biçimi

Ayrıca, bir saati bugünden önceki günlere göre de belirtebilirsiniz. Bunun 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ını ifade eder. Örneğin, son beş gün içinde değiştirilen sorunları bulmak için modified:5d kullanabilirsiniz.

Göreli saat biçimi kullanırken operatör, iki nokta üst üste karakteri (:) olmalıdır (ör. created:5d). Bu aralıkta yer almayan 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 olmayan sorunları bulmak istiyorsanız (-verified:10d) AND status:verified kullanabilirsiniz.

Gün aritmetiği ile "Bugün" aramaları

Zaman aramalarında geçerli tarihin yerine today jetonunu kullanabilirsiniz. today+10 ve today-2 gibi gün aritmetiği kullanımını destekler. today jetonu, today-2..today+3 gibi zaman aralıklarıyla da kullanılabilir. Kayıtlı aramalarda today jetonunu kullanmak sorgunun yeniden kullanılabilmesine 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 İzleyici'deki zaman aramaları UTC saat dilimindedir. Aynı durum today kullanan aramalar için de geçerlidir.