Direct Query scriptvariabelen
U kunt scriptvariabelen gebruiken om de interne structuur van een Direct Query-applicatie te beschrijven en te manipuleren.
Gebruik de vervolgkeuzelijst voor een korte beschrijving en de syntaxis van elke variabele.
Met deze variabele kan een applicatie de leeftijd opgeven waarop een in de cache opgeslagen queryresultaat als verouderd wordt beschouwd.
De leeftijd wordt gedefinieerd vanaf het moment dat het resultaat voor het eerst in de cache is opgeslagen. Als de leeftijd van een in de cache opgeslagen resultaat groter is dan of gelijk is aan n seconden, wordt het als verouderd beschouwd en wordt het niet gebruikt als een in de cache opgeslagen resultaat voor een overeenkomende query. In plaats daarvan wordt de betreffende query uitgevoerd alsof er geen in de cache opgeslagen resultaat bestaat.
Wanneer de query opnieuw wordt uitgevoerd, kan het nieuwe resultaat in de cache worden opgeslagen, afhankelijk van de huidige cache- en geheugenstatus. Als het in de cache is opgeslagen, begint het weer ouder te worden totdat het na n seconden verouderd is.
De standaardwaarde voor deze variabele is 30. Dit betekent dat het in de cache opgeslagen queryresultaat na 30 seconden als verouderd wordt beschouwd.
| Waarde | Beschrijving |
|---|---|
| -1 |
Deze instelling betekent dat de cache wordt bewaard gedurende de tijd dat de gebruiker is ingelogd. |
| 0 |
Caching is volledig uitgeschakeld. |
| 1-9.223.372.036.854.775.807 | Stelt de verouderingsleeftijd van het in de cache opgeslagen resultaat in seconden in. |
| > 9.223.372.036.854.775.807 | Hetzelfde als het instellen van de variabele op 30. |
DirectQueryResultCacheExpirySeconds=n;
De standaardwaarde voor het maximale aantal rijen dat wordt opgehaald voor de meeste diagrammen met Direct Query wordt aangestuurd door de clientquery en kan variëren van 256 tot 1000. De uitzondering hierop zijn spreidingsdiagrammen, waarbij het standaardmaximum is vastgesteld op 2500. Dit betekent dat sommige door Direct Query ondersteunde diagrammen niet meer dan n rijresultaten zullen tonen, zelfs als een onbeperkte SQL-query voor de inhoud van het diagram zou resulteren in meer dan n rijen.
De scriptvariabele DirectQueryRowFetchMaxCount bestaat om het mogelijk te maken het maximale aantal rijen dat in een tabeldiagram wordt weergegeven te verhogen of te beperken, of om de maximale resultaten die in een spreidingsdiagram worden weergegeven te beperken tot minder dan het standaardmaximum van 2500.
Daarnaast gelden voor DirectQueryRowFetchMaxCount de volgende overwegingen:
-
De standaardwaarde van DirectQueryRowFetchMaxCount is -1 (wat betekent dat deze niet wordt gebruikt).
-
Door de scriptvariabele DirectQueryRowFetchMaxCount in te stellen op een specifieke waarde groter dan 0, kan een query die een tabeldiagram vult, maximaal DirectQueryRowFetchMaxCount rijen uit de database ophalen - tot de maximale waarden die in de onderstaande tabel worden weergegeven.
-
Als DirectQueryRowFetchMaxCount is geconfigureerd tussen 0 en 2500, wordt de waarde van DirectQueryRowFetchMaxCount ook gebruikt om het maximale aantal gegevensrijen te beperken dat wordt opgehaald voor het vullen van een spreidingsdiagram.
-
Om de effecten van de scriptvariabele DirectQueryRowFetchMaxCount ongedaan te maken, kan de variabele ongedefinieerd worden gelaten of expliciet worden ingesteld op een waarde van -1.
| Waarde | Beschrijving |
|---|---|
| 0 |
Een waarde van 0 is een speciale waarde die alleen van invloed is op het ophalen van rijen voor tabeldiagrammen. Deze instelling pagineert dynamisch over alle toepasselijke rijen (zoals beïnvloed door selecties) voor het vullen van een tabeldiagram. Het bepalen van het maximale aantal rijen in totaal voor de paginering wordt gedaan door een initiële telquery uit te voeren om te bepalen hoeveel rijen de externe database in totaal zal retourneren voor de query die de tabel vult. Als u deze variabele instelt op 0, zullen alle andere ondersteunde Direct Query-diagrammen (behalve tabellen en spreidingsdiagrammen) hun standaard door de client gespecificeerde maximale aantal rijen ophalen. Spreidingsdiagrammen halen hun standaardmaximum van 2500 rijen op. InformatieAangezien dit twee query's uitvoert voor elke laadactie of selectie in plaats van één, kan dit duurder zijn wat betreft databaseprestaties en -kosten.
|
| 1-100.000 | Stelt het maximale aantal rijen in dat moet worden opgehaald voor een tabel- of spreidingsdiagram uit de externe database. Houd er rekening mee dat een spreidingsdiagram nooit meer dan 2500 rijen zal ophalen om weer te geven. |
| > 100.000 | Hetzelfde effect als het instellen van de variabele op 0. |
DirectQueryRowFetchMaxCount=n;