Parametry tekstu skoroszytu

  • Artykuł

Parametry pola tekstowego zapewniają prosty sposób zbierania danych wejściowych tekstu od użytkowników skoroszytu. Są one używane, gdy nie jest praktyczne użycie listy rozwijanej do zbierania danych wejściowych, na przykład z dowolnym progiem lub filtrami ogólnymi. Korzystając ze skoroszytu, możesz uzyskać domyślną wartość pola tekstowego z zapytania. Ta funkcja umożliwia korzystanie z interesujących scenariuszy, takich jak ustawienie domyślnego progu na podstawie wartości p95 metryki.

Typowym zastosowaniem pól tekstowych jest to, że zmienne wewnętrzne używane przez inne kontrolki skoroszytu. Używasz zapytania dla wartości domyślnych i sprawiasz, że kontrolka danych wejściowych jest niewidoczna w trybie odczytu. Na przykład możesz chcieć, aby próg pochodził z formuły, a nie użytkownika, a następnie użyć progu w kolejnych zapytaniach.

Tworzenie parametru tekstowego

  1. Zacznij od pustego skoroszytu w trybie edycji.

  2. Wybierz pozycję Dodaj parametry>Dodaj parametr.

  3. W otwartym okienku nowego parametru wprowadź:

    1. Nazwa parametru: SlowRequestThreshold
    2. Typ parametru: Text
    3. Wymagane: checked
    4. Pobieranie danych z: None

  4. Wybierz pozycję Zapisz , aby utworzyć parametr.

    Screenshot that shows the creation of a text parameter.

Ten zrzut ekranu przedstawia wygląd skoroszytu w trybie odczytu:

Screenshot that shows a text parameter in read mode.

Styl pola parametru

Parametr tekstowy obsługuje następujące style pól:

  • Standardowa: jednowierszowe pole tekstowe.

    Screenshot that shows a standard text field.

  • Hasło: jednowierszowe pole hasła. Wartość hasła jest ukryta tylko w interfejsie użytkownika podczas wpisywania. Wartość jest w pełni dostępna jako wartość parametru, gdy jest określana. Jest on przechowywany niezaszyfrowany po zapisaniu skoroszytu.

    Screenshot that shows a password field.

  • Wielowierszowe: wielowierszowe pole tekstowe z obsługą rozbudowanej funkcji IntelliSense i kolorowania składni dla następujących języków:

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

    Możesz również określić wysokość edytora wielowierszowego.

    Screenshot that shows a multiline text field.

Odwołanie do parametru tekstowego

  1. Wybierz pozycję Dodaj zapytanie, aby dodać kontrolkę zapytania, a następnie wybierz zasób Application Szczegółowe informacje.

  2. W polu KQL dodaj ten fragment kodu:

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

  3. Używając parametru tekstowego z wartością 500 w połączeniu z kontrolką zapytania, można skutecznie uruchomić następujące zapytanie:

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

  4. Uruchom zapytanie, aby wyświetlić wyniki.

    Screenshot that shows a text parameter referenced in KQL.

Uwaga

W poprzednim przykładzie {SlowRequestThreshold} reprezentuje wartość całkowitą. W przypadku wykonywania zapytań dotyczących ciągu, takiego jak {ComputerName}, należy zmodyfikować zapytanie Kusto, aby dodać cudzysłów, aby pole parametru akceptowało dane wejściowe bez cudzysłowu "{ComputerName}" .

Ustawianie wartości domyślnych przy użyciu zapytań

  1. Zacznij od pustego skoroszytu w trybie edycji.

  2. Wybierz pozycję Dodaj parametry>Dodaj parametr.

  3. W otwartym okienku nowego parametru wprowadź:

    1. Nazwa parametru: SlowRequestThreshold
    2. Typ parametru: Text
    3. Wymagane: checked
    4. Pobieranie danych z: Query

  4. W polu KQL dodaj ten fragment kodu:

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

    To zapytanie ustawia domyślną wartość pola tekstowego na 95. percentyl czasu trwania dla wszystkich żądań w aplikacji.

  5. Uruchom zapytanie, aby wyświetlić wyniki.

  6. Wybierz pozycję Zapisz , aby utworzyć parametr.

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

Uwaga

Mimo że w tym przykładzie wykonuje zapytania dotyczące danych usługi Application Szczegółowe informacje, podejście może być używane dla dowolnego źródła danych opartego na dzienniku, takiego jak Log Analytics i Azure Resource Graph.

Dodawanie walidacji

W przypadku standardowych i haseł można dodać reguły sprawdzania poprawności stosowane do pola tekstowego. Dodaj prawidłowy rejestr z komunikatem o błędzie. Jeśli komunikat jest ustawiony, jest wyświetlany jako błąd, gdy pole jest nieprawidłowe.

Jeśli wybrano dopasowanie, pole jest prawidłowe, jeśli wartość jest zgodna z wyrażeniem regularnym. Jeśli dopasowanie nie jest zaznaczone, pole jest prawidłowe, jeśli nie pasuje do wyrażenia regularnego.

Screenshot that shows text validation settings.

Formatowanie danych JSON

Jeśli jako język pola tekstowego wielowierszowego wybrano format JSON, pole będzie mieć przycisk, który formatuje dane JSON pola. Możesz również użyć skrótu Ctrl + \ w celu sformatowania danych JSON.

Jeśli dane pochodzą z zapytania, możesz wybrać opcję wstępnego formatowania danych JSON zwracanych przez zapytanie.

Screenshot that shows the option Pre-format JSON data.

Następne kroki

Wprowadzenie do skoroszytów platformy Azure