Type conversion functions - cast, try_cast, typeof | SLS - Simple Log Service

Utilisez les fonctions de conversion de type dans les instructions d'interrogation et d'analyse pour convertir les types de données.

SLS prend en charge les fonctions de conversion de type suivantes.

Important

Si vous souhaitez utiliser des chaînes de caractères dans les instructions d'analyse, vous devez les entourer de guillemets simples (''). Les chaînes non entourées de guillemets ou celles entourées de guillemets doubles ("") désignent des noms de champ ou de colonne. Par exemple, 'status' indique la chaîne de caractères « status », tandis que status ou "status" fait référence au champ de journal « status ».

Fonction	Syntaxe	Description	SQL	SPL
Fonction cast	cast(x as type)	Convertit le type de données de x. En cas d'échec de la conversion, l'intégralité de la requête échoue.	√	√
Fonction try_cast	try_cast(x as type)	Convertit le type de données de x. En cas d'échec de la conversion, renvoie NULL et poursuit le traitement. Remarque Privilégiez try_cast plutôt que cast pour éviter que des données incorrectes n'interrompent l'exécution de la requête entière.	√	×
Fonction typeof	typeof(x)	Renvoie le type de données de x.	√	×

Fonction cast

Convertit le type de données de x. En cas d'échec de la conversion, l'intégralité de la requête échoue.

Syntaxe

cast(x as type)

Paramètres

Paramètre

Description

Expression à convertir. Tous les types de données sont pris en charge.

type

Type de données SQL cible. Valeurs valides : bigint, varchar, double, boolean, timestamp, decimal, array et map.

Exemple : cast(json_parse(key) as array(varchar)).

Annexe : Mappage des types de données répertorie les correspondances entre les types d'index et les types SQL.

Type de valeur de retour

Le type de données spécifié par le paramètre type.

Exemples

SQL

Conversion de la valeur 1 en booléen.

Instruction d'interrogation et d'analyse
```
* | select cast(1 as boolean)
```
La requête renvoie true.

SPL

Conversion de la valeur 1 en booléen.

Instruction d'interrogation et d'analyse

* | extend a = cast(1 as boolean)

La valeur de a est true.

Fonction try_cast

Convertit le type de données de x. En cas d'échec de la conversion, renvoie NULL et poursuit le traitement.

Syntaxe

try_cast(x as type)

Paramètres

Paramètre

Description

Expression à convertir. Tous les types de données sont pris en charge.

type

Type de données SQL cible. Valeurs valides : bigint, varchar, double, boolean, timestamp, decimal, array et map.

Exemple : try_cast(json_parse(key) as map(varchar, varchar)).

Annexe : Mappage des types de données répertorie les correspondances entre les types d'index et les types SQL.

Type de valeur de retour

Le type de données spécifié par le paramètre type.

Exemples

Conversion du champ uid en varchar.

Instruction d'interrogation et d'analyse
```
* | select try_cast(uid as varchar)
```
Le résultat contient une colonne _col0. Les deux lignes affichent la valeur owner-01.

Fonction typeof

Renvoie le type de données de x.

Syntaxe

typeof(x)

Paramètres

Paramètre

Description

Expression à évaluer. Tous les types de données sont pris en charge.

Type de valeur de retour

varchar

Exemples

Vérification du type de données de request_time.

Instruction d'interrogation et d'analyse
```
* |SELECT typeof(request_time)
```
Le type de données de request_time est double.

Annexe : Mappage des types de données

Correspondances entre les types de données d'index et les types de données SQL :

Type de données d'index

Type de données SQL

long

bigint

text

varchar

double

json

varchar