Variabili di script di Direct Query
È possibile utilizzare le variabili di script per descrivere e manipolare la struttura interna di un' applicazione Direct Query o per abilitare informazioni aggiuntive sull'output di ricaricamento.
Utilizzare il menu a discesa per visualizzare una breve descrizione e la sintassi di ciascuna variabile.
Questa variabile consente a un'applicazione di specificare il periodo di tempo dopo il quale il risultato di una query memorizzato nella cache viene considerato obsoleto.
Tale periodo viene definito a partire dal momento in cui il risultato è stato memorizzato nella cache per la prima volta. Se il periodo di un risultato memorizzato nella cache è superiore o uguale a n secondi, questo 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 nuovamente, il suo nuovo risultato potrebbe essere memorizzato nella cache, a seconda dello stato corrente della cache e della memoria. Se memorizzato nella cache, inizia nuovamente 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 viene considerato obsoleto dopo 30 secondi.
| Valore | Descrizione |
|---|---|
| -1 |
Questa impostazione indica che la cache viene conservata per il tempo in cui l'utente è connesso. |
| 0 |
La memorizzazione nella cache è completamente disabilitata. |
| 1-9,223,372,036,854,775,807 | Imposta il periodo 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 è rappresentata dai 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 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, per DirectQueryRowFetchMaxCount valgono le seguenti considerazioni:
-
Il valore predefinito di DirectQueryRowFetchMaxCount è -1 (ovvero non viene utilizzato).
-
L'impostazione della variabile di script DirectQueryRowFetchMaxCount su un valore specifico maggiore di 0 consente a una query di popolamento del 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 di 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 pari a -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 (influenzate dalle selezioni) per il popolamento di 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 restituirà il database remoto per la query di popolamento della tabella. L'impostazione di questa variabile su 0 farà sì che tutti gli altri grafici Direct Query supportati (eccetto 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é questa operazione esegue due query per ogni caricamento o selezione anziché una, può essere più onerosa 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;
Il valore predefinito di questa variabile è 0.
L'impostazione di questa variabile su un valore > 0 consente di includere informazioni aggiuntive nell'output di un'azione Carica dati (ricaricamento) dell' applicazione Direct Query.
Le informazioni aggiuntive mostrano la query SQL inviata al database remoto per visualizzare in anteprima il risultato di una definizione SQL personalizzata di una tabella. Queste informazioni possono essere utili per convalidare, valutare o perfezionare le aspettative sui risultati delle istruzioni SQL personalizzate. Vedere la variabile DirectQueryPreviewResp per informazioni correlate.
DirectQueryPreviewSql=1;
Il valore predefinito di questa variabile è 0.
L'impostazione di questa variabile su un valore > 0 consente di includere informazioni aggiuntive nell'output di un'azione Carica dati (ricaricamento) dell' applicazione Direct Query.
Le informazioni aggiuntive mostrano i risultati di una query SQL inviata al database remoto correlata a una definizione SQL personalizzata di una tabella. Vedere la variabile DirectQueryPreviewSql per informazioni correlate.
DirectQueryPreviewResp=1;