Simple Log Service:Fonctions de conversion d'unités

Fonction convert_data_size

Cette fonction convertit une taille de données vers une autre unité, soit automatiquement, soit vers une unité cible spécifiée.

Syntaxe

• Conversion d'une taille de données vers l'unité optimale, déterminée automatiquement par le système.

  convert_data_size(x)

• Conversion d'une taille de données vers une unité spécifiée.

  convert_data_size(x, unit)

Paramètres

Type de valeur de retour

Renvoie une chaîne de caractères.

Exemples

• Exemple 1 : convertir 1 200 Ko vers une autre unité.

  • Instruction de requête et d'analyse

    * | SELECT convert_data_size('1200KB')

  • Le résultat est 1.17MB.

• Exemple 2 : le champ body_bytes_sent représente le nombre d'octets envoyés au client. Cet exemple convertit la valeur du champ en Ko.

  • Instruction de requête et d'analyse

    * | select convert_data_size(format_data_size(body_bytes_sent, 'KB'))

  • La colonne _col0 affiche les tailles de données converties, telles que 1,74 Ko, 11,38 Ko, 4,12 Ko et 1,19 Ko. La requête utilise d'abord format_data_size pour convertir la valeur body_bytes_sent en une chaîne exprimée en Ko, puis la traite avec convert_data_size.

Fonction format_data_size

Formate une valeur en octets sous forme de chaîne dans une unité spécifiée.

Syntaxe

format_data_size(x, unit)

Paramètres

Type de valeur de retour

Renvoie une chaîne de caractères.

Exemples

• Exemple 1 : le champ body_bytes_sent représente le nombre d'octets envoyés à un client. Cet exemple convertit la valeur du champ en kilo-octets (Ko).

  • Échantillon de champ

    body_bytes_sent:4619

  • Instruction de requête et d'analyse

    * | select format_data_size(body_bytes_sent, 'KB')

  • La colonne _col0 des résultats de requête et d'analyse contient des valeurs telles que 7,33 Ko, 2,19 Ko, 4,16 Ko et 4,84 Ko.

• Exemple 2 : cet exemple calcule la somme du champ body_bytes_sent puis convertit le total en giga-octets (Go).

  • Échantillon de champ

    body_bytes_sent:4619

  • Instruction de requête et d'analyse

    * | select format_data_size(sum(body_bytes_sent), 'GB')

  • La colonne _col0 renvoie 0,73 Go, ce qui correspond à la somme formatée des valeurs du champ body_bytes_sent.

parse_data_size

Analyse une chaîne représentant une taille de données et renvoie la valeur équivalente en octets.

Syntaxe

parse_data_size(x)

Paramètres

Type de valeur de retour

Renvoie une valeur de type decimal.

Exemples

Convertissez 1 024 Ko en sa valeur équivalente en octets.

• Instruction de requête

  *| SELECT parse_data_size('1024KB')

• La requête renvoie 1048576, soit l'équivalent de 1 024 Ko en octets.

Fonction to_data_size_B

Convertit une taille de données en octets.

Syntaxe

to_data_size_B(x)

Paramètres

Type de valeur de retour

Renvoie une valeur de type double.

Exemples

Convertissez 1 024 Ko en sa valeur équivalente en octets.

• Instruction de requête et d'analyse

  * | select to_data_size_B('1024KB')

• Le résultat de la requête et de l'analyse est 1048576.0, soit l'équivalent de 1 024 Ko en octets.

to_data_size_KB

Convertit une taille de données en kilo-octets (Ko).

Syntaxe

to_data_size_KB(x)

Paramètres

Type de valeur de retour

La valeur de retour est un double.

Exemples

Le champ body_bytes_sent représente le nombre d'octets envoyés au client. Cet exemple convertit la valeur du champ en Ko.

• Instruction de requête et d'analyse

  * | select to_data_size_KB(format_data_size(body_bytes_sent, 'KB'))

• La colonne _col0 des résultats de requête et d'analyse contient les valeurs 3,52, 4,25, 3,2 et 1,69.

Fonction to_data_size_MB

Convertit une taille de données en mégaoctets (MB).

Syntax

to_data_size_MB(x)

Parameters

Return value type

Cette fonction renvoie une valeur de type double.

Examples

Le champ body_bytes_sent représente le nombre d'octets envoyés au client. Cet exemple convertit le total en mégaoctets (MB).

• Instruction de requête et d'analyse

  * | select to_data_size_MB(format_data_size(sum(body_bytes_sent), 'KB'))

• La requête renvoie 814.49, ce qui correspond à la somme de body_bytes_sent convertie en mégaoctets (MB).

Fonction to_data_size_GB

Convertit une taille de données en gigaoctets (GB).

Syntax

to_data_size_GB(x)

Parameters

Return value type

Une valeur de type double.

Examples

Le champ body_bytes_sent représente le nombre d'octets envoyés au client. Cet exemple convertit le total en gigaoctets (GB).

• Instruction de requête et d'analyse

  * | select to_data_size_GB(format_data_size(sum(body_bytes_sent), 'KB'))

• La requête renvoie 0.79. Cette valeur correspond au nombre total d'octets envoyés, exprimé en gigaoctets (GB).

