Direct Query-Skriptvariablen
Sie können Skriptvariablen verwenden, um die interne Struktur einer Direct Query-Anwendung zu beschreiben und zu verändern oder um zusätzliche Ladeausgabeinformationen zu ermöglichen.
Verwenden Sie die Dropdown-Liste, um eine kurze Beschreibung und die Syntax der einzelnen Variablen anzuzeigen.
Mit dieser Variablen kann eine Anwendung angeben, ab welchem Alter ein Abfrageergebnis im Cache als veraltet gilt.
Das Alter wird ab dem Zeitpunkt definiert, an dem das Ergebnis erstmals im Cache gespeichert wurde. Wenn das Alter eines im Cache gespeicherten Ergebnisses größer oder gleich n Sekunden ist, wird es als veraltet betrachtet und nicht als im Cache gespeichertes Ergebnis für eine übereinstimmende Abfrage verwendet. Stattdessen wird die betreffende Abfrage so ausgeführt, als wäre kein im Cache gespeichertes Ergebnis vorhanden.
Wenn die Abfrage erneut ausgeführt wird, kann das neue Ergebnis im Cache gespeichert werden, abhängig vom aktuellen Cache- und Arbeitsspeicherstatus. Nach dem Speichern im Cache beginnt das Ergebnis erneut zu altern, bis es nach n Sekunden veraltet ist.
Der Standardwert für diese Variable ist 30. Das bedeutet, dass das im Cache gespeicherte Abfrageergebnis nach 30 Sekunden als veraltet betrachtet wird.
| Wert | Beschreibung |
|---|---|
| -1 |
Diese Einstellung bedeutet, dass der Cache während der Zeit der Anmeldung des Benutzers beibehalten wird. |
| 0 |
Das Speichern im Cache ist vollständig deaktiviert. |
| 1-9,223,372,036,854,775,807 | Legt das Veralten des im Cache gespeicherten Ergebnisses in Sekunden fest. |
| > 9,223,372,036,854,775,807 | Entspricht der Einstellung der Variablen auf 30. |
DirectQueryResultCacheExpirySeconds=n;
Der Standardwert für die maximale Anzahl der abgerufenen Zeilen für die meisten Diagramme mit Direct Query wird von der Client-Abfrage bestimmt und kann zwischen 256 und 1000 variieren. Die Ausnahme bilden Streudiagramme, bei denen das Standardmaximum auf 2500 festgelegt ist. Das heißt, dass bestimmte von Direct Query unterstützte Diagramme nicht mehr als n Zeilen anzeigen, auch wenn eine nicht begrenzte SQL-Abfrage für den Inhalt des Diagramms mehr als n Zeilen liefern würde.
Mithilfe der Skriptvariable DirectQueryRowFetchMaxCount kann die maximale Anzahl der in einem Tabellendiagramm anzuzeigenden Zeilen erhöht oder begrenzt oder die maximale Anzahl der in einem Streudiagramm angezeigten Ergebnisse auf weniger als das Standardmaximum von 2500 beschränkt werden.
Darüber hinaus gelten für DirectQueryRowFetchMaxCount die folgenden Überlegungen:
-
Der Standardwert von DirectQueryRowFetchMaxCount lautet -1 (d. h. keine Verwendung).
-
Wenn Sie die Skriptvariable DirectQueryRowFetchMaxCount auf einen bestimmten Wert größer als 0 setzen, kann eine Abfrage zum Befüllen eines Tabellendiagramms bis zu DirectQueryRowFetchMaxCount Zeilen aus der Datenbank abrufen – jedoch nur bis zu den in der folgenden Tabelle angegebenen Maximalwerten.
-
Wenn DirectQueryRowFetchMaxCount für einen Wert zwischen 0 und 2500 konfiguriert ist, wird der Wert DirectQueryRowFetchMaxCount ebenfalls verwendet, um die maximale Anzahl der zur Befüllung eines Streudiagramms abgerufenen Datenzeilen zu begrenzen.
-
Um die Auswirkungen der Skriptvariablen DirectQueryRowFetchMaxCount rückgängig zu machen, kann die Variable entweder nicht angegeben oder explizit auf den Wert -1 gesetzt werden.
| Wert | Beschreibung |
|---|---|
| 0 |
Ein Wert von 0 ist ein spezieller Wert, der sich nur auf das Abrufen von Diagrammzeilen auswirkt. Diese Einstellung paginiert dynamisch über alle zutreffenden Zeilen (je nach Auswahl), um ein Tabellendiagramm zu befüllen. Um die maximale Anzahl der Zeilen für die Paginierung insgesamt zu bestimmen, führen Sie eine anfängliche Zählabfrage durch, um zu ermitteln, wie viele Zeilen die Remote-Datenbank insgesamt für die Auffüllabfrage der Tabelle zurückgibt. Wenn Sie diese Variable auf 0 setzen, werden alle anderen unterstützten Direct Query-Diagramme (mit Ausnahme von Tabellen und Streudiagrammen) die vom Kunden vorgegebene maximale Anzahl an Zeilen abrufen. Bei Streudiagrammen werden standardmäßig bis zu 2500 Zeilen geladen. InformationshinweisDa damit pro Ladevorgang oder Auswahl anstatt einer Abfrage zwei ausgeführt werden, kann dies die Datenbankleistung beeinträchtigen und die Kosten erhöhen.
|
| 1-100,000 | Legt die maximale Anzahl an Zeilen fest, die für eine Tabelle oder ein Streudiagramm aus der dezentralen Datenbank abgerufen werden können. In einem Streudiagramm werden maximal 2500 Zeilen angezeigt. |
| > 100,000 | Entspricht der Einstellung der Variablen auf 0. |
DirectQueryRowFetchMaxCount=n;
Der Standardwert für diese Variable ist 0.
Das Festlegen dieser Variable auf einen Wert > 0 ermöglicht, dass zusätzliche Informationen in die Ausgabe der Ladeaktion (Daten laden) einer Direct Query Anwendung eingeschlossen werden.
Die zusätzlichen Informationen zeigen die SQL-Abfrage, die an die Remotedatenbank gesendet wurde, um das Ergebnis einer benutzerdefinierten SQL-Definition einer Tabelle in der Vorschau anzuzeigen. Diese Informationen können für die Validierung, Bewertung oder Verfeinerung der Erwartungen an das Ergebnis benutzerdefinierter SQL-Anweisungen hilfreich sein. Zugehörige Informationen finden Sie unter der Variablen DirectQueryPreviewResp.
DirectQueryPreviewSql=1;
Der Standardwert für diese Variable ist 0.
Das Festlegen dieser Variable auf einen Wert > 0 ermöglicht, dass zusätzliche Informationen in die Ausgabe der Ladeaktion (Daten laden) einer Direct Query Anwendung eingeschlossen werden.
Die zusätzlichen Informationen zeigen die Ergebnisse einer SQL-Abfrage, die an die Remotedatenbank gesendet wurde, im Zusammenhang mit einer benutzerdefinierten SQL-Definition einer Tabelle. Zugehörige Informationen finden Sie unter der Variablen DirectQueryPreviewSql.
DirectQueryPreviewResp=1;