Catégories :

Fonctions système

SYSTEM$ESTIMATE_QUERY_ACCELERATION

Pour une requête précédemment exécutée, cette fonction renvoie un objet JSON qui spécifie si la requête est éligible pour bénéficier du service d’accélération des requêtes. Si la requête est éligible à l’accélération des requêtes, la sortie comprend le temps d’exécution estimé de la requête pour différents facteurs d’échelle d’accélération des requêtes.

Voir aussi :

Vue QUERY_ACCELERATION_ELIGIBLE

Syntaxe

SYSTEM$ESTIMATE_QUERY_ACCELERATION( '<query_id>' )
Copy

Paramètres

query_id

ID de la requête. L’ID de requête doit concerner une requête exécutée au cours des 14 derniers jours, sinon le status est invalid.

Sortie

La fonction renvoie un objet JSON avec les propriétés décrites ci-dessous :

Propriété

Description

estimatedQueryTimes

Objet contenant le temps d’exécution estimé des requêtes en secondes pour différents facteurs d’échelle d’accélération des requêtes. Si le status de la requête est non eligible pour l’accélération de la requête, cet objet est vide.

originalQueryTime

Temps d’exécution de la requête originale en secondes.

queryUUID

ID de la requête.

status

Une des valeurs suivantes qui indique si la requête est éligible ou non pour bénéficier du service d’accélération des requêtes :

eligible

La requête peut bénéficier de l’accélération des requêtes.

ineligible

La requête ne peut pas bénéficier de l’accélération des requêtes.

accelerated

La requête a déjà été accélérée.

invalid

La requête avec l’ID spécifié n’a pas été trouvée.

upperLimitScaleFactor

Numéro du facteur d’échelle d’accélération de la requête le plus élevé dans l’objet estimatedQueryTimes. Si le status de la requête est non eligible pour l’accélération de la requête, ce champ prend la valeur 0.

Dans l’objet estimatedQueryTimes, chaque paire nom/valeur spécifie un facteur d’échelle d’accélération de la requête et le temps d’exécution estimé de la requête à ce facteur d’échelle.

L’exemple suivant présente le temps d’exécution estimé des requêtes pour les facteurs d’échelle 1, 2, 4 et 8 :

...
"estimatedQueryTimes" : {
  "1" : 171,
  "2": 152,
  "4": 133,
  "8": 120
}
...
Copy

Notes sur l’utilisation

  • Les temps de requête estimés sont uniquement destinés à des fins d’analyse et ne sont pas garantis.

  • Les temps de requête estimés sont calculés en supposant que la requête est prise en charge par toutes les ressources de calcul allouées par le service d’accélération des requêtes en fonction du facteur d’échelle.

  • Les temps de requête estimés ne tiennent pas compte de la concurrence.

Examples

Pour des exemples de requêtes, consultez Identifier les requêtes avec la fonction SYSTEM$ESTIMATE_QUERY_ACCELERATION.