Používanie parametrov na tabuliach v reálnom čase (Preview)

Parametre sa používajú ako stavebné bloky pre filtre na tabuliach v reálnom čase. Spravujú sa v rozsahu tabúľ a je možné ich pridať do dotazov na filtrovanie údajov prezentovaných základným vizuálom. Dotaz môže použiť jeden alebo viac parametrov.

Dôležité

Táto funkcia je vo verzii Preview.

Tento dokument popisuje vytváranie a používanie parametrov a prepojených filtrov na tabuliach. Parametre možno používať na filtrovanie vizuálov tabule výberom hodnôt parametrov na paneli s filtrami alebo pomocou krížových filtrov.

Príklady dotazov použité v tomto článku vychádzajú z tabuľky StormEvents v ukážkových údajoch analýzy počasia, ktoré sú k dispozícii v galérii vzoriek.

Poznámka

Správa parametrov je k dispozícii v režime úprav pre editory tabúľ.

Požiadavky

• Pracovný priestor s kapacitou povolenou pre službu Microsoft Fabric
• Povolenia editora na tabuli v reálnom čase
• Tabuľa s vizuálmi

Zobrazenie zoznamu parametrov

Ak chcete zobraziť zoznam všetkých parametrov tabule, vyberte položku Spravovať>parametre.

Vytvorenie parametra

Vytvorenie parametra:

1. V hornej ponuke vyberte tlačidlo Nové parametre . Otvorí sa tabla Parametre .
2. Vyberte tlačidlo + Pridať v hornej časti pravej tably.
3. Vyplňte relevantné vlastnosti pre parameter.
4. Výberom položky Hotovo vytvorte parameter.

Vlastnosti

Na table Pridať parameter nakonfigurujte nasledujúce vlastnosti.

Pole	Popis
Označenie	Názov parametra zobrazeného na tabuli alebo na karte Upraviť.
Typ parametra	Jeden z nasledujúcich parametrov: - Jeden výber: Ako vstup pre parameter je možné vybrať iba jednu hodnotu vo filtri. - Viacnásobný výber: Jednu alebo viac hodnôt môžete vybrať vo filtri ako vstupy pre parameter. - Časový rozsah: Umožňuje vytvárať ďalšie parametre na filtrovanie dotazov a tabúľ na základe času. Každá tabuľa má predvolene nástroj na výber časového rozsahu. - Voľný text: Vo filtri sa nevyplnia žiadne hodnoty. Používateľ môže zadať hodnotu alebo skopírovať alebo prilepiť hodnotu do textového poľa. Filter ponechá použité nedávne hodnoty.
Popis	Voliteľný popis parametra.
Názov premennej	Názov parametra, ktorý sa má použiť v dotaze.
Typ údajov	Typ údajov hodnôt parametrov.
Zobraziť na stranách	Vyberte stránky, kde sa zobrazuje tento parameter. Možnosť Vybrať všetko zobrazí parameter na všetkých stránkach.
Zdrojový	Zdroj hodnôt parametrov: - Pevné hodnoty: Manuálne zavedené hodnoty statického filtra. - Dotaz: Dynamicky zavedené hodnoty pomocou dotazu KQL.
Pridanie hodnoty Vybrať všetko	Platí len pre jeden výber a viaceré typy parametrov výberu. Slúži na načítanie údajov pre všetky hodnoty parametrov. Táto hodnota by mala byť vstavaná do dotazu, aby sa poskytli jeho funkcie. Ďalšie príklady pri vytváraní takýchto dotazov nájdete v téme Použitie parametra založeného na dotaze s viacerými výbermi.
Predvolená hodnota	Predvolená hodnota filtra. Filter sa pri počiatočnom vykreslení tabule vždy začína predvolenou hodnotou.

Spravovanie parametrov

Po výbere položky Parametre v hornom paneli môžete zobraziť zoznam existujúcich parametrov. V každej karte parametrov môžete vybrať miniaplikáciu ceruzky na úpravu parametra, alebo vybrať ponuku Viac [...] na Duplikovať, Odstrániť alebo premiestniť parameter.

Na karte parametra je možné zobraziť nasledujúce indikátory:

• Zobrazovaný názov parametra
• Názvy premenných
• Počet dotazov, v ktorých bol parameter použitý
• Strany, na ktoré je parameter pripnutý

Karty parametrov môžete zmeniť presunutím myšou alebo pomocou možnosti Premiestniť do > .

Použitie parametrov v dotaze

Parameter musí byť použitý v dotaze, aby sa filter použil pre daný vizuál dotazu. Po definovaní sa parametre zobrazia v hornom paneli filtra stránky > dotazu a v intellisense dotazu.

Poznámka

