Simple Log Service:Fonctions d'agrégation

Fonction arbitrary

La fonction arbitrary renvoie une valeur non NULL arbitraire extraite de l'expression x.

Syntaxe

arbitrary(x)

Paramètres

Type de retour

Correspond au type de données de l'expression d'entrée.

Exemple

Renvoie une valeur non NULL arbitraire issue du champ request_method.

• Instruction de requête (Déboguer)

  * | SELECT
    arbitrary(request_method) AS request_method

• La colonne request_method renvoie une valeur telle que GET.

Fonction avg

La fonction avg renvoie la moyenne des valeurs contenues dans x.

Syntaxe

avg(x)

Paramètres

Type de valeur de retour

Valeur de type double.

Exemples

Fonction bitwise_and_agg

La fonction bitwise_and_agg renvoie le résultat de l'opération ET binaire (bitwise AND) appliquée à toutes les valeurs de x.

Syntaxe

bitwise_and_agg(x)

Paramètres

Type de valeur de retour

Valeur de type bigint.

Exemples

Effectue une opération ET binaire sur toutes les valeurs du champ status.

• Instruction de requête (Déboguer)

  * | SELECT
    bitwise_and_agg(status)

• La requête renvoie une seule colonne nommée _col0 avec la valeur 0.

Fonction bitwise_or_agg

La fonction bitwise_or_agg renvoie le résultat de l'opération OU binaire (bitwise OR) appliquée à toutes les valeurs de x.

Syntaxe

bitwise_or_agg(x)

Paramètres

Type de retour

Valeur de type bigint.

Exemple

Fonction bool_and

La fonction bool_and renvoie true si une expression booléenne est évaluée à true pour tous les journaux. Cette fonction est équivalente à la fonction every.

Syntaxe

bool_and(boolean expression)

Paramètres

Type de valeur de retour

booléen

Exemple

Cet exemple vérifie si la valeur request_time de tous les journaux est inférieure à 100.

• Instruction de requête et d'analyse (Déboguer)

  * | SELECT
    bool_and(request_time < 100)

• Le résultat de la requête et de l'analyse est true, ce qui indique que la valeur request_time de tous les journaux est inférieure à 100.

Fonction bool_or

La fonction bool_or renvoie true si une expression booléenne est évaluée à true pour au moins un journal.

Syntaxe

bool_or(boolean expression)

Paramètres

Type de valeur de retour

booléen

Exemples

Pour vérifier si la valeur request_time d'un journal quelconque est inférieure à 20 :

• Instruction de requête et d'analyse (Déboguer)

  * | SELECT
    bool_or(request_time < 20)

• Les résultats de la requête et de l'analyse renvoient la valeur true pour la colonne _col0, ce qui indique que le journal contient un enregistrement dont la valeur request_time est inférieure à 20.

Fonction checksum

La fonction checksum calcule la somme de contrôle (checksum) de x.

Syntaxe

checksum(x)

Paramètres

Type de valeur de retour

Chaîne encodée en Base64.

Exemple

• Instruction de requête (Déboguer)

  * | SELECT
    checksum(request_method) AS request_method

• La somme de contrôle du champ request_method est NDXFdgnd8GE=.

Fonction count

La fonction count permet de compter les journaux.

Syntaxe

• Compte le nombre total de journaux.

  count(*)

• Renvoie le nombre total de journaux. Cette syntaxe est équivalente à count(*).

  count(1)

• Compte les journaux pour lesquels x n'est pas NULL.

  count(x)

Paramètres

Type de valeur renvoyée

Un entier.

Exemples

• Exemple 1 : comptez les pages vues d'un site web.

  • Instruction de requête (Déboguer)

    * | SELECT
      count(*) AS PV

  • Résultats de la requête et de l'analyse : le tableau des résultats contient une colonne PV avec la valeur 2009.

• Exemple 2 : comptez les journaux dont le champ request_method n'est pas nul.

  • Instruction de requête (Déboguer)

    * | SELECT
      count(request_method) AS count

  • Résultats de la requête et de l'analyse : le tableau des résultats contient une colonne count avec la valeur 1954.

