Artikelversion: Enterprise Server 2.17
Grundlagen der Suchsyntax
Für Suchen auf GitHub Enterprise können Sie Abfragen erstellen, die nach bestimmten alphanumerischen Zeichenfolgen suchen.
Abfrage nach Werten mit einem Vergleichsoperator
Mit >
, >=
, <
und <=
können Sie nach Werten suchen, die größer, größer oder gleich, kleiner oder kleiner oder gleich einem anderen Wert sind.
Abfrage | Beispiel |
---|---|
>n | cats stars:>1000 matches repositories with the word "cats" that have more than 1000 stars. |
>=n | cats topics:>=5 matches repositories with the word "cats" that have 5 or more topics. |
<n | cats size:<10000 matches code with the word "cats" in files that are smaller than 10 KB. |
<=n | cats stars:<=50 matches repositories with the word "cats" that have 50 or fewer stars. |
Auch mit Bereichsabfragen können Sie nach Werten suchen, die größer oder gleich bzw. kleiner oder gleich einem anderen Wert sind.
Abfrage | Beispiel |
---|---|
n..* | cats stars:10..* entspricht stars:>=10 und sucht Repositorys, die das Wort „cats“ enthalten und mindestens 10 Sterne haben. |
*..n | cats stars:*..10 entspricht stars:<=10 und sucht Repositorys, die das Wort „cats“ enthalten und höchstens 10 Sterne haben. |
Abfrage nach Werten innerhalb eines Wertebereichs
Mit der Bereichssyntax n..n
können Sie nach Werten innerhalb eines Wertebereichs suchen. Dabei ist der erste Wert n die untere und der zweite Wert <2>n</2> die obere Grenze des gesuchten Bereichs.
Abfrage | Beispiel |
---|---|
n..n | cats stars:10..50 sucht Repositorys, die das Wort „cats“ enthalten und zwischen 10 und 50 Sternen haben. |
Abfrage nach Datums- und Zeitangaben
Mit >
, >=
, <
, <=
und Bereichsabfragen können Sie nach Datums- und Zeitangaben vor oder nach einem bestimmten Datum/Uhrzeit oder innerhalb eines Datums-/Zeitbereichs suchen. Die Datumsformatierung muss dem ISO8601-Standard entsprechen, der YYYY-MM-DD
(Jahr-Monat-Tag) ist.
Abfrage | Beispiel |
---|---|
>YYYY-MM-DD | cats created:>2016-04-29 matches issues with the word "cats" that were created after April 29, 2016. |
>=YYYY-MM-DD | cats created:>=2017-04-01 matches issues with the word "cats" that were created on or after April 1, 2017. |
<YYYY-MM-DD | cats pushed:<2012-07-05 matches code with the word "cats" in repositories that were pushed to before July 5, 2012. |
<=YYYY-MM-DD | cats created:<=2012-07-04 matches issues with the word "cats" that were created on or before July 4, 2012. |
YYYY-MM-DD..YYYY-MM-DD | cats pushed:2016-04-30..2016-07-04 sucht Repositorys, die das Wort „cats“ enthalten und in die zwischen dem 30. April und dem 4. Juli 2016 ein Push erfolgt ist. |
YYYY-MM-DD..* | cats created:2012-04-30..* sucht Issues, die das Wort „cats“ enthalten und nach dem 30. April 2012 erstellt wurden. |
*..YYYY-MM-DD | cats created:*..2012-04-30 sucht Issues, die das Wort „cats“ enthalten und vor dem 30. April 2012 erstellt wurden. |
Du kannst nach dem Datum auch optionale Zeitinformationen THH:MM:SS+00:00
hinzufügen, um nach der Stunde, Minute und Sekunde zu suchen. Das ist T
, gefolgt von HH:MM:SS
(Stunden:Minuten:Sekunden) und einem UTC-Offset (+00:00
).
Abfrage | Beispiel |
---|---|
YYYY-MM-DDTHH:MM:SS+00:00 | cats created:2017-01-01T01:00:00+07:00..2017-03-01T15:30:15+07:00 sucht Issues, die zwischen 1. Januar 2017, 01:00 Uhr (mit einer UTC-Verschiebung von 07:00 Stunden), und 1. März 2017, 15:30 Uhr (mit ebenfalls einer UTC-Verschiebung von 07:00 Stunden), erstellt wurden. |
YYYY-MM-DDTHH:MM:SSZ | cats created:2016-03-21T14:11:00Z..2016-04-07T20:45:00Z sucht Issues, die zwischen 21. März 2016, 14:11 Uhr, und 7. April 2016, 20:45 Uhr, erstellt wurden. |
Ausschluss bestimmter Ergebnisse
Mit der Syntax NOT
können Sie Ergebnisse, die ein bestimmtes Wort enthalten, aus den Abfrageergebnissen ausschließen. Der Operator NOT
kann nur für Zeichenfolgen verwendet werden. Mit Zahlen oder Datumsangaben funktioniert er nicht.
Abfrage | Beispiel |
---|---|
NOT | hello NOT world sucht Repositorys, die das Wort „hello“, aber nicht das Wort „world“ enthalten. |
Ebenso können Sie Ihre Abfrageergebnisse durch Ausschluss bestimmter Teilmengen eingrenzen. Sie können jedem Suchkennzeichner ein -
voranstellen, um Ergebnisse auszuschließen, die mit diesem Kennzeichner übereinstimmen.
Abfrage | Beispiel |
---|---|
-KENNZEICHNER | cats stars:>10 -language:javascript matches repositories with the word "cats" that have more than 10 stars but are not written in JavaScript. |
mentions:defunkt -org:github sucht Issues, die „@defunkt“ erwähnen, aber nicht in Repositorys der Organisation GitHub enthalten sind. |
Anführungszeichen für Abfragen nach Zeichenfolgen mit Leerzeichen
Wenn Ihre Suchabfrage Leerzeichen enthält, müssen Sie die gesuchte Zeichenfolge in Anführungszeichen einschließen. Ein Beispiel:
- cats NOT "hello world" sucht Repositorys, die das Wort „cats“ enthalten, aber nicht die Wörter „hello world“.
- build label:"bug fix" sucht Issues, die das Wort „build“ enthalten und die Kennzeichnung „bug fix“ aufweisen.
Bei Suchabfragen innerhalb von Code werden einige nicht alphanumerische Zeichen, so auch Leerzeichen, ignoriert, selbst wenn der Suchstring in Anführungszeichen steht. Dies führt oft nicht zum erwünschten Ergebnis.