Ak sa parameter nepoužíva v dotaze, filter zostane neaktívny. Po pridaní parametra do dotazu sa filter stane aktívnym.

Typy parametrov

Podporovaných je niekoľko typov parametrov tabule:

• Predvolený parameter časového rozsahu
• Parametre s pevnými hodnotami výberu jednej množiny údajov
• Parametre s pevnými hodnotami výberu viacerých položiek
• Parametre založené na dotaze s jedným výberom
• Viaceré parametre založené na dotaze na výber
• Bezplatné textové parametre
• Parametre zdroja údajov

Nasledujúce príklady popisujú, ako používať parametre v dotaze pre rôzne typy parametrov.

Predvolený parameter časového rozsahu

Každá tabuľa má predvolene parameter rozsah času. Na tabuli sa zobrazí ako filter iba vtedy, keď sa použije v dotaze. Použite kľúčové slová parametra _startTime a _endTime použite predvolený parameter časového rozsahu v dotaze, ako je to znázornené v nasledujúcom príklade:

StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

Po uložení sa filter časového rozsahu zobrazí na tabuli. Teraz ho možno použiť na filtrovanie údajov na karte. Tabuľu môžete filtrovať výberom z rozbaľovacieho zoznamu: Časový rozsah (posledných x minút/hodín/dní) alebo vlastného časového rozsahu.

Parametre s pevnými hodnotami výberu jednej množiny údajov

Parametre s pevnou hodnotou sú založené na preddefinovaných hodnotách zadaných používateľom. Nasledujúci príklad ukazuje, ako vytvoriť parameter s pevnou hodnotou a jedným výberom.

Vytvorenie parametra s pevnými hodnotami s jedným výberom

1. Výberom položky Parametre otvorte tablu Parametre a vyberte položku Nový parameter.

2. Vyplňte tieto podrobnosti:

   • Označenie: Typ udalosti

   • Typ parametra: Jeden výber

   • Názov premennej: _eventType

   • Typ údajov: Reťazec

   • Pripnutie ako filter tabule: začiarknuté

   • Zdroj: Pevné hodnoty

     V tomto príklade použite nasledujúce hodnoty:

     Hodnota	Zobrazovaný názov parametra
     Víchrica vietor	Búrkový vietor
     Krupobitie	Krupobitie
     Flash Povodní	Flash povodní
     Sucha	Sucha
     Zimné počasie	Zimné počasie

   • Pridanie možnosti Vybrať všetky hodnoty: nezačiarknuté

   • Predvolená hodnota: Búrkový vietor

3. Výberom položky Hotovo vytvorte parameter.

Parameter je možné zobraziť na bočnej table Parametre , ale momentálne sa nepoužíva v žiadnych vizuáloch.

Použitie parametra s pevnými hodnotami s jedným výberom

1. Spustite vzorový dotaz pomocou nového parametra Typ udalosti s názvom premennej _eventType :

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType == _eventType
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Nový parameter sa zobrazí v zozname parametrov v hornej časti tabule.

2. Vyberte iné hodnoty a aktualizujte vizuály.

   

Parametre s pevnými hodnotami výberu viacerých položiek

Parametre s pevnou hodnotou sú založené na preddefinovaných hodnotách zadaných používateľom. Nasledujúci príklad ukazuje, ako vytvoriť a použiť parameter s pevnou hodnotou viacnásobného výberu.

Vytvorenie parametra s pevnými hodnotami viacnásobného výberu

1. Výberom položky Parametre otvorte tablu Parametre a vyberte položku Nový parameter.

2. Vyplňte podrobnosti, ako je uvedené v téme Použitie parametra s pevnými hodnotami s jedným výberom, a to nasledujúcimi zmenami:

   • Označenie: Typ udalosti
   • Typ parametra: Výber viacerých položiek
   • Názov premennej: _eventType

3. Výberom položky Hotovo vytvorte parameter.

Nové parametre možno zobraziť na bočnej table Parametre , ale momentálne sa nepoužívajú v žiadnych vizuáloch.

Použitie parametra s pevnými hodnotami viacnásobného výberu

1. Spustite vzorový dotaz pomocou nového parametra Typ udalosti s použitím premennej _eventType .

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Nový parameter sa zobrazí v zozname parametrov v hornej časti tabule.

2. Vyberte aspoň jednu inú hodnotu a aktualizujte vizuály.

   

Parametre založené na dotaze s jedným výberom

Hodnoty parametrov založené na dotaze sa načítajú počas načítavania tabule spustením parametrového dotazu. V nasledujúcom príklade sa dozviete, ako vytvoriť a použiť parameter založený na dotaze s jedným výberom.

Vytvorenie parametra založeného na dotaze s jedným výberom

1. Výberom položky Parametre otvorte tablu Parametre a vyberte položku Nový parameter.

