Avec NRQL, vous pouvez créer des requêtes qui regroupent les résultats au fil du temps. Par exemple, vous pouvez regrouper les résultats en fonction de l'horodatage en les séparant en compartiments couvrant une plage spécifiée de dates et d'heures.
Lorsque vous utilisez les fonctions temporelles du tableau ci-dessous dans une requête NRQL , les résultats sont renvoyés en UTC. Pour ajuster les résultats à votre fuseau horaire, incluez la clauseWITH TIMEZONE dans votre requête.
Pour les fonctions qui ont un paramètre format facultatif, les valeurs acceptées sont string et numeric. La valeur de format par défaut sera string si elle est omise.
Time-based function | Description | String format | Numeric format |
|---|---|---|---|
| Renvoie l'année d'un horodatage. |
|
|
| Renvoie le trimestre de l'année. La valeur renvoyée inclut à la fois le trimestre et l'année lorsqu'elle est formatée sous forme de chaîne. |
|
|
| Renvoie le mois et l'année de l'horodatage lorsqu'il est formaté sous forme de chaîne, ou le mois numérique lorsqu'il est formaté sous forme de nombre. |
|
|
| Renvoie la semaine où l'horodatage s'est produit en nommant le mois et le jour du lundi de cette semaine. |
| N/A |
| Renvoie le jour de la semaine de l'horodatage. La valeur renvoyée revient à la fin de la semaine, vous permettant d'examiner les tendances par jour de la semaine au fil du temps. |
|
|
| Renvoie la date de l'horodatage. La valeur renvoyée comprend le mois, le jour et l'année. |
| N/A |
| Renvoie la date numérique dans un seul mois à partir de l'horodatage, une valeur de 1 à 31. La valeur renvoyée n'inclut pas le mois. |
|
|
| Renvoie le nombre de jours dans le mois de l'horodatage. |
|
|
| Renvoie l'heure de l'horodatage. La valeur renvoyée n'inclut pas de 0 préfixé pour les heures comprises entre 1h et 9h. Cela diffère des fonctions et des clauses telles que |
|
|
| Renvoie la minute de l'horodatage. La valeur renvoyée n'inclut pas de 0 préfixé pour les minutes comprises entre 1 et 9. Cela diffère des fonctions et des clauses telles que |
|
|
Évaluez la plage de temps de votre requête NRQL
Conseil
Dans ces exemples, nous utilisons un attribut d'horodatage personnalisé soumis avec l'événement PageView appelé createdAt. Pour effectuer un facettage en fonction du moment d'ingestion de l'événement PageView, vous pouvez utiliser l'attribut timestamp à la place.
Pour créer votre requête NRQL, utilisez une clauseFACET avec une fonction bucket qui fonctionne avec un attribut d'horodatage. Exécutez une requête FACET standard, mais au lieu de facetter par un attribut, facetter par le temps. Par exemple:
SELECT count(*) FROM K8sDaemonsetSample FACET monthOf(createdAt)
Pour exécuter plusieurs fonctions dans la même requête, utilisez la capacité multi-facettes de NRQL :
SELECT count(*) FROM K8sDaemonsetSample FACET dateOf(createdAt), monthOf(createdAt)
De nombreuses fonctions basées sur le temps acceptent un deuxième argument facultatif de string (valeur par défaut) ou numeric, qui contrôle le format de la valeur du résultat.
SELECT count(*) FROM K8sDaemonsetSample FACET monthOf(createdAt, numeric)