← Log Explorer / log-explorer

Podporované dotazy SQL

Tato stránka popisuje funkce SQL podporované nástrojem Log Explorer, včetně běžných agregačních funkcí, výrazů a klauzulí dotazů.

Diagram níže znázorňuje obecnou podobu platného dotazu podporovaného v Log Explorer. Ukazuje, jak standardní klauzule SQL, jako například SELECT, WHERE, GROUP BY, a ORDER BY : lze kombinovat a vytvářet tak podporované dotazy.

Mezi příklady dotazů patří:

• SELECT * FROM table WHERE (a = 1 OR b = "hello") AND c < 25.89
• SELECT a, b, c FROM table WHERE d >= "GB" LIMIT 10

Následující klauzule SQL definují strukturu a logiku dotazů v Log Explorer:

• SELECT - SELECT klauzule určuje sloupce, které chcete získat z databázových tabulek. Může obsahovat jednotlivé názvy sloupců, výrazy nebo dokonce zástupné znaky pro výběr všech sloupců.
• FROM - FROM klauzule určuje tabulky, ze kterých se mají získat data. Udává zdroj dat pro SELECT příkaz.
• WHERE - WHERE klauzule filtruje řádky vrácené dotazem na základě zadaných podmínek. Umožňuje určit podmínky, které musí řádek splňovat, aby byl zahrnut do výsledné sady.
• SELECT DISTINCT : Odebere duplicitní řádky z výsledné sady.
• GROUP BY : Seskupuje řádky pro agregaci. GROUP BY klauzule se používá k seskupení řádků se stejnými hodnotami do souhrnných řádků.
• ORDER BY : Seřadí výslednou sadu. ORDER BY klauzule se používá k seřazení výsledné sady podle jednoho nebo více sloupců vzestupně nebo sestupně.
• LIMIT : Omezuje počet vrácených řádků. LIMIT klauzule se používá k omezení počtu řádků vrácených dotazem. Často se používá společně s ORDER BY klauzuli k získání prvních N řádků nebo k implementaci stránkování.
• OFFSET : Před vrácením výsledků přeskočí zadaný počet řádků.

Následující části podrobněji popisují zbývající součásti znázorněné v diagramu, jako jsou agregační funkce, řetězcové a číselné výrazy a podporované operátory.

Log Explorer podporuje řadu SQL funkcí pro transformaci, vyhodnocení nebo souhrn dat. Patří mezi ně skalární a agregační funkce.

Tyto funkce pomáhají manipulovat s hodnotami nebo je vyhodnocovat (často řetězce):

• ARRAY_CONTAINS(array, element) : Kontroluje, zda pole obsahuje daný prvek.

  Příklad

  ARRAY_CONTAINS(['US', 'CA'], ClientCountry)

  Vrátí řádky, kde ClientCountry je buď US nebo CA.

• SUBSTRING(string, from_number, for_number) : Extrahuje část řetězce.

  Příklad

  SUBSTRING(ClientRequestPath, 0, 5)

  Extrahuje prvních 5 znaků z ClientRequestPath.

• LOWER(string) : Převede na malá písmena.

  Příklad

  LOWER(ClientRequestUserAgent)

  Převede řetězec user agent na malá písmena.

• UPPER(string) : Převede na velká písmena.

  Příklad

  UPPER(ClientCountry)

  Převede kód země na velká písmena.

Slouží k provádění výpočtů nad sadami řádků:

• SUM(expression) : Součet hodnot.

  Příklad

  SUM(ClientRequestBytes)

  Sečte celkový počet bajtů, které si vyžádali klienti.

• MIN(expression) : Minimální hodnota.

  Příklad

  MIN(OriginResponseDurationMs)

  Najde nejkratší dobu odezvy od origin serverů.

• MAX(expression) : Maximální hodnota.

  Příklad

  MAX(OriginResponseDurationMs)

  Najde nejdelší dobu odezvy.

• COUNT(expression) : Počet řádků (může jít o všechny řádky nebo pouze hodnoty, které nejsou null).

  Příklad

  COUNT(ClientRequestUserAgent)

  Spočítá, kolik řádků obsahuje hodnotu user agent.

• COUNT(DISTINCT expression) : Počet odlišných hodnot, které nejsou null.

  Příklad

  COUNT(DISTINCT ClientIP)

  Spočítá, kolik unikátních IP adres klientů odeslalo požadavky.

• AVG(expression) : Průměr číselných hodnot.

  Příklad

  AVG(OriginResponseDurationMs)

  Vypočítá průměrnou dobu odezvy originu v milisekundách.

Diagram níže znázorňuje gramatiku výrazů SQL včetně skalárních a agregačních funkcí.

Podmínky nebo logika používaná v dotazech:

• CASE WHEN : Podmíněná logika (obdoba if-else).
• AS : Alias pro sloupce nebo tabulky.
• LIKE : Porovnávání podle vzoru.
• IN (list) : Kontroluje, zda je hodnota v seznamu.
• BETWEEN ... AND ... : Kontroluje, zda hodnota spadá do daného rozsahu.
• Unary operator : Pracuje s jedním operandem (například -5).
• Binary operator : Pracuje se dvěma operandy (například 5 + 3).
• Nested Expressions : Výraz uzavřený v závorkách, například ( x > y ) nebo ( 1 ).
• Compound identifier : Vícedílný název (například schema.table.column).
• Array : Kolekce hodnot (podporovaná různě podle SQL dialektu).
• Literals : představují hodnoty, například řetězce, čísla nebo pole.

Diagram níže znázorňuje gramatiku výrazů SQL a popisuje různé podoby, které může výraz mít, včetně sloupců, literálů, funkcí, operátorů a aliasů.

Diagram níže definuje gramatiku unárních operátorů, které pracují s jedním operandem (například negace nebo logické NOT):

Slouží k aritmetickým, porovnávacím a logickým operacím:

• Aritmetické: +, -, *, /, % (modulo)
• Porovnávací: >, <, >=, <=, =, != (nebo <>)`
• Logické: AND, OR, XOR
• Bitové: &, |, ^, >>, <<
• Spojení řetězců: ||