Fonction count_if

La fonction count_if compte les journaux qui satisfont une condition spécifiée.

Syntaxe

count_if(boolean expression)

Paramètres

Type de retour

Nombre de journaux satisfaisant la condition.

Exemple

Comptez le nombre d'entrées de journal dont la valeur du champ request_uri se termine par file-0.

• Instruction de requête et d'analyse (déboguer)

  * | SELECT
    count_if(request_uri like '%file-0') AS count

• Résultats de la requête et de l'analyse

Fonction geometric_mean

La fonction geometric_mean calcule la moyenne géométrique de x.

Syntaxe

geometric_mean(x)

Paramètres

Type de valeur renvoyée

Renvoie une valeur double.

Exemple

Calculez la moyenne géométrique du temps de requête.

• Instruction de requête et d'analyse (Déboguer)

  * | SELECT
    geometric_mean(request_time) AS time

• Les résultats de la requête et de l'analyse affichent une colonne time avec la valeur 39.443123208882308.

Fonction every

La fonction every renvoie true si une expression booléenne est évaluée comme vraie pour tous les journaux. Cette fonction est équivalente à la fonction bool_and.

Syntaxe

every(boolean expression)

Paramètres

Type de valeur renvoyée

Renvoie une valeur booléenne.

Exemple

Cet exemple vérifie si la valeur request_time de chaque journal est inférieure à 100.

• Instruction de requête et d'analyse (Déboguer)

  * | SELECT
    every(request_time < 100)

• Résultats de la requête et de l'analyse

Fonction kurtosis

Calcule l'aplatissement (kurtosis) de x.

Syntaxe

kurtosis(x)

Paramètres

Type de retour

double

Exemple

Calcule l'aplatissement du champ request_time.

• Instruction de requête (Déboguer)

  *| SELECT
    kurtosis(request_time)

• Résultats de la requête et de l'analyse

  kurtosis
  -3.0006998250171186

Fonction map_union

La fonction map_union renvoie l'union de toutes les cartes (maps) d'une colonne. Si la même clé existe dans plusieurs cartes d'entrée, la valeur associée à cette clé dans la carte résultante est choisie de manière non déterministe parmi l'une des entrées.

Syntaxe

map_union(x)

Paramètres

Type de valeur renvoyée

Renvoie une seule valeur de type map.

Exemple

Cet exemple agrège les valeurs de carte du champ etl_context en une seule carte.

• Exemple de champ

  etl_context: {
   project:"datalab-148****6461-cn-chengdu"
   logstore:"internal-etl-log"
   consumer_group:"etl-83****4d1965"
   consumer:"etl-b2d40ed****c8d6-291294"
   shard_id:"0" }

• Instruction de requête

  * | SELECT
    map_union(
      try_cast(json_parse(etl_context) AS map(varchar, varchar))
    )

• Résultats de la requête et de l'analyse : après exécution de l'instruction de requête, la colonne de résultat est nommée _col0 et sa valeur est une carte de paires clé-valeur analysées à partir de etl_context, contenant des champs tels que consumer_group, shard_id, project, logstore et consumer, ainsi que leurs valeurs correspondantes.

Fonction max

La fonction max renvoie la valeur maximale de x.

Syntaxe

• Renvoie la valeur maximale de x.

  max(x)

• Renvoie un tableau des n plus grandes valeurs de x.

  max(x, n)

Paramètres

Type de valeur renvoyée

Même type de données que l'expression d'entrée.

Exemples

• Exemple 1 : trouvez le temps de requête maximal.

  • Instruction de requête (Déboguer)

    * | SELECT
      max(request_time) AS max_request_time

  • Résultats de la requête et de l'analyse : la valeur de max_request_time est 80.0.

• Exemple 2 : trouvez les 10 temps de requête les plus élevés.

  • Instruction de requête (Déboguer)

    * | SELECT
      max(request_time, 10) AS "top 10"

  • Résultats de la requête et de l'analyse : la requête renvoie [80.0,80.0,80.0,80.0,80.0,79.0,79.0,79.0,78.0,78.0] pour la colonne top 10. Le tableau contient les 10 plus grandes valeurs de request_time classées par ordre décroissant.

