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ètreSensExemple
order=a, b, cOrdre 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, bMasquer 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=colGrouper les lignes par cette colonne.group=Region
filter=col op valueUn 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 :

ValeursOpérateursExemple
Textecontains, 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 Bfilter=Total between 100 and 500
Une liste de valeurs (les cases à cocher du panneau de filtre)in A | B | Cfilter=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.

Laissez le verrou l'écrire. Organisez la grille avec la souris (glisser, masquer, figer, trier, filtrer), puis cliquez sur le verrou devant le nom du résultat. SQLly écrit la ligne correspondante grid: ligne, y compris les largeurs et les formats. Voir Verrouiller la grille.