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