Fonction max_by

La fonction max_by prend en charge les deux syntaxes suivantes.

Syntaxe

• Renvoie la valeur de x correspondant à la valeur maximale de y.

  max_by(x, y)

• Renvoie un tableau de valeurs x correspondant aux n plus grandes valeurs de y.

  max_by(x, y, n)

Paramètres

Type de valeur renvoyée

Identique au type de données de x.

Exemples

• Exemple 1 : trouvez l'heure de la commande présentant le montant hors taxe le plus élevé.

  • Instruction de requête et d'analyse

    * | SELECT
      max_by(UsageEndTime, PretaxAmount) AS time

  • Résultats de la requête et de l'analyse : la colonne time renvoie 1625731025.

• Exemple 2 : trouvez les méthodes de requête pour les trois requêtes ayant les temps de requête les plus longs.

  • Instruction de requête et d'analyse (déboguer)

    * | SELECT
      max_by(request_method, request_time, 3) AS method

  • Résultats de la requête et de l'analyse : la valeur de method est ["POST","POST","POST"], ce qui indique que les méthodes des trois requêtes les plus récentes triées par request_time sont toutes POST.

Fonction min

La fonction min renvoie la valeur minimale dans x.

Syntaxe

• Renvoie la valeur minimale dans x.

  min(x)

• Renvoie les n plus petites valeurs de x sous forme de tableau.

  min(x,n)

Paramètres

Type de valeur renvoyée

Identique au type de données de l'expression d'entrée.

Exemples

• Exemple 1 : trouvez le temps de requête minimal.

  • Instruction de requête et d'analyse (Déboguer)

    * | SELECT
      min(request_time) AS min_request_time

  • Les résultats de la requête et de l'analyse renvoient une colonne nommée min_request_time avec la valeur 10.0.

• Exemple 2 : trouvez les 10 temps de requête les plus petits.

  • Instruction de requête et d'analyse (Déboguer)

    * | SELECT
      min(request_time, 10)

  • Les résultats de la requête et de l'analyse renvoient une colonne nommée _col0 avec la valeur [10.0,10.0,10.0,10.0,10.0,11.0,12.0,12.0,13.0,13.0].

Fonction min_by

La fonction min_by dispose des deux syntaxes suivantes.

Syntaxe

• Renvoie la valeur de x correspondant à la valeur minimale de y.

  min_by(x, y)

• Renvoie un tableau de valeurs x correspondant aux n plus petites valeurs de y.

  min_by(x, y, n)

Paramètres

Type de valeur renvoyée

Même type de données que le paramètre x.

Exemples

• Exemple 1 : trouvez la méthode de requête pour la requête ayant le temps de requête minimal.

  • Instruction de requête et d'analyse (Déboguer)

    * | SELECT
      min_by(request_method, request_time) AS method

  • Résultats de la requête et de l'analyse : la colonne method renvoie GET.

• Exemple 2 : trouvez les méthodes de requête pour les trois requêtes ayant les temps de requête les plus courts.

  • Instruction de requête et d'analyse (Déboguer)

    * | SELECT
      min_by(request_method, request_time, 3) AS method

  • Résultats de la requête et de l'analyse.

Fonction skewness

La fonction skewness calcule l'asymétrie de l'expression x.

Syntaxe

skewness(x)

Paramètres

Type de valeur renvoyée

double

Exemple

Calculez l'asymétrie des valeurs du champ request_time.

• Instruction de requête et d'analyse (Déboguer)

  *| SELECT
    skewness(request_time) AS skewness

• Résultats de la requête et de l'analyse : la valeur skewness est 0.00042944441602043965.

Fonction sum

La fonction sum additionne les valeurs de l'expression x.

Syntaxe

sum(x)

Paramètres

Type de valeur renvoyée

Identique au type de données de l'expression d'entrée.

Exemples