Zmienne skryptu Direct Query
Zmiennych skryptu można używać do opisywania wewnętrznej struktury aplikacji Direct Query i manipulowania nią.
Użyj menu rozwijanego, aby zobaczyć krótki opis i składnię każdej zmiennej.
Ta zmienna umożliwia aplikacji określenie wieku, w którym wynik zapytania w pamięci podręcznej zostanie uznany za nieaktualny.
Wiek jest definiowany od momentu pierwszego zapisania go w pamięci podręcznej. Jeśli wiek wyniku w pamięci podręcznej jest większy lub równy n sekundom, wynik jest uważany za nieaktualny i nie jest używany jako wynik w pamięci podręcznej dla pasującego zapytania. Zamiast tego zapytanie zostanie wykonane tak, jakby nie istniał żaden wynik w pamięci podręcznej.
Gdy zapytanie zostanie wykonane ponownie, jego nowy wynik może zostać zapisany w pamięci podręcznej w zależności od bieżącego stanu pamięci podręcznej i pamięci. Jeśli zostanie przechowany w pamięci podręcznej, zacznie się ponownie starzeć, aż stanie się nieaktualny po n sekundach.
Domyślna wartość tej zmiennej to 30. Oznacza to, że wynik zapytania w pamięci podręcznej jest uznawany za nieaktualny po 30 sekundach.
| Wartość | Opis |
|---|---|
| -1 |
To ustawienie oznacza, że pamięć podręczna jest przechowywana przez okres zalogowania użytkownika. |
| 0 |
Buforowanie jest całkowicie wyłączone. |
| 1-9,223,372,036,854,775,807 | Ustawia wiek nieaktualności wyniku w pamięci podręcznej w sekundach. |
| > 9,223,372,036,854,775,807 | To samo co ustawienie zmiennej na 30. |
DirectQueryResultCacheExpirySeconds=n;
Domyślna wartość maksymalnej liczby wierszy pobieranych dla większości wykresów z Direct Query jest określana przez zapytanie klienta i może wynosić od 256 do 1000. Wyjątkiem są wykresy punktowe, gdzie domyślne maksimum jest ustalone na 2500. Oznacza to, że niektóre obsługiwane przez Direct Query wykresy nie wyświetlą więcej niż n wyników wierszy, nawet jeśli nieograniczone zapytanie SQL dotyczące zawartości wykresu zwróciłoby więcej niż n wierszy.
Zmienna skryptu DirectQueryRowFetchMaxCount istnieje, aby umożliwić zwiększenie lub ograniczenie maksymalnej liczby wierszy do wyświetlenia w wykresie tabelarycznym lub ograniczenie maksymalnej liczby wyników wyświetlanych na wykresie punktowym do mniej niż domyślne maksimum 2500.
Dodatkowo, DirectQueryRowFetchMaxCount ma następujące uwagi:
-
Wartość domyślna DirectQueryRowFetchMaxCount wynosi -1 (co oznacza, że nie jest używana).
-
Ustawienie zmiennej skryptu DirectQueryRowFetchMaxCount na określoną wartość większą niż 0 pozwala zapytaniu wypełniającemu wykres tabelaryczny pobrać do DirectQueryRowFetchMaxCount wierszy z bazy danych – do maksymalnych wartości pokazanych w poniższej tabeli.
-
Jeśli DirectQueryRowFetchMaxCount jest skonfigurowana na wartość między 0 a 2500, to wartość DirectQueryRowFetchMaxCount będzie również używana do ograniczenia maksymalnej liczby wierszy danych pobieranych do wypełnienia wykresu punktowego.
-
Aby cofnąć efekty DirectQueryRowFetchMaxCount zmiennej skryptu, zmienna może być niezdefiniowana lub ustawiona jawnie na wartość -1.
| Wartość | Opis |
|---|---|
| 0 |
Wartość 0 jest wartością specjalną, która wpływa tylko na pobieranie wierszy wykresu tabeli. To ustawienie dynamicznie dzieli na strony wszystkie odpowiednie wiersze (zgodnie z wpływem zaznaczeń) w celu wypełnienia wykresu tabeli. Określenie maksymalnej łącznej liczby wierszy dla stronicowania odbywa się poprzez wykonanie początkowego zapytania zliczającego, aby ustalić, ile łącznie wierszy zwróci zdalna baza danych dla zapytania wypełniającego tabelę. Ustawienie tej zmiennej na 0 spowoduje, że wszystkie inne obsługiwane Direct Query wykresy (z wyjątkiem tabel i wykresów punktowych) pobiorą domyślną, określoną przez klienta, maksymalną liczbę wierszy. Wykresy punktowe pobiorą domyślnie maksymalnie 2500 wierszy. InformacjaPonieważ powoduje to wykonanie dwóch zapytań dla każdego ładowania lub wyboru zamiast jednego, może być droższe pod względem wydajności i kosztów bazy danych.
|
| 1-100,000 | Ustawia maksymalną liczbę wierszy do pobrania dla tabeli lub wykresu punktowego ze zdalnej bazy danych. Należy pamiętać, że wykres punktowy nigdy nie pobierze więcej niż 2500 wierszy do wyświetlenia. |
| > 100 000 | Taki sam efekt jak ustawienie zmiennej na 0. |
DirectQueryRowFetchMaxCount=n;