Textové parametry sešitu

  • Článek

Parametry textového pole představují jednoduchý způsob, jak shromažďovat textové vstupy od uživatelů sešitu. Používají se, když není praktické použít rozevírací seznam ke shromažďování vstupu, například s libovolnou prahovou hodnotou nebo obecnými filtry. Pomocí sešitu můžete z dotazu získat výchozí hodnotu textového pole. Tato funkce umožňuje zajímavé scénáře, jako je nastavení výchozí prahové hodnoty na základě p95 metriky.

Běžné použití textových polí je jako interní proměnné používané jinými ovládacími prvky sešitu. Použijete dotaz pro výchozí hodnoty a vstupní ovládací prvek neviditelný v režimu čtení. Můžete například chtít, aby prahová hodnota pocházela ze vzorce, ne uživatele, a pak tuto prahovou hodnotu použila v následných dotazech.

Vytvoření textového parametru

  1. Začněte prázdným sešitem v režimu úprav.

  2. Vyberte Přidat parametry>Přidat parametr.

  3. V novém podokně parametrů, které se otevře, zadejte:

    1. Název parametru: SlowRequestThreshold
    2. Typ parametru: Text
    3. Povinné: checked
    4. Získání dat z: None

  4. Výběrem možnosti Uložit vytvořte parametr.

    Screenshot that shows the creation of a text parameter.

Tento snímek obrazovky ukazuje, jak sešit vypadá v režimu čtení:

Screenshot that shows a text parameter in read mode.

Styl pole parametru

Textový parametr podporuje následující styly polí:

  • Standardní: Jednořádkové textové pole.

    Screenshot that shows a standard text field.

  • Heslo: Jednořádkové heslo. Hodnota hesla je při psaní v uživatelském rozhraní skrytá. Hodnota je při odkazech plně přístupná jako hodnota parametru. Při uložení sešitu se uloží nešifrovaná.

    Screenshot that shows a password field.

  • Víceřádkové: Víceřádkové textové pole s podporou bohaté technologie IntelliSense a barevné zvýrazňování syntaxe pro následující jazyky:

    • Text
    • Markdown
    • JSON
    • SQL
    • TypeScript
    • KQL
    • TOML

    Můžete také zadat výšku víceřádkového editoru.

    Screenshot that shows a multiline text field.

Odkaz na textový parametr

  1. Vyberte Přidat dotaz, chcete-li přidat ovládací prvek dotazu, a pak vyberte prostředek Přehledy aplikace.

  2. Do pole KQL přidejte tento fragment kódu:

    requests
| summarize AllRequests = count(), SlowRequests = countif(duration >= {SlowRequestThreshold}) by name
| extend SlowRequestPercent = 100.0 * SlowRequests / AllRequests
| order by SlowRequests desc

  3. Pomocí textového parametru s hodnotou 500 ve spojení s ovládacím prvku dotazu efektivně spustíte následující dotaz:

    requests
| summarize AllRequests = count(), SlowRequests = countif(duration >= 500) by name
| extend SlowRequestPercent = 100.0 * SlowRequests / AllRequests
| order by SlowRequests desc

  4. Spuštěním dotazu zobrazte výsledky.

    Screenshot that shows a text parameter referenced in KQL.

Poznámka:

V předchozím příkladu {SlowRequestThreshold} představuje celočíselnou hodnotu. Pokud jste dotazovali na řetězec, jako {ComputerName}je , museli byste upravit dotaz Kusto tak, aby přidával uvozovky "{ComputerName}" , aby pole parametru přijímalo vstup bez uvozovek.

Nastavení výchozích hodnot pomocí dotazů

  1. Začněte prázdným sešitem v režimu úprav.

  2. Vyberte Přidat parametry>Přidat parametr.

  3. V novém podokně parametrů, které se otevře, zadejte:

    1. Název parametru: SlowRequestThreshold
    2. Typ parametru: Text
    3. Povinné: checked
    4. Získání dat z: Query

  4. Do pole KQL přidejte tento fragment kódu:

    requests
| summarize round(percentile(duration, 95), 2)

    Tento dotaz nastaví výchozí hodnotu textového pole na dobu trvání 95. percentilu pro všechny požadavky v aplikaci.

  5. Spuštěním dotazu zobrazte výsledky.

  6. Výběrem možnosti Uložit vytvořte parametr.

    Screenshot that shows a text parameter with a default value from KQL.

Poznámka:

I když tento příklad dotazuje aplikace Přehledy dat, je možné tento přístup použít pro jakýkoli zdroj dat založený na protokolech, jako je Log Analytics a Azure Resource Graph.

Přidání ověření

Pro standardní a heslo textové parametry můžete přidat ověřovací pravidla, která se použijí pro textové pole. Přidejte platný regulární výraz s chybovou zprávou. Pokud je zpráva nastavená, zobrazí se jako chyba, když je pole neplatné.

Pokud je vybrána shoda, pole je platné, pokud hodnota odpovídá regulárnímu výrazu. Pokud shoda není vybraná, pole je platné, pokud neodpovídá regulárnímu výrazu.

Screenshot that shows text validation settings.

Formátování dat JSON

Pokud je jako jazyk víceřádkového textového pole vybrán JSON, bude mít pole tlačítko, které formátuje data JSON pole. K naformátování dat JSON můžete použít také klávesovou zkratku Ctrl+\ .

Pokud data pocházejí z dotazu, můžete vybrat možnost předběžného formátování dat JSON vrácených dotazem.

Screenshot that shows the option Pre-format JSON data.

Další kroky

Začínáme se službou Azure Workbooks