Variabili di script Direct Query
Per descrivere e manipolare la struttura interna di un'app Direct Query, è possibile usare le variabili dello script.
Utilizzare l'elenco a discesa per visualizzare una breve descrizione e la sintassi di ciascuna variabile.
Questa variabile permette a un'applicazione di specificare un'età alla quale il risultato di una query nella cache sarà considerato non aggiornato.
L'età viene definita a partire dalla prima memorizzazione del risultato nella cache. Se l'età di un risultato nella cache è pari o superiore a n secondi, viene considerato non aggiornato e non viene utilizzato come risultato nella cache per una query corrispondente. Invece, la query in questione verrà eseguita come se non ci fossero risultati nella cache.
Quando la query viene eseguita nuovamente, il suo nuovo risultato potrebbe essere memorizzato nella cache, a seconda dello stato attuale della memoria e della cache. Se viene memorizzato nella cache, la sua età aumenterà nuovamente finché non sarà considerato non aggiornato a n secondi.
Il valore predefinito per questa variabile è 30. Ciò significa che il risultato della query nella cache viene considerato non aggiornato dopo 30 secondi.
Valore | Descrizione |
---|---|
-1 |
Questa impostazione significa che la cache viene mantenuta mentre l'utente è connesso. |
0 |
La memorizzazione nella cache è completamente disabilitata. |
1-9,223,372,036,854,775,807 | Imposta l'età alla quale il risultato nella cache sarà considerato non aggiornato in secondi. |
> 9,223,372,036,854,775,807 | Uguale all'impostazione del valore della variabile su 30. |
DirectQueryResultCacheExpirySeconds=n;
Il valore predefinito per il numero massimo di righe recuperate per la maggior parte dei grafici con Direct Query è determinato dalla query del client e può variare da 256 a 1000. L'eccezione è rappresentata dai grafici a dispersione, dove il numero massimo predefinito è fissato a 2500. Ciò significa che alcuni grafici supportati da Direct Query non mostreranno i risultati superiori a n righe, anche se una query SQL non limitata per il contenuto del grafico potrebbe dare generare più di n righe.
La variabile dello script DirectQueryRowFetchMaxCount esiste per consentire di aumentare o limitare il numero massimo di righe da visualizzare in un grafico a tabella o per limitare i risultati massimi visualizzati in un grafico a dispersione a un valore inferiore al massimo predefinito di 2500.
Inoltre, DirectQueryRowFetchMaxCount ha le seguenti considerazioni:
-
Il valore predefinito di DirectQueryRowFetchMaxCount è -1 (significa che non è utilizzato).
-
Impostando la variabile dello script DirectQueryRowFetchMaxCount su un valore specifico maggiore di 0, una query per il popolamento del grafico può recuperare fino a DirectQueryRowFetchMaxCount righe dal database, fino ai valori massimi indicati nella tabella sottostante.
-
Se DirectQueryRowFetchMaxCount è configurato per essere compreso tra 0 e 2500, il valore di DirectQueryRowFetchMaxCount verrà utilizzato anche per limitare il numero massimo delle righe di dati recuperate per il popolamento di un grafico a dispersione.
-
Per annullare gli effetti della variabile dello script DirectQueryRowFetchMaxCount, la variabile può essere indefinita oppure impostata esplicitamente sul valore -1.
Valore | Descrizione |
---|---|
0 |
Il valore 0 è un valore speciale che incide solo sul recupero delle righe del grafico a tabella. Questa impostazione esegue una paginazione dinamica per tutte le righe applicabili (influenzate dalle selezioni) per popolare un grafico a tabella. La determinazione del numero massimo di righe in totale per la paginazione viene completata eseguendo una query del conteggio iniziale per determinare quante righe in totale il database remoto restituirà per la query di popolamento della tabella. Impostando questa variabile su 0, tutti gli altri grafici di Direct Query supportati (a eccezione delle tabelle e dei grafici a dispersione) raggiungeranno il numero massimo di righe specificato dal cliente. I grafici a dispersione recupereranno un valore massimo predefinito di 2500 righe. Nota informaticaPoiché vengono eseguite due query anziché una per ogni caricamento o selezione, l'operazione può essere più costosa per quanto riguarda prestazioni e costi del database.
|
1-100.000 | Imposta il numero massimo di righe da recuperare per ogni grafico dal database remoto. Notare che un grafico a dispersione non recupererà mai più di 2500 righe da visualizzare. |
> 100.000 | Ha lo stesso effetto dell'impostazione del valore della variabile su 0. |
DirectQueryRowFetchMaxCount=n;