Directivas de SQLly
funcionalPequeños comentarios SQL que recuerdan el aspecto de un resultado: sus columnas, anchos, formatos, colores, tabla dinámica y gráfico.
A directiva es un comentario SQL ordinario que SQLly entiende. Para la base de datos es solo un comentario; SQLly lo usa para dar forma o dar formato al resultado. Como las directivas viven en el texto de la consulta, viajan con el archivo y vuelven a aplicarse cada vez que lo ejecutas.
Cada directiva comparte el mismo espacio de nombres: la palabra sqlly después del marcador de comentario:
-- 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
Rara vez tienes que escribirlas. Organiza el resultado a tu gusto y luego haz clic en el bloqueo delante del nombre del resultado: SQLly escribe toda la disposición en la consulta como un único bloque de directivas. Ver Bloquear la cuadrícula.
Las familias de directivas
| Directiva | Lo que hace | Ejemplo |
|---|---|---|
view: | Abre el resultado como grid (el predeterminado), pivot, o chart; map mantiene la cuadrícula y además abre el resultado en un mapa. | -- sqlly view: chart |
grid: | La disposición de columnas de la cuadrícula: orden, columnas ocultas e inmovilizadas, ordenación, agrupación, filtros de columna y etiquetas de clave foránea. grid 2: establece un conjunto de resultados, contando desde 1. | -- sqlly grid: hide=Notes; freeze=1; sort=Total desc |
format: | Cómo se muestra una columna de resultados y qué tan ancha es. | -- sqlly format: column=Created; date=%Y-%m-%d; width=40dp |
conditional: | Colorea las celdas según sus valores para esta consulta: una regla de resaltado, una escala de colores o una barra de datos. Una regla por línea. | -- sqlly conditional: column=Status; when=is Failed; text=#B00020; bold |
column: | Añade una columna calculada con una fórmula de Excel a partir de las propias columnas del resultado: !Name es esta fila, !Name[1] la fila anterior. Funciones y operadores de Excel. | -- sqlly column: Total = !Qty * !Price |
pivot: | Filas, columnas y el valor agregado de una tabla dinámica. result:N selecciona el conjunto de resultados al que pertenece. | -- sqlly pivot: row:Rep; column:Quarter; value:Deals:count |
chart: | Tipo de gráfico, etiqueta de categoría, serie y agregación. result:N selecciona el conjunto de resultados al que pertenece. | -- sqlly chart: kind:line; label:Month; values:Revenue,Cost |
map: | Cómo se dibuja un resultado en el mapa: columnas de ubicación, etiquetas y descripciones emergentes, color y tamaño, puntos o mapa de calor (peso, radio, desenfoque, intensidad, opacidad, paleta), el agrupamiento, el mapa de calles, la vista inicial, el comportamiento al hacer clic y si el mapa se abre por su cuenta. map 2: establece un conjunto de resultados, contando desde 1. | -- sqlly map: mode=heatmap; weight=orders; radius=30 |
/* sqlly lock | Un comentario de bloque que SQLly escribe al hacer clic en el candado de un resultado. Su -- sqlly las líneas reproducen el resultado exactamente como se veía. | /* sqlly lock — … … */ |
name | Etiqueta la pestaña de un conjunto de resultados, contando desde 1. Útil cuando un lote devuelve varios. | -- sqlly name 2: Open Orders |
2x2 / result: | Coloca varios conjuntos de resultados en un solo lienzo, ubicando el resultado de cada instrucción en una celda. | -- sqlly result: 1|2 |
layout: | Abre los resultados de la ejecución como stacked, tabbed, o canvas, dondequiera que se abra el archivo. | -- sqlly layout: stacked |
lines: | Filas asignadas a cada tarjeta apilada; lines 2: establece un conjunto de resultados, contando desde 1. | -- sqlly lines 2: 20 |
focus: | Qué conjunto de resultados se muestra cuando llegan los resultados: en Pestañas se selecciona su pestaña y en Apiladas se desplaza la vista hasta su tarjeta. Se cuenta desde 1. | -- sqlly focus: 2 |
param: | Declara un parámetro, o da un :name marcador de posición un tipo y un valor por defecto. Una franja sobre los resultados te permite escribir su valor antes de cada ejecución; los :id, ? y $1 marcadores de posición simples obtienen uno sin declaración (ver Parámetros de consulta). | -- sqlly param: @CustomerId int |
set | Define una variable de texto que reemplaza todo ${name} antes de que se ejecute la consulta. | -- sqlly set schema = dbo |
param: y set son los dos que cambian lo que la base de datos recibe. SQLly sustituye sus valores en el SQL antes de enviarlo, fuera de cadenas y comentarios. El valor de un parámetro se ingresa como un literal escapado de su tipo declarado (text, int, decimal, bool, date, o datetime). Un set valor se introduce tal cual. Las fórmulas de columna calculada se leen ambas como @name.
Dónde debe ir una directiva
- En su propia línea. Una directiva después del código SQL en la misma línea se ignora.
namees la única excepción y funciona como comentario al final de la línea. view:y el tamaño del lienzo van en la primera línea. Solo se leen en la primera línea no vacía de la consulta. En un bloque de bloqueo en la parte superior, la primera línea de directiva del bloque cuenta como esa primera línea.- El espaciado es flexible para la mayoría de las familias:
--sqlly view: pivoty-- SQLLY view: pivotambos funcionan. format:es estricto. Debe escribirse exactamente-- sqlly format:, con un espacio después--.- Dentro de un comentario de bloque, una directiva se desactiva - lo cual es una forma práctica de desactivar uno por un tiempo. La única excepción es la
/* sqlly lockbloque: sus líneas funcionan exactamente como si cada una se escribiera en su propia línea.
-- 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 el espacio de nombres pero está mal escrito, colocado donde no puede aplicarse o se le da un valor desconocido, SQLly lo subraya en el editor y explica por qué en lugar de ignorarlo silenciosamente. Por ejemplo, -- sqlly view: table obtiene Vista desconocida — se esperaba -- sqlly view: grid, -- sqlly view: pivot, -- sqlly view: chart, o -- 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 | La 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 o 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+Espacio, on macOS too.
Ayuda en la aplicación
- Pasar el cursor cualquiera
-- sqllycomentario para una descripción corta, con un enlace a la lista completa de opciones. - Ayuda › Directivas de formato… (también en la paleta de comandos) abre una ventana de referencia con todas las familias, sus parámetros y ejemplos listos para copiar.
- Deja que SQLly lo escriba. Haz clic en el candado delante del nombre de un resultado para escribir el resultado completo como directivas, o haz clic derecho en el encabezado de una columna de resultados y elige Formato › Definir anulación de formato… para que se escriba una directiva
format:escrita para ti.
En esta sección
- Cuadrícula
- Escribe en la consulta el orden de las columnas, las columnas ocultas y congeladas, la ordenación, la agrupación y los filtros.
- Formato en curso
- Asigna a cada columna la presentación y el ancho que merece, automáticamente cada vez que se ejecute la consulta.
- Condicional
- Colorea las celdas según sus valores para una consulta: reglas de resaltado, escalas de colores y barras de datos.
- Columnas calculadas
- Añade columnas escritas como fórmulas de Excel: totales acumulados, márgenes, cambios respecto a la fila anterior y fechas.
- Tabla dinámica
- Convierte un conjunto de resultados de siempre en una tabla cruzada con un comentario breve y portable.
- Gráfico
- Dile a la pestaña Gráfico qué historia dibujar antes incluso de que llegue el resultado.
- Bloquear la cuadrícula
- Un clic escribe el resultado exactamente como se ve ahora en la consulta, para que sea igual en cada ejecución.