Slovník pojmů
Zde se nachází nejdůležitější klíčová slova, která jsou v této dokumentaci použita. Najdete tu nejčastěji používané klauzule, operátory a jiné.
| klíč. slovo | popis | |
|---|---|---|
krok |
popis souboru aktiv; první krok popisuje množinu podle ID masky a atributů, další kroky využívají výsledek předchozího kroku a pomocí hran jej rozšiřují na novou množinu aktiv | |
aktivum |
aktiva jsou části sítě reality, které zkoumáme, přeskakujeme, vypisujeme; mohou být vzájemně určitým způsobem propojeny – mohou mít vztah | |
hrana |
hrana je způsob, jakým jsou aktiva propojena; existují i aktiva, která nemají žádný vztah – nejsou navzájem spojena | |
výsledek |
aktivum, které bylo objeveno “nepřeskakujícím” krokem – tedy generátorem | |
počáteční krok |
krok, který specifikuje aktiva podle ID masky a dodatečných podmínek | |
generátor |
krok, jehož výsledek není přeskočen, ale je součástí konečných výsledků – výsledek se neignoruje, výsledkem je to, co nás zajímá | |
krok přeskočení |
krok, jehož výsledky nejsou součástí konečného výsledku – výsledek je v podstatě ignorován a použit pouze jako výchozí bod pro další krok | |
vlastnost |
vlastnost aktiva; každé aktivum má více atributů; jeden atribut je jedna hodnota v objektu JSON a je identifikováno cestou JSON | |
vlastnost s textovou hodnotou |
atribut, jehož hodnotou je text | |
hodnota |
hodnota explicitně zadaná v AQL dotazu | |
operátor |
symbol představující určitý vztah (rovnost, nerovnost, …) | |
ID maska |
je způsob, jakým popsat více ID podle určitého pravidla; ID začíná typem aktiva začínající lomítkem a pokračuje identifikátorem aktiva: /assets/sensors/a; nejjednodušší maska je právě ID konkrétního aktiva; chceme-li maskou popsat více aktiv, musíme použít symbol *, ten znamená, že na daném místě může být cokoli, například: /assets/sensors/* definuje všechny senzory v síti; v dotazu je maska ohraničena uvozovkami: FROM '/assets/servers/*'; v případě, že je potřeba pro více aktiv použít více masek, jsou tyto masky uzavřeny v hranatých závorkách a odděleny čárkou FROM ['/assets/servers/*', '/assets/sensors/*' ] |
| klauzule | popis funkce |
|---|---|
FROM |
začíná se prvním krokem jako generátorem, následuje ID maska (či seznam ID masek) |
IN |
operátor, který by měl být použit v klauzuli WHERE, zkontroluje, zda je v určeném seznamu hodnot obsažen požadovaný atribut |
SKIP |
spustí krok, jehož výsledek přeskočí, následuje ID maska (či seznam ID masek) |
WHERE |
spustí booleovský výraz (true=1, false=0). Ten musí být pro každé aktivum vyhodnocen jako pravdivý (true) |
TO ID |
se používá v klauzuli WHERE k reprezentaci druhého konce hrany |
LIKE |
operátor, který porovnává ID nebo texty na základě masky |
EDGE COUNT |
používá se v klauzuli WHERE pro reprezentaci počtu zadaných hran. Počtem hran pak můžete v klauzuli WHERE omezit aktiva. |
DIRECT |
jedná se o typ kroku, který se řídí výsledkem předchozího kroku. K získání výsledku prochází další hranu. |
BACKWARD |
určuje krok po hraně směrem od cíle ke zdroji |
FORWARD |
určuje krok po hraně směrem od zdroje k cíli |
ALL |
krok, který sleduje všechny hrany, jde po hranách směrem od zdroje k cíli |
ANY |
použito s EDGE COUNT; dva kontexty: EDGE COUNT ANY znamená, že jakákoli hrana (bez ohledu na směr a cíl) by měla být započítána a EDGE COUNT TO/FROM ANY slouží pro označení, že by měla být započítána každá odchozí/příchozí hrana |
NOT (WHERE) |
veWHERE podmínce neguje použitý výraz |
NOT (first step) |
lze použít k omezení masky v prvním kroku, např. FROM NOT ‘/incident/*’ vrací všechny aktiva, které nejsou incidenty |
SELECT |
nám dává všechny atributy, o které jsme žádali; musí být specifikovány pro každý krok |
AND |
booleovský operátor (true=1, false=0), lze použít v klauzuli WHERE |
OR |
booleovský operátor (true=1, false=0), lze použít v klauzuli WHERE |
EDGE TYPE |
se používá v klauzuli WHERE pro reprezentaci typu hrany |
TO / FROM / TO OR FROM |
společně s EDGE COUNT slouží ke specifikaci směru hrany |
VIA |
používá se s EDGE COUNT pro zadání typu hrany, která má být započítána; následuje textová hodnota popisující typ hrany |
| operátor | funkce |
|---|---|
() |
slouží k definování polí v predikátu IN; v klauzuli WHERE se používá pro správné oddělení booleovských výrazů (true=1, false=0) |
* |
používá se v ID masce, rozbalí cokoliv (včetně prázdného řetězce) |
" " |
definuje identifikátory – např. název atributu |
' ' |
definuje řetězcové hodnoty a ID masky |
= |
operátor pro rovnost; používá se v klauzuli WHERE |
/ |
je součástí ID masek aktiv, odděluje vrstvy |
[] |
slouží k definování ID masek |
, |
odděluje prvky v polích |
. |
žádný zvláštní význam |
< |
matematický operátor; je větší než |
> |
matematický operátor; je menší než |