Klauzule SELECT

Dotazy, které zadáváte pomocí klauzulí uvedených v kapitole (Jak používat AQL) vám vrátí výsledek bez vlastností (atributů) aktiv. Přidáním klauzule SELECT s konkrétní vlastností do dotazu vám umožní ve výsledku vidět také vlastnosti výsledných aktiv .

Použití klauzule SELECT v dotazech

Klauzule SELECT vybírá z vlastností aktiv ty, které mají být vráceny ve výsledku dotazu. Vybraná vlastnost nebo seznam vlastností je specifický pro každý krok, tj. musí být specifikován pro každý krok zvlášť. Pokud chcete zadat seznam vlastností zobrazených ve výsledku dotazu, zabalte vybrané vlastnosti do hranatých závorek [ ] a mezi sebou je oddělte čárkou ,. Samotný název vlastnosti/atributu se uvádí v uzavřených dvojitých uvozovkách.

FROM '/assets/servers/*' SELECT ["hardware", "name"]

Pro odkaz na atribut ve vnořené struktuře použijte cestu k atributu s .jako oddělovačem. Pokud jsou požadovány všechny atributy, můžete použít * namísto názvů všech atributů.

FROM '/assets/servers/*' SELECT ["hardware.ip"]
FROM '/assets/servers/*' SELECT ["*"]

Jak již bylo zmíněno na začátku, SELECT je specifický pro každý krok samostatně. Níže uvedený příklad ukazuje dotaz s více kroky a výběrem požadované vlastnosti u každého kroku zvlášť.

FROM '/assets/servers/*' SELECT ["hardware.ip"] DIRECT FORWARD SELECT ["name"]

Tento dotaz zobrazí následující výsledek:

[
    {
        "type": "/assets/servers",
        "id": "x01",
        "attributes": {
            "hardware": {
                "ip": "147.11.0.5"
            }
        }
    },
    {
        "type": "/assets/sensors",
        "id": "pc01",
        "attributes": {
            "name": "Temperature sensor"
        }
    },
]

Upozornění
Pozor na to, že SELECT nelze použít s krokem přeskočení. Ten je definovaný v dotazu klauzulí SKIP. Vzhledem k tomu, že takový krok ve skutečnosti nevede k žádnému výsledku, nemá smysl specifikovat, které atributy by měly být vráceny. Proto jsou níže uvedené dotazy neplatné.
SKIP '/assets/*' SELECT ["*"]
FROM '/assets/*' SKIP FORWARD SELECT ["*"]