`where`

Utilisez la commande where pour calculer la valeur d'une expression devant renvoyer True ou False.

Rubriques :

Syntaxe

*|where <expression>

Opérateurs disponibles avec la commande

Le tableau suivant répertorie les opérateurs disponibles avec la commande where. Reportez-vous également à Chaînes de temps conviviales dans les comparaisons.

Catégorie	Exemple
Opérateurs arithmétiques	`+`, `-`, `*`, `/`, `%`
Opérateurs de comparaison	`=`, `!=`, `<`, `>`, `<=`, `>=`
Opérateurs logiques	`and`, `or`, `not`
Opérateurs conditionnels	`if(<expression>,<expression>,<expression>)`
Opérateurs de comparaison multiples	`in`, `not in`

Fonctions disponibles avec la commande

Le tableau suivant répertorie les fonctions disponibles avec la commande where.

Catégorie	Exemple
Fonctions de chaîne	`capitalize(String)` `concat(String, String)` Pour la fonction `concat()`, vous pouvez entrer des types de données numériques (entier, nombre à virgule flottante, long, etc.). Les champs numériques sont remplacés automatiquement par les valeurs de chaîne correspondantes. Vous pouvez utiliser `\|\|` pour concaténer un nombre n d'entrées. Ici aussi, vous pouvez entrer des types de données numériques qui sont automatiquement remplacés par les valeurs de chaîne correspondantes. `decode64(String)` Remarque : Si la valeur de chaîne est un champ, il doit être sensible à la casse. `encode64(String)` `indexof(String, String [,int])` `lastindexof(String, String, int)` `length(String)` `literal(String)` `lower(String)` `ltrim(String, Character)` `replace(String, String, String)` `reverse(String)` `rtrim(String, Character)` `substr(String, int [, int])` `todate(String [, format])` `toduration(String)` `tonumber(String)` `trim(String)` `trim(String, Character)` `upper(String)` `urlDecode(String)` `urlEncode(String)`
Fonctions numériques	`abs(number)` `ceil(number)` `distance(number, number, number, number)` La valeur renvoyée par la fonction est en miles. Les nombres sont en degrés. `toRadians()` convertit les degrés en radians. `distance(string, string)` La valeur renvoyée par la fonction est en miles. Les nombres sont en degrés. `floor(number)` `formatduration(number)` `max(number, number)` `min(number, number)` `power(number, int)` `round(number, int)` `sqrt(number)` `tostring(number)`
Fonctions de date	`dateadd(date, property, amount)` `dateset(date, property, value [, property, value])` `formatdate(ate [,format])` `now()`
Fonctions conditionnelles	`cidrmatch(String, String)` `contains(String, String)` `endsWith(String, String)` `if(<expression>, <expression>, <expression>)` `startsWith(String, String)`
Fonctions de hachage	`md5(<value to hash>)` `sha1(<value to hash>)` `sha256(<value to hash>)` `sha512(<value to hash>)`
Fonctions trigonométriques	`arccos(<number>)` Arc cosinus d'un angle. `arcsin(<number>)` Arc sinus d'un angle. `arctan(<number>)` Arc tangent d'un angle. `atan2(<numbera>,<numberb>)` Angle en radians sur une coordonnée polaire, pour les coordonnées cartésiennes a et b. `cos(<number>)` Cosinus trigonométrique d'angle. `e()` Valeur de la constante mathématique e. `pi()` Valeur de pi. `sin(<number>)` Le sinus trigonométrique d'un angle en radians. `tan(<number>)` tangente d'un angle. `toDegrees(<number>)` Convertir de radians en degrés. `toRadians(<number>)` Convertir de degrés en radians.

Paramètres

Le tableau suivant répertorie les paramètres utilisés dans cette commande, ainsi que leur description.

Paramètre	Description
`boolean_expression`	Indiquez l'expression pour laquelle la valeur True ou False doit être calculée.

Chaînes de temps conviviales dans les comparaisons

La nouvelle fonctionnalité permet d'utiliser une chaîne lisible par l'utilisateur pour manipuler l'heure dans la requête. Auparavant, cela nécessitait d'utiliser toDuration() et de fournir la durée dans un format très spécifique.

Exemple 1 : ajoutez une durée à un champ d'horodatage.

* 
| eval '10mins. after End Time' = 'Event End Time' + 10mins
| fields 'Event End Time', '10mins. after End Time'

Exemple 2 : recherche les travaux qui ont pris plus de 2 heures.

* | where 'Event End Time' - Time > 2hrs

Exemple 3 : recherche les éléments qui ont pris plus d'un jour ou moins de quelques millisecondes.

* 
| link 
| where Count > 1000 and 
       ('End Time' - 'Start Time' > 3hour or 'End Time' - 'Start Time' < 2ms)

La chaîne temporelle peut être une valeur utilisée dans le paramètre span pour timestats. Reportez-vous à la liste de valeurs pour timescale dans timestats.

