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:
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/sec
wartość , , Bytes Sent/sec
Total Bytes Received
lub Total Bytes Transmitted
.
Można to przetłumaczyć na parametr tekstowy 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
Zacznij od skoroszytu z co najmniej jednym istniejącym parametrem w trybie edycji.
- Wybierz pozycję Dodaj parametry Dodaj parametr>.
- 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.
- Nazwa parametru:
- Wybierz pozycję Zapisz , aby utworzyć parametr.
Uwaga
Pierwszy parametr w skoroszycie nie będzie pokazywał karty Kryteria .
W tabeli z parametrem
rand
wybierz pozycję Dodaj parametr.W otwartym okienku nowego parametru wprowadź:
- Nazwa parametru:
randCriteria
- Typ parametru:
Text
- Wymagane:
checked
- Pobieranie danych z:
Criteria
- Nazwa parametru:
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.
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
- Pierwszy operand:
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 iResult is
.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
Zapisz parametr.
Odśwież skoroszyt, aby zobaczyć
randCriteria
parametr w akcji. Jego wartość będzie oparta na wartościrand
.
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 Value wartość , 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 . |