Verrouiller la grille
fonctionnelUn clic insère dans la requête le résultat exactement tel qu'il s'affiche, pour qu'il revienne identique à chaque exécution.
Organisez un résultat à votre façon, déplacez les colonnes, masquez-en quelques-unes, définissez les largeurs, triez, filtrez, colorez, faites un tableau croisé dynamique ou un graphique, puis cliquez sur verrouiller. SQLly écrit le résultat, exactement tel qu'il est actuellement, dans la requête sous forme de directives SQLly. À la prochaine exécution, ou quand un collègue ouvre le même fichier, on obtient la même grille.
Où se trouve le verrou
Une petite icône de verrou est placée devant le nom de chaque jeu de résultats :
- Disposition par onglets - sur l'étiquette de l'onglet du résultat.
- Disposition empilée - sur l'en-tête de la carte.
- Disposition du canevas - sur l'en-tête de la cellule.
L'icône est mise en évidence lorsque la requête contient déjà un bloc de verrouillage.


Ce qu'il écrit
Un commentaire de bloc en haut des instructions exécutées, contenant une -- sqlly ligne pour chaque partie du résultat :
/* sqlly lock — SQLly wrote this from the result grid; click the lock on the result to refresh it.
-- sqlly view: pivot
-- sqlly layout: tabbed
-- sqlly grid: order=Region, Rep, Total, Created; hide=Notes; freeze=1; sort=Total desc, Rep; filter=Region is West
-- sqlly format: column=Total; number=2; width=40dp
-- sqlly format: column=Rep; width=60dp
-- sqlly conditional: column=Total; when=> 10000; fill=#E3F4E8; text=#1E7B34; bold
-- sqlly conditional: column=Total; bar=#5B9BD5
-- sqlly pivot: row:Region; column:Year; value:Total:sum
-- sqlly chart: kind:bar; label:Region; values:Total
*/
SELECT Region, Rep, Total, Created, Notes FROM sales;
Le bloc capture :
| Ce que vous voyez | Écrit comme |
|---|---|
| Ordre des colonnes, colonnes masquées et figées, tri, regroupement, filtres de colonnes et étiquettes de clés étrangères | grid: |
| Formats par colonne, arrondi et largeurs de colonne | format: |
| Règles de mise en forme conditionnelle pour les colonnes du résultat | conditional: |
| Colonnes calculées et leurs formules | column: |
| Le tableau croisé dynamique et la configuration du graphique | pivot: et chart: |
| Quelle vue est ouverte : grille, tableau croisé ou graphique | view: |
| La disposition des résultats : empilée, en onglets ou sur le canevas | layout: |
| Quel résultat a le focus, les noms des résultats et la répartition des lignes en vue Empilées | focus:, name, et lines: |
Les largeurs sont écrites en dp, une unité qui suit la taille de la police de la grille, donc une colonne continue de montrer à peu près le même nombre de caractères sur l'écran d'un coéquipier avec une police plus grande ou plus petite.
Cliquer à nouveau
- Le bloc correspond toujours à l'écran. Cliquez à nouveau sur le cadenas après avoir modifié la grille et SQLly réécrit le bloc pour correspondre à ce qui est maintenant affiché à l'écran.
- Rien à l'extérieur ne peut le contredire. Les directives du même type que celles que le verrou écrit, présentes ailleurs dans le code exécuté, une
grid:ouformat:ligne que vous avez écrite à la main, par exemple, sont intégrées dans le bloc. - Une seule annulation. Chaque clic est une seule modification, donc ⌘Z (CtrlZ sur Windows et Linux) remet la requête en place.
Ce qu'il laisse de côté volontairement
- Révélation de masque. Révéler momentanément une colonne masquée n'est pas consigné, si bien qu'un verrou ne démasque jamais les données pour le lecteur suivant.
- Paramètres et variables.
param:etsetlignes restent où vous les avez écrites. - Placement sur le canevas.
result:cellules et la taille du canevas (2x2) restent telles que vous les avez écrites. - Filtrer les lignes… conditions que les filtres de colonnes ne peuvent exprimer. Utilisez Ajouter les filtres actifs à WHERE pour garder celles-ci dans le SQL à la place.
- Paramètres › Remplacements de colonnes de résultats. Ceux-ci s'appliquent déjà partout, donc ils ne sont pas copiés dans la requête.
Édition manuelle du bloc
Le bloc est un texte ordinaire. À l'intérieur d'un commentaire qui commence par /* sqlly lock, chaque
-- sqlly ligne fonctionne exactement comme si elle était écrite sur sa propre ligne, et la première ligne de directive du bloc compte comme la première ligne de la requête pour view:. La ligne d'ouverture doit commencer par /* sqlly lock, et le bloc se termine à une ligne qui est juste
*/. Tout autre commentaire de bloc désactive toujours les directives à l'intérieur, ce qui est un moyen pratique de désactiver quelques lignes pendant un certain temps.