Grille
fonctionnelÉcrivez l'ordre des colonnes, les colonnes masquées et figées, le tri, le regroupement et les filtres dans la requête.
La directive de grille écrit l’agencement des colonnes du résultat dans la requête : quelles colonnes viennent en premier, lesquelles sont masquées ou figées, comment les lignes sont triées, regroupées et filtrées, et quelles clés étrangères affichent une étiquette lisible. L’agencement revient à chaque exécution, pour quiconque ouvre le fichier.
Syntaxe
-- sqlly grid: <setting>; <setting>…
-- sqlly grid <n>: <setting>; <setting>…
Les paramètres sont séparés par ;, dans n'importe quel ordre. Sans numéro, la ligne s'applique à chaque ensemble de résultats de l'exécution, comme lines:. Avec un, grid 2: s'applique uniquement au deuxième ensemble de résultats, en comptant à partir de 1.
| Paramètre | Sens | Exemple |
|---|---|---|
order=a, b, c | Ordre d'affichage. Les colonnes listées viennent en premier, dans cet ordre ; les autres colonnes visibles suivent dans leur ordre naturel. | order=Id, Name, Total |
hide=a, b | Masquer ces colonnes. | hide=Notes, RowVersion |
freeze=N | Épingler les N premières colonnes affichées pendant que vous faites défiler latéralement. | freeze=1 |
sort=col [asc|desc], … | Trier par une ou plusieurs colonnes. asc est la valeur par défaut. | sort=Total desc, Name |
group=col | Grouper les lignes par cette colonne. | group=Region |
filter=col op value | Un filtre par colonne. Répétez le paramètre pour filtrer d’autres colonnes. | filter=Status is Open |
label=col:display | Étiquette de clé étrangère : afficher display à partir de la table référencée à côté de col. label=col:off désactive l'étiquette. | label=CustomerId:Name |
Opérateurs de filtre
A filter= utilise les mêmes conditions que le panneau de filtres par colonne de la grille :
| Valeurs | Opérateurs | Exemple |
|---|---|---|
| Texte | contains, not contains, begins with, ends with, is, is not, matches (une expression régulière) | filter=Email ends with @example.com |
| Nombres et dates | =, !=, >, >=, <, <=, between A and B, not between A and B | filter=Total between 100 and 500 |
| Une liste de valeurs (les cases à cocher du panneau de filtre) | in A | B | C | filter=Region in West | North |
Noms de colonnes
Écrivez un nom de colonne entre guillemets doubles lorsqu'il contient un espace, une virgule, un point-virgule ou un guillemet, et doublez un guillemet à l'intérieur : "Order Date", "Rep ""Ace"" Name".
Exemples
-- sqlly grid: order=Region, Rep, Total; hide=Notes; freeze=1; sort=Total desc, Rep
-- sqlly grid: filter=Region is West; filter=Total > 1000
SELECT Region, Rep, Total, Created, Notes FROM sales;
Deux ensembles de résultats, chacun avec son propre agencement :
-- sqlly grid 1: sort="Order Date" desc; label=CustomerId:CompanyName
-- sqlly grid 2: group=Category; hide=Discontinued
SELECT OrderId, CustomerId, OrderDate AS [Order Date] FROM dbo.Orders;
SELECT ProductName, Category, Discontinued FROM dbo.ProductList;
Quel agencement l'emporte
SQLly se souvient déjà de la manière dont vous avez laissé les colonnes d'un résultat, par table ou par requête. Une
grid: directive prend le dessus sur cette disposition mémorisée, donc la requête affiche la même disposition pour tous ceux qui l'exécutent. Modifier la grille à la main fonctionne toujours pour l'instant ; la directive se réapplique à la prochaine exécution.
grid: ligne, y compris les largeurs et les formats. Voir Verrouiller la grille.