Directivas de SQLly

funcional

Pequeñ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

DirectivaLo que haceEjemplo
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 lockUn 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 — … … */
nameEtiqueta 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
setDefine 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. name es 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: pivot y -- SQLLY view: pivot ambos 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 lock bloque: 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;
Una red de seguridad mientras escribes. Si un comentario utiliza el 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 typedThe list offers
-- on a line of its ownA 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.
-- sqLa 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 a param: 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 -- sqlly comentario 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.