Kryteria parametrów tekstowych

Gdy zapytanie zależy od wielu parametrów, zapytanie zostanie wstrzymane do momentu rozpoznania każdego z jego parametrów. Czasami parametr może mieć proste zapytanie, które łączy ciąg lub wykonuje ocenę warunkową. Te zapytania nadal wykonują wywołania sieciowe do usług wykonujących te podstawowe operacje, a proces ten zwiększa czas potrzebny na rozwiązanie wartości przez parametr. Wynikiem jest długi czas ładowania złożonych skoroszytów.

W przypadku używania parametrów kryteriów można zdefiniować zestaw kryteriów na podstawie wcześniej określonych parametrów, które będą oceniane w celu zapewnienia wartości dynamicznej. Główną zaletą używania parametrów kryteriów jest to, że parametry kryteriów mogą rozpoznawać wartości wcześniej określonych parametrów i wykonywać proste operacje warunkowe bez wykonywania żadnych wywołań sieciowych. Poniższy przykład to przypadek użycia parametrów kryteriów.

Przykład

Rozważ następujące zapytanie warunkowe:

Zrzut ekranu przedstawiający zapytanie warunkowe.

let metric = dynamic({Counter});
print tostring((metric.object == 'Network Adapter' and (metric.counter == 'Bytes Received/sec' or metric.counter == 'Bytes Sent/sec')) or (metric.object == 'Network' and (metric.counter == 'Total Bytes Received' or metric.counter == 'Total Bytes Transmitted')))

Jeśli koncentrujesz się na metric.counter obiekcie, wartość parametru isNetworkCounter powinna być prawdziwa, jeśli parametr Counter ma Bytes Received/secwartość , , Bytes Sent/secTotal Bytes Receivedlub Total Bytes Transmitted.

Można to przetłumaczyć na parametr tekstowy kryteriów:

Zrzut ekranu przedstawiający przykład kryteriów.

Na poprzednim zrzucie ekranu warunki zostaną ocenione od góry do dołu, a wartość parametru isNetworkCounter zajmie wartość niezależnie od tego, który warunek zostanie obliczony na wartość true. Wszystkie warunki z wyjątkiem warunku domyślnego (warunek "else") można zmienić kolejność, aby uzyskać żądany wynik.

Konfigurowanie kryteriów

  1. Zacznij od skoroszytu z co najmniej jednym istniejącym parametrem w trybie edycji.

    1. Wybierz pozycję Dodaj parametry Dodaj parametr>.
    2. W otwartym okienku nowego parametru wprowadź:
      • Nazwa parametru: rand
      • Typ parametru: Text
      • Wymagane: checked
      • Pobieranie danych z: Query
      • Wprowadź print rand(0-1) w edytorze zapytań. Ten parametr zwróci wartość z zakresu od 0 do 1.
    3. Wybierz pozycję Zapisz , aby utworzyć parametr.

    Uwaga

    Pierwszy parametr w skoroszycie nie będzie pokazywał karty Kryteria .

    Zrzut ekranu przedstawiający pierwszy parametr.

  2. W tabeli z parametrem rand wybierz pozycję Dodaj parametr.

  3. W otwartym okienku nowego parametru wprowadź:

    • Nazwa parametru: randCriteria
    • Typ parametru: Text
    • Wymagane: checked
    • Pobieranie danych z: Criteria
  4. Zostanie wyświetlona siatka. Wybierz pozycję Edytuj obok pustego pola tekstowego, aby otworzyć formularz Ustawienia kryteriów . Aby uzyskać opis każdego pola, zobacz Formularz ustawień kryteriów.

    Zrzut ekranu przedstawiający formularz Ustawienia kryteriów.

  5. Wprowadź następujące dane, aby wypełnić pierwsze kryteria, a następnie wybierz przycisk OK:

    • Pierwszy operand: rand
    • Operator: >
    • Wartość z: Static Value
    • Drugi operand: 0.25
    • Wartość z: Static Value
    • Wynik:is over 0.25

    Zrzut ekranu przedstawiający wypełniony formularz Ustawienia kryteriów.

  6. Wybierz pozycję Edytuj obok warunku Click edit to specify a result for the default condition , aby edytować warunek domyślny.

    Uwaga

    W przypadku warunku domyślnego wszystkie elementy powinny być wyłączone z wyjątkiem ostatnich Value from pól i Result is .

  7. Wprowadź następujące dane, aby wypełnić warunek domyślny, a następnie wybierz przycisk OK:

    • Wartość z: Wartość statyczna
    • Wynik: jest 0,25 lub poniżej

    Zrzut ekranu przedstawiający wypełniony formularz domyślny Ustawienia kryteriów.

  8. Zapisz parametr.

  9. Odśwież skoroszyt, aby zobaczyć randCriteria parametr w akcji. Jego wartość będzie oparta na wartości rand.

Formularz ustawień kryteriów

Pola formularza Opis
Pierwszy operand Ta lista rozwijana składa się z nazw parametrów, które zostały już utworzone. Wartość parametru będzie używana po lewej stronie porównania.
Operator Operator używany do porównywania pierwszych i drugich operandów. Może to być ocena liczbowa lub ciągowa. Operator wyłączy Second operand ten elementis empty, ponieważ jest wymagany.First operand
Wartość z Jeśli ustawiono wartość Parameter, zostanie wyświetlona lista rozwijana składająca się z parametrów, które zostały już utworzone. Wartość tego parametru będzie używana po prawej stronie porównania.
Jeśli ustawiono Static Valuewartość , zostanie wyświetlone pole tekstowe, w którym można wprowadzić wartość dla prawej strony porównania.
Drugi operand Będzie to menu rozwijane składające się z utworzonych parametrów lub pola tekstowego w zależności od poprzedniego zaznaczenia Value from .
Wartość z Jeśli ustawiono wartość Parameter, zostanie wyświetlona lista rozwijana składająca się z parametrów, które zostały już utworzone. Wartość tego parametru będzie używana dla wartości zwracanej bieżącego parametru.
Jeśli ustawiono wartość Static Value:
- Zostanie wyświetlone pole tekstowe, w którym można wprowadzić wartość dla wyniku.
— Można również wyłuszczyć inne parametry, używając nawiasów klamrowych wokół nazwy parametru.
— Można połączyć wiele parametrów i utworzyć ciąg niestandardowy, na przykład "{paramA}, {paramB}i jakiś ciąg".

Jeśli ustawiono wartość Expression:
- Zostanie wyświetlone pole tekstowe, w którym można wprowadzić wyrażenie matematyczne, które zostanie ocenione jako wynik.
— Podobnie jak w przypadku Static Value , wiele parametrów może zostać wyłuszonych w tym polu tekstowym.
- Jeśli wartość parametru, do których odwołuje się w polu tekstowym, nie jest liczbą, będzie traktowana jako wartość 0.
Wynik to Będzie to menu rozwijane składające się z utworzonych parametrów lub pola tekstowego w zależności od poprzedniego zaznaczenia Value from . Pole tekstowe zostanie ocenione jako ostateczny wynik tego formularza Ustawienia kryteriów .