Directives SQLly
fonctionnelDe petits commentaires SQL qui mémorisent la présentation d’un résultat : colonnes, largeurs, formats, couleurs, pivot et graphique.
A directive est un commentaire SQL ordinaire que SQLly comprend. Pour la base de données, ce n'est qu'un commentaire ; SQLly, lui, s'en sert pour organiser ou formater le résultat. Comme les directives vivent dans le texte de la requête, elles voyagent avec le fichier et s'appliquent de nouveau à chaque exécution.
Chaque directive partage le même espace de noms - le mot sqlly après le marqueur de commentaire :
-- sqlly view: pivot
-- sqlly grid: order=Region, Year, Sales; freeze=1; sort=Sales desc
-- sqlly pivot: row:Region; column:Year; value:Sales:sum
-- sqlly chart: kind:bar; label:Region; values:Sales
-- sqlly format: column=Sales; number=2; width=40dp
-- sqlly conditional: column=Sales; bar=#5B9BD5
-- sqlly column: Running Total = !Sales + N(!"Running Total"[1])
-- sqlly map: lat=Latitude; lon=Longitude; color=Region; cluster=on
Vous avez rarement besoin de les taper. Disposez le résultat comme vous le souhaitez, puis cliquez sur le verrouiller devant le nom du résultat : SQLly écrit toute la disposition dans la requête comme un bloc de directives. Voir Verrouiller la grille.
Les familles de directives
| Directive | Ce que cela fait | Exemple |
|---|---|---|
view: | Ouvre le résultat comme grid (par défaut), pivot, ou chart; map garde la grille et ouvre également le résultat sur une carte. | -- sqlly view: chart |
grid: | L'agencement des colonnes de la grille : ordre, colonnes masquées et figées, tri, regroupement, filtres de colonnes et étiquettes de clé étrangère. grid 2: définit un ensemble de résultats, en commençant à partir de 1. | -- sqlly grid: hide=Notes; freeze=1; sort=Total desc |
format: | Comment une colonne de résultat est affichée et quelle est sa largeur. | -- sqlly format: column=Created; date=%Y-%m-%d; width=40dp |
conditional: | Colore les cellules selon leurs valeurs pour cette requête : une règle de mise en surbrillance, une échelle de couleurs ou une barre de données. Une règle par ligne. | -- sqlly conditional: column=Status; when=is Failed; text=#B00020; bold |
column: | Ajoute une colonne calculée avec une formule Excel à partir des colonnes du résultat lui-même : !Name est cette ligne, !Name[1] la ligne précédente. Fonctions et opérateurs d'Excel. | -- sqlly column: Total = !Qty * !Price |
pivot: | Lignes, colonnes et valeur agrégée d'un tableau croisé dynamique. result:N choisit l'ensemble de résultats auquel il appartient. | -- sqlly pivot: row:Rep; column:Quarter; value:Deals:count |
chart: | Type de graphique, étiquette de catégorie, série et agrégation. result:N choisit l'ensemble de résultats auquel il appartient. | -- sqlly chart: kind:line; label:Month; values:Revenue,Cost |
map: | Comment un résultat est tracé sur la carte : colonnes de localisation, étiquettes et info-bulles, couleur et taille, points ou carte thermique (poids, rayon, flou, intensité, opacité, palette), regroupement, carte routière, vue de départ, comportement au clic et si la carte s'ouvre automatiquement. map 2: définit un ensemble de résultats, en commençant à partir de 1. | -- sqlly map: mode=heatmap; weight=orders; radius=30 |
/* sqlly lock | Un commentaire de bloc que SQLly écrit quand vous cliquez sur le verrou d'un résultat. Ses -- sqlly lignes reproduisent exactement le résultat tel qu'il apparaissait. | /* sqlly lock — … … */ |
name | Étiquette l'onglet d'un ensemble de résultats, en commençant à 1. Pratique lorsqu'un lot renvoie plusieurs résultats. | -- sqlly name 2: Open Orders |
2x2 / result: | Dispose plusieurs ensembles de résultats sur un seul canevas, plaçant le résultat de chaque instruction dans une cellule. | -- sqlly result: 1|2 |
layout: | Ouvre les résultats de l'exécution comme stacked, tabbed, ou canvas, où que le fichier soit ouvert. | -- sqlly layout: stacked |
lines: | Lignes attribuées à chaque carte empilée ; lines 2: définit un ensemble de résultats, en commençant à partir de 1. | -- sqlly lines 2: 20 |
focus: | Quel ensemble de résultats est affiché à l'arrivée des résultats : son onglet est sélectionné en vue Onglets et sa carte est amenée à l'écran en vue Empilées. Compte à partir de 1. | -- sqlly focus: 2 |
param: | Déclare un paramètre ou donne un :name type et valeur par défaut à un espace réservé. Une bande au-dessus des résultats vous permet de saisir sa valeur avant chaque exécution ; les espaces réservés simples :id, ? et $1 en obtiennent un sans déclaration (voir Paramètres de la requête). | -- sqlly param: @CustomerId int |
set | Définit une variable texte qui remplace chaque ${name} avant l'exécution de la requête. | -- sqlly set schema = dbo |
param: et set sont les deux qui changent ce que la base de données reçoit. SQLly substitue leurs valeurs dans le SQL avant de l'envoyer, en dehors des chaînes et des commentaires. La valeur d'un paramètre est insérée comme un littéral échappé de son type déclaré (text, int, decimal, bool, date, ou datetime). Une valeur set valeur est insérée telle quelle. La formule de colonne calculée les formules se lisent aussi bien comme @name.
Là où une directive doit aller
- Sur sa propre ligne. Une directive après du code SQL sur la même ligne est ignorée.
nameest la seule exception et fonctionne comme un commentaire final. view:et la taille du canevas vont sur la première ligne. Ils ne sont lus que sur la première ligne non vide de la requête. Dans un bloc de verrouillage placé en tête, la première ligne de directive du bloc compte comme cette première ligne.- L'espacement est tolérant pour la plupart des familles :
--sqlly view: pivotet-- SQLLY view: pivotles deux fonctionnent. format:est strict. Elle doit être orthographiée exactement-- sqlly format:, avec un espace après--.- À l'intérieur d'un commentaire de bloc, une directive est désactivée - ce qui est une façon pratique de désactiver temporairement une directive. La seule exception est le
/* sqlly lockbloc: ses lignes fonctionnent exactement comme si chacune était écrite sur sa propre ligne.
-- sqlly view: pivot -- sqlly pivot: row:Region; column:Year; value:Sales:sum -- sqlly format: column=Sales; number=2 SELECT Region, Year, Sales FROM sales;
sqlly l'espace de noms mais qu'il est mal orthographié, placé là où il ne peut pas s'appliquer, ou qu'on lui donne une valeur inconnue, SQLly le souligne dans l'éditeur et explique pourquoi au lieu de l'ignorer silencieusement. Par exemple, -- sqlly view: table obtient Vue inconnue — attendu -- sqlly view: grid, -- sqlly view: pivot, -- sqlly view: chart, ou -- sqlly view: map.Autocomplete as you type
You don't have to remember any of the spellings above. As soon as a comment looks like a directive, the editor's suggestion list follows the cursor through it and offers the next thing the directive can take:
| You have typed | The list offers |
|---|---|
-- on a line of its own | A ready-made starter line for each kind of directive. view: and the canvas size are offered only on the query's first line, where they work. |
-- sq | Le sqlly namespace. |
-- sqlly | Every directive family: view:, grid:, format:, pivot:, chart: and the rest. |
-- sqlly grid: | The settings that family takes, leaving out the ones already on the line. |
-- sqlly grid: sort= | The values that setting accepts: here the result's columns. Elsewhere chart kinds, pivot aggregates, filter operators, map modes, number and date formats, time zones, colors. |
-- sqlly grid: sort=Total | What may follow the value: here asc ou desc. |
- One choice opens the next. Accepting a setting opens its values straight away, so a whole directive can be built by picking from lists with Tab or Enter.
- Your real column names. Wherever a directive expects a column, the list shows the columns the tab's last run returned, quoted the way that directive needs them. Run the query once to get them.
- Formulas and parameters too. In a
column:formula the list completes column references, Excel worksheet functions and@variables. On aparam:line it offers the query's placeholders that are not declared yet, then every parameter type. - Only what works. Everything in the list is exactly what the directive accepts, so an accepted suggestion never earns the warning underline described above.
- Bring it back anywhere inside a directive with Ctrl+Espace, on macOS too.
Aide dans l'application
- Survoler n'importe quel
-- sqllycommentaire pour une brève description, avec un lien vers la liste complète des options. - Aide › Directives de formatage… (aussi dans la palette de commandes) ouvre une fenêtre de référence avec chaque famille, ses paramètres et des exemples prêts à copier.
- Laissez SQLly l'écrire. Cliquez sur le cadenas devant le nom d'un résultat pour écrire le résultat entier sous forme de directives, ou faites un clic droit sur l'en-tête d'une colonne de résultat et choisissez Format › Définir une exception de mise en forme… pour faire écrire une
format:directive écrite pour vous.
Dans cette section
- Grille
- Écrivez l'ordre des colonnes, les colonnes masquées et figées, le tri, le regroupement et les filtres dans la requête.
- Mise en forme en cours
- Attribuez à chaque colonne la présentation et la largeur qu'elle mérite, automatiquement à chaque exécution de la requête.
- Conditionnel
- Coloriez les cellules selon leurs valeurs pour une requête : règles de mise en surbrillance, échelles de couleurs et barres de données.
- Colonnes calculées
- Ajoutez des colonnes écrites sous forme de formules Excel : totaux cumulés, marges, variations par rapport à la ligne précédente et dates.
- Pivot
- Transformez un ensemble de résultats familier en un tableau croisé avec un commentaire court et portable.
- Graphique
- Indiquez à l'onglet Graphique quelle histoire dessiner avant même que le résultat n'arrive.
- Verrouiller la grille
- Un clic insère dans la requête le résultat exactement tel qu'il s'affiche, pour qu'il revienne identique à chaque exécution.