Zmienne skryptowe Direct Query
Możesz używać zmiennych skryptowych do opisywania wewnętrznej struktury aplikacji Direct Query i manipulowania nią lub do włączania dodatkowych informacji o wynikach przeładowania.
Użyj listy rozwijanej, aby wyświetlić krótki opis i składnię każdej zmiennej.
Ta zmienna pozwala aplikacji określić wiek, po którym buforowany wynik zapytania będzie uważany za nieaktualny.
Wiek jest liczony od momentu pierwszego zapisania wyniku w pamięci podręcznej. Jeśli wiek buforowanego wyniku jest większy lub równy n sekundom, jest on uważany za nieaktualny i nie jest używany jako buforowany wynik dla pasującego zapytania. Zamiast tego dane zapytanie zostanie wykonane tak, jakby żaden buforowany wynik nie istniał.
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 operacyjnej. Jeśli zostanie zapisany w pamięci podręcznej, zaczyna się ponownie starzeć, aż stanie się nieaktualny po n sekundach.
Domyślna wartość tej zmiennej to 30. Oznacza to, że buforowany wynik zapytania jest uważany za nieaktualny po 30 sekundach.
| Value | Description |
|---|---|
| -1 |
To ustawienie oznacza, że pamięć podręczna jest zachowywana przez czas, w którym użytkownik jest zalogowany. |
| 0 |
Buforowanie jest całkowicie wyłączone. |
| 1-9,223,372,036,854,775,807 | Ustawia wiek nieaktualności buforowanego wyniku w sekundach. |
| > 9,223,372,036,854,775,807 | Tak samo jak ustawienie zmiennej na wartość 30. |
DirectQueryResultCacheExpirySeconds=n;
Domyślna wartość maksymalnej liczby wierszy pobieranych dla większości wykresów przy użyciu Direct Query jest określana przez zapytanie klienta i może wynosić od 256 do 1000. Wyjątkiem są wykresy punktowe, dla których domyślne maksimum wynosi stale 2500. Oznacza to, że niektóre wykresy obsługiwane przez Direct Query nie pokażą więcej niż n wyników wierszy, nawet jeśli nieograniczone zapytanie SQL dotyczące zawartości wykresu dałoby w wyniku więcej niż n wierszy.
Zmienna skryptowa DirectQueryRowFetchMaxCount istnieje, aby umożliwić zwiększenie lub ograniczenie maksymalnej liczby wierszy do wyświetlenia na wykresie tabeli lub ograniczenie maksymalnej liczby wyników wyświetlanych na wykresie punktowym do wartości mniejszej niż domyślne maksimum wynoszące 2500.
Ponadto w przypadku zmiennej DirectQueryRowFetchMaxCount należy wziąć pod uwagę następujące kwestie:
-
Domyślna wartość zmiennej DirectQueryRowFetchMaxCount to -1 (co oznacza, że nie jest używana).
-
Ustawienie zmiennej skryptowej DirectQueryRowFetchMaxCount na określoną wartość większą niż 0 pozwala zapytaniu wypełniającemu wykres tabeli na pobranie maksymalnie DirectQueryRowFetchMaxCount wierszy z bazy danych — do maksymalnych wartości przedstawionych w poniższej tabeli.
-
Jeśli zmienna DirectQueryRowFetchMaxCount zostanie skonfigurowana na wartość z zakresu od 0 do 2500, wówczas wartość DirectQueryRowFetchMaxCount zostanie również użyta do ograniczenia maksymalnej liczby wierszy danych pobieranych w celu wypełnienia wykresu punktowego.
-
Aby cofnąć skutki działania zmiennej skryptowej DirectQueryRowFetchMaxCount, zmienna ta może pozostać niezdefiniowana lub zostać jawnie ustawiona na wartość -1.
| Value | Description |
|---|---|
| 0 |
Wartość 0 to wartość specjalna, która wpływa tylko na pobieranie wierszy wykresu tabeli. To ustawienie dynamicznie stronicuje wszystkie odpowiednie wiersze (pod wpływem dokonywanych wyborów) w celu wypełnienia wykresu tabeli. Określenie łącznej maksymalnej liczby wierszy do stronicowania odbywa się poprzez wykonanie wstępnego zapytania zliczającego w celu ustalenia, 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 wykresy Direct Query (z wyjątkiem tabel i wykresów punktowych) będą pobierać domyślną, określoną przez klienta maksymalną liczbę wierszy. Wykresy punktowe pobiorą domyślną maksymalną liczbę 2500 wierszy. InformacjaPonieważ powoduje to wykonywanie dwóch zapytań przy każdym ładowaniu lub wyborze zamiast jednego, może to być bardziej kosztowne pod względem wydajności bazy danych i kosztów.
|
| 1-100,000 | Ustawia maksymalną liczbę wierszy do pobrania dla wykresu tabeli lub wykresu punktowego ze zdalnej bazy danych. Uwaga: wykres punktowy nigdy nie pobierze do wyświetlenia więcej niż 2500 wierszy. |
| > 100,000 | Taki sam efekt jak ustawienie zmiennej na wartość 0. |
DirectQueryRowFetchMaxCount=n;
Domyślna wartość tej zmiennej to 0.
Ustawienie tej zmiennej na wartość > 0 umożliwia dołączenie dodatkowych informacji do danych wyjściowych akcji Ładuj dane (przeładowania) aplikacji Direct Query.
Dodatkowe informacje pokazują zapytanie SQL wysłane do zdalnej bazy danych w celu podglądu wyniku niestandardowej definicji SQL tabeli. Informacje te mogą być pomocne przy walidacji, ocenie lub doprecyzowywaniu oczekiwań dotyczących wyników niestandardowych instrukcji SQL. Powiązane informacje można znaleźć w opisie zmiennej DirectQueryPreviewResp.
DirectQueryPreviewSql=1;
Domyślna wartość tej zmiennej to 0.
Ustawienie tej zmiennej na wartość > 0 umożliwia dołączenie dodatkowych informacji do danych wyjściowych akcji Ładuj dane (przeładowania) aplikacji Direct Query.
Dodatkowe informacje pokazują wyniki zapytania SQL wysłanego do zdalnej bazy danych, powiązanego z niestandardową definicją SQL tabeli. Powiązane informacje można znaleźć w opisie zmiennej DirectQueryPreviewSql.
DirectQueryPreviewResp=1;