Mise en forme

fonctionnel

Rendez les nombres, dates, identifiants et textes plus faciles à parcourir sans modifier les données sous-jacentes.

Le formatage aide un ensemble de résultats à se lire comme une réponse plutôt qu'un flux brut de données. SQLly commence par le type de colonne, puis vous permet de définir des valeurs par défaut ou de faire une exception délibérée pour chaque colonne. Les deux chemins alimentent le même modèle de formatage :

  1. Valeurs par défaut par type. Ouvrir Paramètres › Résultats pour choisir comment chaque type apparaît dans SQLly.
  2. Remplacement par colonne. Cliquez avec le bouton droit sur un en-tête et choisissez Format › Définir une exception de mise en forme…. SQLly écrit une -- sqlly format: directive dans la requête, de sorte que le choix voyage avec le fichier.

Les types numériques et temporels partagent également une alignement alignement (gauche, centre ou droite), donc inutile de la répéter sur chaque page ci-dessous. Les nombres commencent alignés à droite pour que leurs chiffres s'alignent ; les dates commencent alignées à gauche.

Comment SQLly choisit un type

Le type déclaré de chaque colonne décide des valeurs par défaut qui s'appliquent. Vous n'avez jamais à étiqueter les colonnes vous-mêmes - SQLly lit le type que la base de données renvoie pour le résultat :

Type déclaré (exemples)Formaté en
int, bigint, smallint, tinyint, serial, int4, UInt64, MySQL yearEntier
decimal, numeric, money, float, real, double, Oracle numberDécimal
datetime, datetime2, datetimeoffset, timestamp, timestamptz, date, timeDates
uniqueidentifier, uuidUUID
Tout le reste - varchar, nvarchar, text, json…Texte, tel que stocké - voir Chaîne pour les options par colonne

Les colonnes numériques sont formatées même lorsque le pilote les fournit sous forme de texte - SQL Server decimal et money les valeurs, ainsi que chaque valeur transmise sur les protocoles texte de PostgreSQL et MySQL, arrivent ainsi et sont relues comme des nombres pour l'affichage.

Choix rapides depuis l'en-tête

Définir le remplacement du format… offre une courte liste qui correspond au type de colonne, plus Formateur personnalisé… pour les modèles, chemins JSON et styles de nombres :

Type de colonneChoix
Entier (int, bigint, smallint, tinyint, serial)Séparateurs de milliers, Entier simple, Secondes epoch → date/heure, Millisecondes epoch → date/heure
Décimal / flottant (decimal, numeric, money, float, real, double)2, 4 ou 6 décimales, Sans regroupement
Date / heureDate (2026-07-14), Date et heure, Date, heure et décalage
Booléenvrai / faux, Oui / Non, 1 / 0
BinaireHexadécimal, Base64
Texte, UUID, et tout type non listé ci-dessusTexte original, Majuscules, Minuscules, Masquer (afficher les 4 derniers), Tout masquer

En choisir un écrit une seule ligne de commentaire au-dessus de votre requête. En choisir à nouveau pour la même colonne remplace cette ligne au lieu d'en empiler une deuxième :

-- sqlly format: column=OrderID; number=0; thousands=false
-- sqlly format: column=Freight; number=2; thousands=true
SELECT OrderID, CustomerID, Freight
FROM dbo.Orders
WHERE Freight > 100;

Quelle règle l'emporte

  • Une directive dans la requête l'emporte sur tout le reste pour cette colonne. Les noms de colonnes dans les directives sont comparés sans tenir compte de la casse.
  • Paramètres › Résultats › Remplacements de colonnes mémorise des choix par colonne qui s'appliquent à chaque requête, pratique pour une colonne comme card_number qui devrait toujours être masquée. Identifiez une règle spécifique par column pour correspondre à n'importe quelle colonne de résultat portant ce nom, ou par table.column (ou schema.table.column) pour ne viser que la colonne de cette table. Une clé qualifiée s'applique lorsque SQLly sait de quelle table provient une colonne de résultat, que la source est celle affichée dans l'infobulle de l'en-tête de colonne, ou que la requête ne lit qu'une seule table - et elle l'emporte alors sur une clé à nom simple pour la même colonne.
  • Les types par défaut s'appliquent à toutes les autres colonnes.

Une clé simple doit correspondre exactement au nom de la colonne de résultat. Une clé qualifiée est comparée sans tenir compte de la casse, et sa dernière partie peut être le nom de la colonne de la table ou le nom donné par le résultat, donc orders.total correspond à la fois à SELECT o.total et SELECT o.total AS order_total. Lorsqu'un résultat a deux colonnes portant le même nom provenant de tables différentes (SELECT o.id, c.id), une clé qualifiée qui correspond à un seul d'entre eux n'est pas appliquée ; attribuez un alias à l'une des colonnes pour les distinguer.

Couleurs par type de données et couleurs de syntaxe

Deux commutateurs facultatifs dans Paramètres › Résultats › Général ajouter de la couleur sans écrire de règles :

  • Colorer les cellules selon le type de données teinte le texte, les nombres, les dates et heures, les booléens, les identifiants uniques et les valeurs binaires chacun dans leur propre couleur. Sous le commutateur, chaque type a un Remplir et un Texte sélecteur de couleur ; les couleurs choisies s'appliquent dans les thèmes clair comme sombre, et Réinitialiser au thème revient à la teinte du thème. Vos règles de mise en forme conditionnelle restent prioritaires, et les colonnes masquées ne sont jamais teintées.
  • Colorer la syntaxe des valeurs structurées dans les cellules met en couleur JSON et XML dans la grille - clés, chaînes, nombres, true/false/null, tags, attributs et commentaires - en utilisant les couleurs de syntaxe de votre thème. Cela couvre les colonnes JSON et XML ainsi que les valeurs textuelles qui ressemblent à JSON ou XML. Seule la partie visible de chaque cellule est colorisée, donc les documents très volumineux restent rapides ; une couleur de texte de mise en forme conditionnelle prend le relais là où elle s'applique.

Une valeur contenant des sauts de ligne s'affiche sur une seule ligne dans la grille, avec un ⏎ indiquant où chaque saut se trouve ; copier, exporter et l'éditeur de cellule conservent les vrais sauts de ligne.

Affichage uniquement

Le formatage ne modifie jamais vos données. Il détermine ce que la grille affiche. Copier, le Copier en tant que… les formats et les exports de fichiers utilisent tous les valeurs sous-jacentes, donc une cellule affichant 1,234,567.89 se copie en 1234567.89 (ou avec chaque chiffre envoyé par la base de données). La seule exception est le masquage : avec Appliquer le formatage du masque aux copies et exportations activé (par défaut), les masques issus des surcharges de colonnes, les règles de colonnes sensibles et mask= directives s'appliquent également aux copies et aux exports. Voir le masquage et export.

NULL ne passe jamais par le formateur, il s'affiche toujours en italique NULL dans la grille.

Dans cette section

Entier
Choisissez le regroupement, le signe et les unités qui rendent les nombres entiers faciles à lire.
Décimal
Choisissez le nombre de décimales, le regroupement et le style des nombres négatifs pour que les valeurs fractionnaires se lisent bien.
Dates
Lisez les dates à votre façon : choisissez un format et un fuseau horaire, ou convertissez les nombres epoch en vraies dates.
UUID
Gardez les identifiants longs reconnaissables sans les laisser envahir la grille.
Chaîne
Changez 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.