Variables de script Direct Query
Vous pouvez utiliser des variables de script pour décrire et manipuler la structure interne d'une application Direct Query.
Pour afficher une description succincte et la syntaxe de chaque variable, utilisez le menu déroulant.
Cette variable permet à une application de spécifier l'âge auquel un résultat de requête mis en cache sera considéré comme périmé.
L'âge est défini à partir de la première mise en cache du résultat. Si l'âge d'un résultat mis en cache est supérieur ou égal à n secondes, le résultat est considéré comme périmé et il n'est pas utilisé comme résultat mis en cache pour une requête correspondante. Au lieu de cela, la requête en question sera exécutée comme s'il n'existait aucun résultat en cache.
Lorsque la requête est réexécutée, son nouveau résultat peut être mis en cache, suivant l'état existant de la mémoire et du cache. S'il est mis en cache, il commence de nouveau à vieillir jusqu'à devenir périmé au bout de n secondes.
La valeur par défaut de cette variable est de 30. Cela signifie que le résultat de requête mis en cache est considéré comme périmé au bout de 30 secondes.
| Valeur | Description |
|---|---|
| -1 |
Ce paramètre indique que le cache est conservé pendant la durée de connexion de l'utilisateur. |
| 0 |
La mise en cache est entièrement désactivée. |
| 1-9,223,372,036,854,775,807 | Définit l'âge de péremption du résultat mis en cache en secondes. |
| > 9,223,372,036,854,775,807 | Identique à la définition de la variable sur 30. |
DirectQueryResultCacheExpirySeconds=n;
La valeur par défaut du nombre maximal de lignes extraites pour la plupart des graphiques avec Direct Query est déterminée par la requête du client et peut varier de 256 à 1 000, à l'exception des nuages de points, pour lesquels le maximum par défaut est fixé à 2 500. Cela signifie que certains graphiques supportés par Direct Query n'afficheront pas plus de n lignes de résultats, même si une requête SQL non limitée portant sur le contenu du graphique donnerait plus de n lignes.
La variable de script DirectQueryRowFetchMaxCount permet d'augmenter ou de limiter le nombre maximal de lignes à afficher dans un graphique de table ou de limiter le nombre maximal de résultats affichés dans un graphique de nuage de points à une valeur inférieure à la valeur maximale par défaut de 2 500.
En outre, DirectQueryRowFetchMaxCount tient compte des considérations suivantes :
-
La valeur par défaut de DirectQueryRowFetchMaxCount est -1 (ce qui signifie que cette variable n'est pas utilisée).
-
La définition de la variable de script DirectQueryRowFetchMaxCount sur une valeur spécifique supérieure à 0 permet à une requête de renseignement d'un graphique de table d'extraire jusqu'à DirectQueryRowFetchMaxCount lignes de la base de données - jusqu'aux valeurs maximales indiquées dans le tableau ci-dessous.
-
Si la variable DirectQueryRowFetchMaxCount est configurée pour être comprise entre 0 et 2 500, la valeur DirectQueryRowFetchMaxCount sera également utilisée pour limiter le nombre maximal de lignes de données extraites pour renseigner un graphique de nuage de points.
-
Pour annuler les effets de la variable de script DirectQueryRowFetchMaxCount, la variable peut être soit non définie, soit explicitement définie sur une valeur -1.
| Valeur | Description |
|---|---|
| 0 |
La valeur 0 est une valeur spéciale qui n'affecte que l'extraction des lignes du graphique de table. Ce paramètre permet de paginer dynamiquement toutes les lignes applicables (en fonction des sélections) pour renseigner un graphique de table. La détermination du nombre maximal de lignes au total pour la pagination s'effectue en lançant une requête de comptage initiale pour déterminer le nombre de lignes au total que la base de données distante renverra pour la requête de renseignement de la table. Si vous fixez cette variable sur 0, tous les autres graphiques Direct Query supportés (à l'exception des tables et des nuages de points) extraient le nombre maximal de lignes spécifié par défaut par le client. Les nuages de points extraient leur maximum par défaut de 2 500 lignes. Note InformationsComme cela lance deux requêtes pour chaque chargement ou sélection au lieu d'une, cela peut avoir un impact sur les performances de la base de données et sur les coûts.
|
| 1-100 000 | Définit le nombre maximal de lignes à extraire pour un graphique de table ou de nuage de points auprès de la base de données distante. Notez qu'un graphique de nuage de points n'extraira jamais plus de 2 500 lignes à afficher. |
| > 100 000 | Même effet que la définition de la variable sur 0. |
DirectQueryRowFetchMaxCount=n;