` lorsque la variable comporte une sélection, sinon en `1=1`. |
Les valeurs d'une variable peuvent également être interpolées directement sous la forme `$name` ou `${name}`, avec un format facultatif : `${name:sqlstring}` (par défaut), `${name:csv}` ou `${name:regex}`. Dans le format par défaut, une référence directe renvoie `NULL` tant qu'aucune valeur n'est sélectionnée ; utilisez donc de préférence les macros ci-dessus partout où un prédicat est attendu.
## Comment les résultats de la requête sont représentés
ClickStack associe automatiquement les colonnes du résultat de la requête aux éléments du graphique en fonction des types de colonnes. Les règles de correspondance varient selon le type de graphique.
### Graphiques en courbes et en barres empilées
| Rôle | Type de colonne | Description |
| ------------------- | ------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Horodatage** | Première colonne `Date` ou `DateTime` | Utilisée pour l’axe des x. |
| **Valeur de série** | Toutes les colonnes numériques | Chaque colonne numérique est représentée comme une série distincte. Il s’agit généralement de valeurs agrégées. |
| **Noms de groupe** | Colonnes String, Map ou Array | Facultatif. Les lignes ayant des valeurs de groupe différentes sont représentées comme des séries distinctes. |
### Diagramme circulaire
| Rôle | Type de colonne | Description |
| ---------------------- | ------------------------------------- | -------------------------------------------------------------------- |
| **Valeur du secteur** | Première colonne numérique | Détermine la taille de chaque secteur. |
| **Libellé du secteur** | Colonnes de type String, Map ou Array | Facultatif. Chaque valeur distincte devient le libellé d’un secteur. |
### Graphique numérique
| Rôle | Type de colonne | Description |
| ---------- | -------------------------- | ------------------------------------------------------------------------ |
| **Nombre** | Première colonne numérique | Affiche la valeur de la première ligne de la première colonne numérique. |
### Tableau
Toutes les colonnes de résultat sont affichées directement sous forme de colonnes de tableau.
## Exemples
**Accès requis aux tables système**
Vous devrez préciser `otel_v2.otel_logs` ou `otel_v2.otel_traces` si vous exécutez les exemples suivants sur [play-clickstack.clickhouse.com](https://play-clickstack.clickhouse.com).
### Graphique en courbes — nombre de logs au fil du temps par service
Cette requête compte les événements de log par service, regroupés en intervalles de temps correspondant à la granularité du tableau de bord.
```sql theme={null}
SELECT
toStartOfInterval(TimestampTime, INTERVAL {intervalSeconds:Int64} second) AS ts,
ServiceName,
count() AS count
FROM otel_logs
WHERE TimestampTime >= fromUnixTimestamp64Milli({startDateMilliseconds:Int64})
AND TimestampTime < fromUnixTimestamp64Milli({endDateMilliseconds:Int64})
AND $__filters
GROUP BY ServiceName, ts
ORDER BY ts ASC
```
* `ts` (DateTime) est utilisé comme horodatage pour l’axe des x.
* `count` (numérique) est représenté comme valeur de la série.
* `ServiceName` (chaîne) crée une ligne distincte pour chaque service.
### Graphique en courbes — avec des macros
La même requête, écrite avec des macros pour plus de concision :
```sql theme={null}
SELECT
$__timeInterval(TimestampTime) AS ts,
ServiceName,
count() AS count
FROM otel_logs
WHERE $__timeFilter(TimestampTime)
AND $__filters
GROUP BY ServiceName, ts
ORDER BY ts ASC
```
### Graphique en courbes — utilisation des variables de tableau de bord
Étant donné un tableau de bord comportant une variable `service` sur `ServiceName` et une variable `severity` sur `SeverityText`, cette requête limite le graphique à la sélection actuelle du service et exclut les niveaux de gravité sélectionnés. Les deux macros se développent en `1=1` lorsqu’aucune valeur n’est sélectionnée pour leur variable ; le graphique s’affiche donc sans filtre jusqu’à ce que l’utilisateur sélectionne une valeur.
```sql theme={null}
SELECT
$__timeInterval(TimestampTime) AS ts,
count() AS count
FROM otel_logs
WHERE $__timeFilter(TimestampTime)
AND $__filter(ServiceName, $service)
AND $__conditionalAll(SeverityText NOT IN ($severity), $severity)
GROUP BY ts
ORDER BY ts ASC
```
### Graphique en barres empilées — nombre d’erreurs par niveau de gravité
```sql theme={null}
SELECT
$__timeInterval(TimestampTime) AS ts,
lower(SeverityText),
count() AS count
FROM otel_logs
WHERE $__timeFilter(TimestampTime)
AND lower(SeverityText) IN ('error', 'warn')
AND $__filters
GROUP BY SeverityText, ts
ORDER BY ts ASC
```
### Tableau — les 10 endpoints les plus lents
```sql theme={null}
SELECT
SpanName AS endpoint,
avg(Duration) / 1000 AS avg_duration_ms,
count() AS request_count
FROM otel_traces
WHERE $__timeFilter(Timestamp)
AND $__filters
GROUP BY SpanName
ORDER BY avg_duration_ms DESC
LIMIT 10
```
### Diagramme circulaire — répartition des requêtes par service
```sql theme={null}
SELECT
ServiceName,
count() AS request_count
FROM otel_traces
WHERE $__timeFilter(Timestamp)
AND $__filters
GROUP BY ServiceName
```
* `request_count` (numérique) détermine la taille de chaque secteur.
* `ServiceName` (chaîne) correspond à l’étiquette de chaque secteur.
### graphique numérique — nombre total d’erreurs
```sql theme={null}
SELECT
count() AS total_errors
FROM otel_logs
WHERE $__timeFilter(TimestampTime)
AND SeverityText = 'error'
AND $__filters
```
L’unique valeur numérique `total_errors` de la première ligne est affichée.
## Remarques
* Les visualisations basées sur SQL s’exécutent en mode `readonly` — seules les requêtes `SELECT` sont autorisées.
* Les visualisations basées sur SQL doivent contenir exactement une requête SQL — les requêtes multiples ne sont pas prises en charge.
* L’éditeur SQL propose des suggestions d’autocomplétion pour les paramètres de requête comme pour les macros.
* Une source doit être sélectionnée pour appliquer les filtres du tableau de bord aux visualisations basées sur SQL. Pour un filtrage précis, la source doit correspondre à la table interrogée.
* Les variables de tableau de bord n’ont pas besoin de source — les valeurs proviennent des listes déroulantes de filtres du tableau de bord, et non de la source propre à la tuile.
* Les alertes sur une tuile SQL qui référence une variable de tableau de bord sont évaluées avec chaque variable dans son état vide, et non avec les valeurs sélectionnées sur le tableau de bord.