2. Vyplňte podrobnosti, ako je uvedené v téme Použitie parametra s pevnými hodnotami s jedným výberom, a to nasledujúcimi zmenami:

   • Označenie: Stav

   • Názov premennej: _state

   • Zdroj: Dotaz

   • Zdroj údajov: StormEventsSample

   • Vyberte položku Upraviť dotaz a zadajte nasledujúci dotaz. Vyberte položku Hotovo.

     StormEvents
     | where StartTime between (_startTime.._endTime)
     | where EventType in (_eventType) or isempty(_eventType)
     | summarize TotalEvents = count() by State
     | top 5 by TotalEvents
     | project State
     

   • Hodnota: Stav

   • Zobrazovaný názov: Stav

   • Predvolená hodnota: Vyberte predvolenú hodnotu

3. Výberom položky Hotovo vytvorte parameter.

Použitie parametra založeného na dotaze s jedným výberom

1. Nasledujúci ukážkový dotaz s novým parametrom State používa premennú _state :

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State == _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Nový parameter sa zobrazí v zozname parametrov v hornej časti tabule.

2. Vyberte iné hodnoty a aktualizujte vizuály.

Viaceré parametre založené na dotaze na výber

Hodnoty parametrov založené na dotaze sú odvodené v čase načítania tabule spustením dotazu zadaného používateľom. Nasledujúci príklad ukazuje, ako vytvoriť parameter založený na dotaze založený na viacerých výberoch:

Vytvorenie parametra založeného na dotaze s viacerými výbermi

1. Výberom položky Parametre otvorte tablu Parametre a vyberte položku + Nový parameter.

2. Vyplňte podrobnosti, ako je uvedené v téme Použitie parametra s pevnými hodnotami s jedným výberom, a to nasledujúcimi zmenami:

   • Označenie: Stav
   • Typ parametra: Výber viacerých položiek
   • Názov premennej: _state

3. Výberom položky Hotovo vytvorte parameter.

Použitie parametra založeného na dotaze s viacerými výbermi

1. Nasledujúci vzorový dotaz používa nový parameter State s použitím premennej _state .

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State in (_state) or isempty(_state)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Poznámka

   Táto ukážka používa možnosť Vybrať všetko tým, že skontroluje, či vo funkcii nie sú isempty() prázdne hodnoty.

   Nový parameter sa zobrazí v zozname parametrov v hornej časti tabule.

2. Vyberte aspoň jednu inú hodnotu a aktualizujte vizuály.

Bezplatné textové parametre

Bezplatné textové parametre neobsahujú žiadne hodnoty. Umožňujú vám predstaviť si vlastnú hodnotu.

Vytvorenie parametra bezplatného textu

1. Výberom položky Parametre otvorte tablu Parametre a vyberte položku + Nový parameter.
2. Vyplňte tieto podrobnosti:
   • Označenie: Stav
   • Typ parametra: Voľný text
   • Názov premennej: _state
   • Typ údajov: Reťazec
   • Predvolená hodnota: Žiadna predvolená hodnota

Použitie parametra bezplatného textu

1. Spustite vzorový dotaz pomocou nového parametra Štát pomocou názvu premennej _state :

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State contains _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

Parametre zdroja údajov

Po pridaní zdrojov údajov na tabuľu môžete vytvoriť parameter, ktorým sa vyberie jeden alebo viacero dostupných zdrojov údajov. Tento parameter možno použiť v dlaždiciach a ďalších parametroch.

Vytvorenie parametra zdroja údajov

1. Výberom položky Parametre otvorte tablu Parametre a vyberte položku + Nový parameter.

2. Vyplňte tieto podrobnosti:

   • Označenie: Zdroj
   • Typ parametra: Zdroj údajov
   • Zobraziť na stranách: Vyberte všetko
   • Hodnoty: Vybrať všetko
   • Predvolená hodnota: StormEvents

   

3. Vyberte položku Hotovo.

Nový parameter sa teraz zobrazuje v zozname parametrov v hornej časti tabule.

Použitie parametra zdroja údajov

1. Prejdite na dotaz na novú alebo existujúcu dlaždicu.

2. V časti Zdroj vyberte názov nového parametra v časti Parametre zdroja údajov, napríklad nový parameter Zdroja .

   

3. Vyberte položku Použiť zmeny.

4. Ak chcete zmeniť zdroj údajov pre tento pripojený dotaz, použite parameter Source.

Parametre krížového filtrovania

Krížové filtrovanie je funkcia na tabuli, ktorá umožňuje vybrať hodnotu v jednom vizuáli a filtrovať údaje v iných vizuáloch na tej istej tabuli. Použitím krížových filtrov dosiahnete rovnaký výsledok ako výber ekvivalentnej hodnoty pre parameter v zozname parametrov v hornej časti tabule.

