Direct Query scriptvariabelen
U kunt script-variabelen gebruiken om de interne structuur van een Direct Query-applicatie te beschrijven en te manipuleren of om extra uitvoerinformatie voor het herladen in te schakelen.
Gebruik de vervolgkeuzelijst om een korte beschrijving en de syntaxis van elke variabele te bekijken.
Met deze variabele kan een applicatie de ouderdom opgeven waarop een gecacht queryresultaat als verouderd wordt beschouwd.
De ouderdom wordt gedefinieerd vanaf het moment dat het resultaat voor het eerst in de cache is opgeslagen. Als de ouderdom van een gecacht resultaat groter is dan of gelijk is aan n seconden, wordt het als verouderd beschouwd en niet gebruikt als gecacht resultaat voor een overeenkomstige query. In plaats daarvan wordt de betreffende query uitgevoerd alsof er geen gecacht resultaat bestond.
Wanneer de query opnieuw wordt uitgevoerd, kan het nieuwe resultaat in de cache worden opgeslagen, afhankelijk van de huidige cache- en geheugenstatus. Indien gecacht, begint het opnieuw te verouderen totdat het na n seconden verouderd is.
De standaardwaarde voor deze variabele is 30. Dit betekent dat het gecachte 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 verouderingsduur van het gecachte 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 opgehaalde rijen voor de meeste diagrammen met Direct Query wordt bepaald 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 tonen, zelfs als een onbeperkte SQL-query voor de inhoud van het diagram zou leiden tot meer dan n rijen.
De scriptvariabele DirectQueryRowFetchMaxCount bestaat om het maximale aantal weer te geven rijen in een tabeldiagram te verhogen of te beperken, of om de maximale resultaten die op 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).
-
Het instellen van de scriptvariabele DirectQueryRowFetchMaxCount op een specifieke waarde groter dan 0 zorgt ervoor dat een query die een tabeldiagram vult, maximaal DirectQueryRowFetchMaxCount rijen uit de database kan 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 op de waarde -1 worden ingesteld.
| Waarde | Beschrijving |
|---|---|
| 0 |
Een waarde van 0 is een speciale waarde die alleen invloed heeft op het ophalen van rijen voor tabeldiagrammen. Deze instelling pagineert dynamisch over alle toepasselijke rijen (beïnvloed door selecties) om een tabeldiagram te vullen. Het bepalen van het totale maximale aantal rijen voor de paginering gebeurt door een initiële tellingquery uit te voeren om te bepalen hoeveel rijen de externe database in totaal zal retourneren voor de query die de tabel vult. Het instellen van deze variabele op 0 heeft tot gevolg dat alle andere ondersteunde Direct Query-diagrammen (behalve tabellen en spreidingsdiagrammen) hun standaard door de client opgegeven maximale aantal rijen ophalen. Spreidingsdiagrammen halen hun standaardmaximum van 2500 rijen op. InformatieOmdat 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. Merk op dat een spreidingsdiagram nooit meer dan 2500 rijen ophaalt om weer te geven. |
| > 100.000 | Hetzelfde effect als het instellen van de variabele op 0. |
DirectQueryRowFetchMaxCount=n;
De standaardwaarde van deze variabele is 0.
Het instellen van deze variabele op een waarde > 0 zorgt ervoor dat er extra informatie wordt opgenomen in de uitvoer van een Direct Query-applicatie bij de actie Gegevens laden (herladen).
De extra informatie toont de SQL-query die naar de externe database is verzonden om een voorbeeld te bekijken van het resultaat van een aangepaste SQL-definitie van een tabel. Deze informatie kan nuttig zijn voor het valideren, evalueren of verfijnen van de verwachtingen voor het resultaat van aangepaste SQL-instructies. Zie de variabele DirectQueryPreviewResp voor gerelateerde informatie.
DirectQueryPreviewSql=1;
De standaardwaarde van deze variabele is 0.
Het instellen van deze variabele op een waarde > 0 zorgt ervoor dat er extra informatie wordt opgenomen in de uitvoer van een Direct Query-applicatie bij de actie Gegevens laden (herladen).
De extra informatie toont de resultaten van een SQL-query die naar de externe database is verzonden met betrekking tot een aangepaste SQL-definitie van een tabel. Zie de variabele DirectQueryPreviewSql voor gerelateerde informatie.
DirectQueryPreviewResp=1;