Variabili di script di Direct Query
È possibile utilizzare le variabili di script per descrivere e manipolare la struttura interna di un'applicazione Direct Query.
Utilizzare il menu a discesa per visualizzare una breve descrizione e la sintassi di ciascuna variabile.
Questa variabile consente a un'applicazione di specificare l'età in cui il risultato di una query memorizzato nella cache verrà considerato obsoleto.
L'età è definita dal momento in cui il risultato è stato memorizzato per la prima volta nella cache. Se l'età di un risultato memorizzato nella cache è maggiore o uguale a n secondi, viene considerato obsoleto e non viene utilizzato come risultato memorizzato nella cache per una query corrispondente. Al contrario, la query in questione verrà eseguita come se non esistesse alcun risultato memorizzato nella cache.
Quando la query viene eseguita di nuovo, il suo nuovo risultato potrebbe essere memorizzato nella cache, a seconda dello stato corrente della cache e della memoria. Se memorizzato nella cache, ricomincia a invecchiare fino a diventare obsoleto a n secondi.
Il valore predefinito per questa variabile è 30. Ciò significa che il risultato della query memorizzato nella cache è considerato obsoleto dopo 30 secondi.
| Valore | Descrizione |
|---|---|
| -1 |
Questa impostazione significa che la cache viene mantenuta per tutto il tempo in cui l'utente è connesso. |
| 0 |
La memorizzazione nella cache è completamente disabilitata. |
| 1-9,223,372,036,854,775,807 | Imposta l'età di obsolescenza del risultato memorizzato nella cache in secondi. |
| > 9,223,372,036,854,775,807 | Equivale a impostare la variabile su 30. |
DirectQueryResultCacheExpirySeconds=n;
Il valore predefinito per il numero massimo di righe recuperate per la maggior parte dei grafici con Direct Query è guidato dalla query del client e può variare da 256 a 1000. L'eccezione sono i grafici a dispersione, in cui il massimo predefinito è fissato a 2500. Ciò significa che alcuni grafici supportati da Direct Query non mostreranno più di n risultati di riga, anche se una query SQL non limitata per il contenuto del grafico produrrebbe più di n righe.
La variabile di script DirectQueryRowFetchMaxCount esiste per consentire di aumentare o limitare le righe massime 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 presenta le seguenti considerazioni:
-
Il valore predefinito di DirectQueryRowFetchMaxCount è -1 (il che significa che non viene utilizzato).
-
L'impostazione della variabile di script DirectQueryRowFetchMaxCount su un valore specifico maggiore di 0 consente a una query di popolamento di un grafico a tabella di recuperare fino a DirectQueryRowFetchMaxCount righe dal database, fino ai valori massimi mostrati nella tabella seguente.
-
Se DirectQueryRowFetchMaxCount è configurato per essere compreso tra 0 e 2500, il valore DirectQueryRowFetchMaxCount verrà utilizzato anche per limitare le righe di dati massime recuperate per il popolamento di un grafico a dispersione.
-
Per annullare gli effetti della variabile di script DirectQueryRowFetchMaxCount, la variabile può essere non definita o impostata esplicitamente su un valore -1.
| Valore | Descrizione |
|---|---|
| 0 |
Un valore pari a 0 è un valore speciale che influisce solo sul recupero delle righe del grafico a tabella. Questa impostazione impagina dinamicamente tutte le righe applicabili (come influenzato dalle selezioni) per popolare un grafico a tabella. La determinazione del numero massimo di righe in totale per l'impaginazione viene eseguita effettuando una query di conteggio iniziale per determinare quante righe in totale il database remoto restituirà per la query di popolamento della tabella. L'impostazione di questa variabile su 0 farà sì che tutti gli altri grafici supportati da Direct Query (ad eccezione di tabelle e grafici a dispersione) recuperino il numero massimo di righe predefinito specificato dal client. I grafici a dispersione recupereranno il loro massimo predefinito di 2500 righe. Nota informaticaPoiché ciò esegue due query per ogni caricamento o selezione anziché una, può essere più costoso in termini di prestazioni e costi del database.
|
| 1-100,000 | Imposta il numero massimo di righe da recuperare per un grafico a tabella o a dispersione dal database remoto. Si noti che un grafico a dispersione non recupererà mai più di 2500 righe da visualizzare. |
| > 100,000 | Stesso effetto dell'impostazione della variabile su 0. |
DirectQueryRowFetchMaxCount=n;