Pour des exemples d'utilisation de la commande where dans des scénarios standard, reportez-vous à la section suivante :

Voici quelques exemples de la commande where.

*|where severity = FATAL

*|where 'Client Host City' = 'redwood city'

*|where upper(severity) = FATAL

*|where length(URI) >= 40

*|where replace('aabbcc', 'bb', 'xx') = aaxxcc

*| where capitalize(severity) = Fatal

*|where concat(host, concat(':', port)) != hostname

*|where contains(uri, '.com')

*|where endsWith(uri, '.com')

*|where startsWith(uri, 'http://oracle')

*|where decode64(value) = decodeValue

*|where encode64(uri) = encodeValue

*|where lastindexOf(uri, '.com') != -1

*|where reverse(Command) = smaraptini

*|where host || ':' || port != hostname

*|where substr('aabbcc', 2, 4) = bb

*|where round('Content Size') = 1000

*|where floor('Content Size') > 1000

*|where max('Content Size In', ''Content Size Out') < 1000

*|where urlDecode('http%3A%2F%2Fexample.com%3A893%2Fsolr%2FCORE_0_0%2Fquery') = URI

*|where urlEncode(uri) = field

*|where 'User Name' in (host1, host2)

*| where arccos(angle) != NaN

*| where arcsin(angle) != NaN

*| where arctan(angle) != NaN

*| where atan2(x, y) != null

*| where cos(angle) > 0

*| where sin(angle) > e()

*| where sin(angle) > pi()

*| where sin(angle) > 0

*| where tan(angle) > 0

*| where toDegrees(angle) > 45

* | where toRadians(angle) > 0

L'exemple suivant illustre l'utilisation de la fonction conditionnelle if :

*|where if(Status = '200', OK, ERROR) = ERROR

L'exemple suivant compare les adresses IP du champ srvrhostip avec une plage de sous-réseaux.

*|where cidrmatch(srvrhostip, '192.0.2.254/25')

L'exemple suivant renvoie la valeur de chaîne du champ Delay.

*|where Status = literal(Delay)

L'exemple suivant enlève le caractère correspondant des deux extrémités.

*|where trim(Command,"\") = initparams

L'exemple suivant enlève le caractère correspondant de l'extrémité gauche.

*|where ltrim('Error ID',0) = 76890

L'exemple suivant enlève le caractère correspondant de l'extrémité droite.

*|where rtrim('OS Process ID',2) = 3123

L'exemple suivant compare la chaîne Start Time à 1/1/18 au format de date MM/dd/yy.

*|where 'Start Time' > toDate('1/1/18', 'MM/dd/yy')

L'exemple suivant calcule la différence entre les valeurs End Time et Start Time, et compare la chaîne à la durée 0:0:45.

*|where 'End Time' - 'Start Time' > toDuration('0:0:45')

L'exemple suivant indique le format de la durée comme 0:0:45.000.

*|where formatDuration('End Time' - 'Start Time') = '0:0:45.000'

Les exemples suivants illustrent l'utilisation des fonctions de date.

*|where 'Start Time' > dateAdd(now(), hour, -1)
*|where 'Start Time' > dateSet(now(), hour, 0, minute, 0, sec, 0, msec, 0)
*|where formatDate('Start Time', 'MM/dd/yyyy') = '01/15/2018'
*|where 'Start Time' - now() > 45000

L'exemple suivant calcule la position de .com dans la chaîne uri et évalue sa différence ou non avec -1.

*| where indexOf(uri, '.com') != -1

Vous pouvez utiliser les fonctions de hachage MD5, SHA1, SHA256 et SHA512 avec la commande where pour filtrer les données de journal. L'exemple suivant détermine si la valeur du champ user est md5("jack").

*|where user = md5("jack")

La commande suivante sépare le contenu du champ d'entité en deux parties. Par exemple, la valeur d'entité host-phx-1.oraclevcn.com avec le modèle est divisée en deux champs virtuels nommés Hôte et Domaine, avec la valeur de domaine oraclevcn.com :

* | extract field = Entity '(?P<Host>\w+)\.?(?P<Domain>.*)'
 | where contains(Domain, 'oraclevcn.com')
 | timestats count as logrecords by 'Log Source'

La commande suivante calcule la distance (en miles) entre deux paires de coordonnées lat-long spécifiées en degrés, lorsque les valeurs d'entrée sont des nombres, et vérifie si cette distance est supérieure à 1000 :

* | where distance(lat1, long1, lat2, long2) > 1000

La commande suivante calcule la distance (en miles) entre deux paires de coordonnées lat-longues (en degrés), lorsque les valeurs d'entrée sont deux chaînes, et vérifie si cette distance est supérieure à 1000 :

* | where distance('lat1,long1', 'lat2,long2') > 1000

Documentation Oracle Cloud Infrastructure

where

`where`