Direct Query-skriptvariabler
Du kan använda skriptvariabler för att beskriva och manipulera den interna strukturen för en Direct Query-applikation eller för att aktivera ytterligare information om laddningsutdata.
Använd rullgardinsmenyn för att se en kort beskrivning och syntaxen för varje variabel.
Denna variabel gör det möjligt för en applikation att ange den ålder då ett cachelagrat frågeresultat ska anses vara föråldrat.
Åldern definieras från när resultatet först cachelagrades. Om åldern på ett cachelagrat resultat är större än eller lika med n sekunder, anses det vara föråldrat och används inte som ett cachelagrat resultat för en matchande fråga. Istället kommer frågan i fråga att köras som om inget cachelagrat resultat fanns.
När frågan körs igen kan dess nya resultat cachelagras, beroende på det aktuella cache- och minnestillståndet. Om det cachelagras börjar det åldras igen tills det blir föråldrat vid n sekunder.
Standardvärdet för denna variabel är 30. Detta innebär att det cachelagrade frågeresultatet anses vara föråldrat efter 30 sekunder.
| Värde | Beskrivning |
|---|---|
| -1 |
Denna inställning innebär att cachen behålls under den tid användaren är inloggad. |
| 0 |
Cachelagring är helt inaktiverad. |
| 1-9,223,372,036,854,775,807 | Anger det cachelagrade resultatets föråldringsålder i sekunder. |
| > 9,223,372,036,854,775,807 | Samma som att ställa in variabeln till 30. |
DirectQueryResultCacheExpirySeconds=n;
Standardvärdet för det maximala antalet rader som hämtas för de flesta diagram med Direct Query styrs av klientfrågan och kan variera från 256 till 1000. Undantaget är punktdiagram, där det maximala standardvärdet är fastställt till 2500. Detta innebär att vissa diagram som stöds av Direct Query inte visar mer än n radresultat, även om en obegränsad SQL-fråga för diagrammets innehåll skulle resultera i fler än n rader.
Skriptvariabeln DirectQueryRowFetchMaxCount finns för att göra det möjligt att öka eller begränsa det maximala antalet rader som ska visas i ett tabelldiagram, eller för att begränsa de maximala resultaten som visas i ett punktdiagram till mindre än standardmaximum på 2500.
Dessutom har DirectQueryRowFetchMaxCount följande överväganden:
-
Standardvärdet för DirectQueryRowFetchMaxCount är -1 (vilket innebär att det inte används).
-
Att ställa in skriptvariabeln DirectQueryRowFetchMaxCount till ett specifikt värde större än 0 gör att en fråga som fyller i ett tabelldiagram kan hämta upp till DirectQueryRowFetchMaxCount rader från databasen – upp till de maxvärden som visas i tabellen nedan.
-
Om DirectQueryRowFetchMaxCount är konfigurerat att vara mellan 0 och 2500, kommer värdet för DirectQueryRowFetchMaxCount även att användas för att begränsa det maximala antalet datarader som hämtas för att fylla i ett punktdiagram.
-
För att ångra effekterna av skriptvariabeln DirectQueryRowFetchMaxCount kan variabeln antingen vara odefinierad eller uttryckligen ställas in på värdet -1.
| Värde | Beskrivning |
|---|---|
| 0 |
Värdet 0 är ett specialvärde som endast påverkar radhämtning för tabelldiagram. Denna inställning sidindelar dynamiskt över alla tillämpliga rader (som påverkas av val) för att fylla i ett tabelldiagram. Fastställandet av det totala maximala antalet rader för sidindelningen görs genom att utföra en inledande räknefråga för att avgöra hur många rader totalt som fjärrdatabasen kommer att returnera för tabellens ifyllningsfråga. Att ställa in denna variabel till 0 leder till att alla andra diagram som stöds av Direct Query (utom tabeller och punktdiagram) hämtar sitt standardmässiga klientspecifika maximala antal rader. Punktdiagram hämtar sitt standardmaximum på 2500 rader. Anteckning om informationEftersom detta utför två frågor för varje laddning eller val istället för en, kan det vara mer krävande vad gäller databasprestanda och kostnader.
|
| 1-100,000 | Anger det maximala antalet rader som ska hämtas för ett tabelldiagram eller punktdiagram från fjärrdatabasen. Observera att ett punktdiagram aldrig kommer att hämta mer än 2500 rader för visning. |
| > 100,000 | Samma effekt som att ställa in variabeln till 0. |
DirectQueryRowFetchMaxCount=n;
Standardvärdet för denna variabel är 0.
Att ställa in denna variabel till ett värde > 0 gör att ytterligare information kan inkluderas i utdata från en Direct Query-applikation vid åtgärden Ladda data (omladdning).
Den ytterligare informationen visar den SQL-fråga som skickas till fjärrdatabasen för att förhandsgranska resultatet av en anpassad SQL-definition av en tabell. Denna information kan vara användbar för att validera, utvärdera eller förfina förväntningar på resultat från anpassade SQL-satser. Se variabeln DirectQueryPreviewResp för relaterad information.
DirectQueryPreviewSql=1;
Standardvärdet för denna variabel är 0.
Att ställa in denna variabel till ett värde > 0 gör att ytterligare information kan inkluderas i utdata från en Direct Query-applikation vid åtgärden Ladda data (omladdning).
Den ytterligare informationen visar resultaten av en SQL-fråga som skickas till fjärrdatabasen relaterad till en anpassad SQL-definition av en tabell. Se variabeln DirectQueryPreviewSql för relaterad information.
DirectQueryPreviewResp=1;