Fonction to_data_size_TB

Convertit une taille de données en téraoctets (TB).

Syntax

to_data_size_TB(x)

Parameters

Return value type

Renvoie une valeur de type double.

Examples

Le champ body_bytes_sent représente le nombre d'octets envoyés à un client. Cet exemple convertit le total en téraoctets (TB).

• Instruction de requête

  * | select to_data_size_TB(format_data_size(sum(body_bytes_sent), 'KB'))

• La requête renvoie une seule colonne, _col0, avec la valeur 0.01, qui représente la somme de body_bytes_sent en téraoctets (TB).

Fonction to_data_size_PB

Convertit une taille de données en pétaoctets (PB).

Syntax

to_data_size_PB(x)

Parameters

Return value type

Renvoie une valeur de type double.

Examples

Convertissez 1 048 576 GB en pétaoctets (PB).

• Instruction de requête et d'analyse

  *| SELECT to_data_size_PB('1048576GB')

• Les résultats de la requête et de l'analyse renvoient 1.0, ce qui signifie que 1 048 576 GB équivaut à 1,0 PB.

Fonction format_duration

Formate un intervalle de temps en secondes dans une chaîne de caractères lisible par l'homme.

Syntax

format_duration(x)

Parameters

Return value type

Renvoie l'intervalle de temps formaté sous forme de chaîne de caractères.

Examples

Formate 235 secondes en 3 minutes, 55 seconds.

• Instruction de requête

  * | SELECT format_duration(235)

• La colonne _col0 renvoie 3 minutes, 55 seconds.

Fonction parse_duration

Analyse une chaîne d'intervalle de temps dans le format 0 00:00:00.000.

Syntax

parse_duration(x)

Parameters

Return value type

Renvoie une valeur de type interval.

Examples

Convertissez 1 340 millisecondes dans le format 0 00:00:01.340.

• Instruction de requête

  * | SELECT parse_duration('1340ms')

• La requête renvoie 0 00:00:01.340, ce qui représente 1 340 millisecondes dans le format standard d'intervalle de temps.

Fonction to_days

Convertit un intervalle de temps en jours.

Syntax

to_days(x)

Parameters

Return value type

Une valeur de type double.

Examples

Convertissez 192 848 s en jours.

• Instruction de requête

  *| SELECT to_days('192848s')

• La colonne _col0 renvoie 2, indiquant que 192 848 secondes équivalent à 2 jours.

Fonction to_hours

Convertit un intervalle de temps en heures.

Syntax

to_hours(x)

Parameters

Return value type

Renvoie une valeur de type double.

Examples

Convertissez un intervalle de temps de 1,2 jour en heures.

• Instruction de requête et d'analyse

  * | SELECT to_hours('1.2d')

• La valeur dans les résultats de la requête et de l'analyse est 28.8.

Fonction to_microseconds

Convertit un intervalle de temps en microsecondes.

Syntax

to_microseconds(x)

Parameters

Return value type

Renvoie une valeur de type double.

Examples

Convertissez 3 600 nanosecondes en microsecondes.

• Instruction de requête et d'analyse

  * | SELECT to_microseconds('3600ns')

• Le résultat de la requête et de l'analyse est 3.6 dans la colonne _col0.

Fonction to_milliseconds

Convertit un intervalle de temps en millisecondes.

Syntax

to_milliseconds(x)

Parameters

Return value type

Renvoie une valeur de type double.

Examples

Convertissez 1,2 seconde en millisecondes.

• Instruction de requête et d'analyse

  * | SELECT to_milliseconds('1.2s')

• Résultats de la requête et de l'analyse : la colonne _col0 renvoie la valeur 1200, ce qui signifie que 1,2 seconde équivaut à 1 200 millisecondes.

Fonction to_minutes

Convertit un intervalle de temps en minutes.

Syntax

to_minutes(x)

Parameters

Return value type

La valeur de retour est de type double.

Examples

Convertissez 1,2 heure en minutes.

• Instruction de requête et d'analyse

  * | SELECT to_minutes('1.2h')

• L'instruction renvoie 72.

Fonction to_most_succinct_time_unit

Convertit automatiquement un intervalle de temps dans son unité la plus concise.

Syntax

to_most_succinct_time_unit(x)

Parameters

Return value type

La valeur de retour est de type varchar.

Examples

Convertissez 1 340 ms en un intervalle de temps en secondes.

• Instruction de requête et d'analyse :

  * | SELECT to_most_succinct_time_unit('1340ms')

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

Fonction to_nanoseconds

Convertit un intervalle de temps en nanosecondes.

Syntax

to_nanoseconds(x)

Parameters

Return value type

Renvoie une valeur de type double.

Examples

Convertissez 125 millisecondes en leur équivalent en nanosecondes.

• Instruction de requête

  * | SELECT to_nanoseconds('125ms')

• La requête renvoie 125000000.

Fonction to_seconds

Convertit un intervalle de temps en secondes.

Syntax

to_seconds(x)

Parameters

Return value type

La valeur de retour est de type double.

Examples

Convertissez 1 340 millisecondes en secondes.

• Instruction de requête

  * | SELECT to_seconds('1340ms')

• Le résultat de la requête et de l'analyse est 1.34.