Chaîne
fonctionnelChangez la casse, tronquez, utilisez des modèles ou extrayez des chemins JSON pour que les colonnes de texte restent utiles d'un coup d'œil.
Le texte s'affiche tel qu'il est stocké, sans panneau de réglages universels. Quand une colonne a besoin d'aide, faites un clic droit sur son en-tête et choisissez Format › Définir une exception de mise en forme…. Pour les colonnes de texte, la liste rapide propose Texte original,
Majuscules, Minuscules, Masquer (afficher les 4 derniers), et Masquer tout. Formateur personnalisé…
ouvre un sélecteur qui garde les options les plus riches dans trois onglets dédiés, chacun avec un aperçu en direct. Ce que vous choisissez est écrit dans la requête sous la forme d'un
-- sqlly format:
ligne.


Modèle
Utilisez un {value} espace réservé avec des assistants de pipe pour la casse, la troncature, le remplissage et les autres petits ajustements qui rendent le texte plus facile à lire :
| Fonction utilitaire | Effet |
|---|---|
upper / lower | Changer la casse. |
trunc:N | Tronquer à N caractères, en ajoutant des points de suspension. |
prefix:S / suffix:S | Préfixer / suffixer du texte littéral. |
pad:N | Complétez à gauche avec des espaces jusqu'à la largeur N. |
default:S | Substituez S lorsque la valeur est vide. |
Les fonctions utilitaires s'exécutent de gauche à droite, et le texte en dehors des accolades est conservé tel quel :
| Valeur | Modèle | La grille affiche |
|---|---|---|
ada | {value|upper} | ADA |
abcdef | {value|trunc:3} | abc… |
123 | ORD-{value|pad:6} | ORD- 123 |
12 | {value|prefix:$|suffix: USD} | $12 USD |
| (chaîne vide) | {value|default:n/a} | n/a |
- NULL reste NULL. Les modèles ignorent complètement les cellules NULL, donc
default:remplit uniquement les chaînes vides. - Accolades littérales sont écrites en double :
{{et}}. - Une faute de frappe se manifeste. Un helper inconnu laisse le placeholder visible tel que saisi, par exemple
{value|nope}, plutôt que de supprimer silencieusement le texte. - Pas de points-virgules. La directive est séparée par des points-virgules, donc le sélecteur n'acceptera pas un modèle contenant
;.
-- sqlly format: column=code; template={value|upper}
-- sqlly format: column=notes; template={value|trunc:40}
Chemin JSON
Extraire une feuille utile d'une colonne de texte JSON, telle que $.customer.name
ou $.items[0]. Les chemins utilisent des segments de points, [n] des index, et des clés entre guillemets pour les noms avec des espaces ($["first name"]). Pour un
payload de
{"customer":{"name":"Ada"},"items":[{"sku":"A1"},{"sku":"B2"}]}:
| Chemin | La grille affiche |
|---|---|
$.customer.name | Ada |
$.items[1].sku | B2 |
$.items[0] | {"sku":"A1"} |
$.missing | (vide) |
Les chaînes apparaissent sans guillemets ; les nombres, true/false, et
null apparaissent tels quels ; les objets et les tableaux apparaissent en JSON compact. Lorsque le chemin ne résout pas ou que la cellule n'est pas un JSON valide, la cellule est vide, ou affiche votre texte de remplacement si vous avez configuré la colonne dans Paramètres › Résultats › Remplacements de colonnes, qui possède un champ Si manquant champ. Copier et exporter conservent le JSON complet ; pour explorer tout un document, ouvrez le
Visionneuse de cellules JSON et XML.
Nombre
Appliquer un style numérique avec vos décimales choisies et le regroupement des milliers :
| Style | Valeur | La grille affiche (2 décimales) |
|---|---|---|
| Corrigé | 1234567.891 | 1,234,567.89 |
Pourcentage (×100, ajoute %) | 0.1234 | 12.34% |
| Octets (B / KiB / MiB / GiB / TiB, par étapes de 1024) | 1536 | 1.50 KiB |
| Octets | 512 | 512 B |
Les formats Pourcentage et Octets fonctionnent sur toute colonne dont les valeurs se lisent comme des nombres - y compris les nombres stockés sous forme de texte, comme un varchar de tailles. Les valeurs qui ne sont pas des nombres sont laissées telles quelles. Fixe est enregistré comme un simple number= règle, elle met donc en forme les colonnes numériques. Octets affiche toujours des octets entiers en dessous de 1 Kio et ignore le regroupement des milliers.
-- sqlly format: column=size_bytes; number=2; style=bytes; thousands=true
-- sqlly format: column=hit_rate; number=1; style=percent; thousands=true
SELECT name, size_bytes, hit_rate FROM cache_stats;
Une règle par colonne
Chaque colonne n'accepte qu'une seule règle de formatage. Choisir à nouveau pour la même colonne remplace sa ligne dans la requête, et si deux lignes nomment la même colonne à la main, la dernière l'emporte. Impossible donc de cumuler un modèle et un style de nombre sur une même colonne.
En rapport : le texte sensible peut être masqué avec un mask= remplacement. Une mask= directive, comme un remplacement de masque dans Paramètres › Résultats › Remplacements de colonnes, masque la grille et copie et exporte aussi pendant Appliquer le formatage du masque aux copies et exportations qu'elle est activée. Tous les autres formats ici ne changent que ce que la grille affiche - voir le masquage.