Syntaxe et opérateurs

Référence complète de la syntaxe QuantumQL.

Structure générale

ACTION [measurement] WHERE condition1 AND condition2 [plage temporelle] [BY champ] [SORTED BY ordre] [LIMIT n]

Tous les mots-clés sont insensibles à la casse : SHOW, show, Show fonctionnent tous.

Actions

Mot-clé	Description
`SHOW` / `FIND` / `LIST`	Retourne les logs correspondants
`COUNT`	Retourne le nombre de logs

Measurement (optionnel)

Spécifiez la catégorie de log juste après l'action :

SHOW kill WHERE ...
SHOW chat WHERE ...
COUNT damage WHERE ...

Si omis, la requête s'applique à tous les types de logs.

Conditions

Opérateurs textuels

Opérateur	Description	Exemple
`IS`	Égalité exacte	`player_name IS "John"`
`CONTAINS`	Contient le texte	`value CONTAINS "headshot"`
`NOT CONTAINS`	Ne contient pas	`value NOT CONTAINS "suicide"`
`STARTS WITH`	Commence par	`player_name STARTS WITH "Admin"`
`ENDS WITH`	Finit par	`server ENDS WITH "-rp"`
`IN`	Parmi une liste	`measurement IN (kill, damage, chat)`

Opérateurs numériques (pour variables extraites)

Opérateur	Description	Exemple
`=`	Égal	`damage = 100`
`!=`	Différent	`damage != 0`
`>`	Supérieur	`damage > 50`
`<`	Inférieur	`damage < 10`
`>=`	Supérieur ou égal	`damage >= 100`
`<=`	Inférieur ou égal	`damage <= 5`

Pattern matching (extraction)

L'opérateur MATCHES permet d'extraire des données depuis le contenu du log :

value MATCHES "{joueur:string} dealt {degats:int} damage to {cible:string}"

Types disponibles dans les patterns :

string : Texte quelconque
int : Nombre entier

Combiner des conditions

Utilisez AND pour combiner plusieurs conditions :

SHOW kill WHERE player_name IS "John" AND server IS "serveur-rp" AND value CONTAINS "headshot"

Plages temporelles

Mots-clés

Mot-clé	Description
`TODAY`	Depuis minuit aujourd'hui
`YESTERDAY`	Hier (00:00 - 23:59)

Temps relatif

IN LAST n MINUTES
IN LAST n HOURS
IN LAST n DAYS
IN LAST n WEEKS
IN LAST n MONTHS

Exemples :

SHOW kill IN LAST 30 MINUTES
SHOW chat IN LAST 2 HOURS
COUNT damage IN LAST 7 DAYS

Dates absolues

SINCE "2025-01-01"
BETWEEN "2025-01-01" AND "2025-01-31"

Tri

Mot-clé	Description
`SORTED BY NEWEST`	Plus récents en premier
`SORTED BY OLDEST`	Plus anciens en premier

Groupement

BY champ

Regroupe les résultats par un champ (utile avec COUNT).

Limitation

LIMIT n

Limite le nombre de résultats retournés. Par défaut : 50.

Champs disponibles

Champ	Description
`player_name`	Nom du joueur
`player_id`	ID du joueur
`player_steam_id`	Steam ID du joueur
`player_global_id`	Global ID du joueur
`target_name`	Nom de la cible
`target_id`	ID de la cible
`target_steam_id`	Steam ID de la cible
`target_global_id`	Global ID de la cible
`server`	Identifiant du serveur
`measurement`	Type/catégorie de log
`value`	Contenu textuel du log