Definovanie krížových filtrov

Ak chcete vytvoriť krížové filtrovanie, musíte zapnúť možnosť vo vizuáli a potom zadať parameter, ktorý sa používa na filtrovanie údajov.

1. Prejdite na dotaz dlaždice, do ktorej chcete pridať krížové filtre.

2. Vyberte položku Vizuál.

3. Na pravej table vyberte položku Interakcie a potom zapnite krížové filtre.

4. Môžete tiež zadať typ interakcie . Predvolená hodnota je Point , kde môžete vybrať hodnotu vo vizuáli. Ak chcete vybrať rozsah hodnôt, ako napríklad v časovom grafe, vyberte položku Presunúť.

5. Zadajte stĺpec použitý na poskytnutie hodnoty, ako aj parameter použitý na filtrovanie dotazu vizuálu.

   Dôležité

   Stĺpec a parameter musia mať rovnaký typ údajov.

Interakcia s údajmi pomocou krížového filtrovania

Po definovaní krížového filtrovania ho môžete použiť na interakciu s údajmi. Vo vizuáloch, kde ste definovali krížové filtre, môžete vybrať údajové body a použiť ich hodnoty na filtrovanie aktuálnej strany tabule. V prípade vizuálov tabuľky vyberte údajové body kliknutím pravým tlačidlom myši na príslušnú bunku a potom v kontextovej ponuke vyberte položku Krížové filtrovanie.

Krížové filtrovanie môžete obnoviť výberom položky Obnoviť v hornej časti vizuálu, v ktorom bol vybratý.

Používanie podrobnej analýzy ako parametrov tabule

Pomocou podrobnej analýzy môžete vybrať hodnotu vo vizuáli a použiť ju na filtrovanie vizuálov na cieľovej strane v rámci tej istej tabule. Po otvorení cieľovej strany sa hodnota vopred vyberie v príslušných filtroch. Vizuály na strane, ako napríklad čiarové alebo bodové grafy, sú filtrované tak, aby zobrazovali len súvisiace údaje. Táto funkcia je užitočná pri vytváraní tabúľ s podrobnou analýzou zo stránky súhrnu na stranu s podrobnosťami. Informácie o vytváraní strán nájdete v téme Pridanie stránky.

Definovanie podrobnej analýzy

Ak chcete vytvoriť podrobnú analýzu, musíte zapnúť možnosť vo vizuáli a potom zadať jeden alebo viac parametrov podrobnej analýzy, ktoré sa používajú na filtrovanie údajov.

1. Na svojej primárnej stránke zadajte režim úprav .

2. Upravte vizuál, do ktorého chcete pridať podrobnú analýzu. Uistite sa, že je vybratá karta Vizuál.

   

3. Na pravej table vyberte položku Interakcie a potom zapnite podrobnú analýzu.

   

4. V časti Podrobná analýza vyberte položku Vytvoriť novú a zadajte nasledujúce informácie. Ak chcete pridať viacero parametrov cieľovej strany, môžete vybrať položku Pridať ďalší pár . Zopakujte tento krok a pridajte podrobnú analýzu na iné strany na aktuálnej tabuli pomocou rôznych parametrov.

   Pole	Description
   Cieľová stránka	Jedna alebo viac cieľových strán, ktoré sa majú podrobne analyzovať pomocou definovaných parametrov.
   Stĺpec	Stĺpec výsledku dotazu, ktorý sa má použiť ako hodnota parametra na cieľovej strane.
   Parameter	Parameter používaný na filtrovanie vizuálov na cieľovej strane pomocou hodnoty stĺpca.
   Poznámky	Voliteľný krátky popis.

   Dôležité

   Páry stĺpcov a parametrov musia mať rovnaký typ údajov.

   

Interakcia s údajmi pomocou podrobnej analýzy

Po definovaní podrobnej analýzy ich môžete použiť na interakciu s údajmi. Urobíte to tak, že vo vizuáloch alebo tabuľkách, v ktorých ste definovali podrobnú analýzu, kliknite pravým tlačidlom myši na údajový bod a potom vyberte položku Prejsť na>cieľovú stránku. Hodnoty z údajového bodu sa používajú ako parametre na filtrovanie vizuálov na cieľovej strane.

Použitie vyhľadávania filtrov pre jeden a viaceré filtre výberu

Do filtrov s jedným alebo viacerými možnosťami výberu zadajte požadovanú hodnotu. Filter sa aktualizuje tak, aby zobrazoval iba hodnoty, ktoré sa zhodujú s hľadaným výrazom.

Súvisiaci obsah

• Vizualizácia údajov pomocou tabúľ v reálnom čase
• Prispôsobenie vizuálov tabúľ v reálnom čase