Cuadrícula
funcionalEscribe en la consulta el orden de las columnas, las columnas ocultas y congeladas, la ordenación, la agrupación y los filtros.
La directiva de cuadrícula escribe en la consulta la disposición de columnas de la cuadrícula de resultados: qué columnas van primero, cuáles están ocultas o inmovilizadas, cómo se ordenan, agrupan y filtran las filas, y qué claves foráneas muestran una etiqueta legible. Vuelve con cada ejecución, para quien abra el archivo.
Sintaxis
-- sqlly grid: <setting>; <setting>…
-- sqlly grid <n>: <setting>; <setting>…
Los ajustes están separados por ;, en cualquier orden. Sin un número, la línea se aplica a todos los conjuntos de resultados de la ejecución, como lines:. Con uno, grid 2: se aplica solo al segundo conjunto de resultados, contando desde 1.
| Ajuste | Significado | Ejemplo |
|---|---|---|
order=a, b, c | Orden de visualización. Las columnas de la lista aparecen primero, en este orden; el resto de columnas visibles siguen en su orden natural. | order=Id, Name, Total |
hide=a, b | Ocultar estas columnas. | hide=Notes, RowVersion |
freeze=N | Fija las primeras N columnas visibles mientras te desplazas en horizontal. | freeze=1 |
sort=col [asc|desc], … | Ordenar por una o más columnas. asc es el predeterminado. | sort=Total desc, Name |
group=col | Agrupar filas por esta columna. | group=Region |
filter=col op value | Un filtro por columna. Repite la configuración para filtrar más columnas. | filter=Status is Open |
label=col:display | Etiqueta de clave foránea: mostrar display de la tabla referenciada junto a col. label=col:off oculta la etiqueta. | label=CustomerId:Name |
Operadores de filtro
A filter= usa las mismas condiciones que el panel de filtro por columna de la cuadrícula:
| Valores | Operadores | Ejemplo |
|---|---|---|
| Texto | contains, not contains, begins with, ends with, is, is not, matches (una expresión regular) | filter=Email ends with @example.com |
| Números y fechas | =, !=, >, >=, <, <=, between A and B, not between A and B | filter=Total between 100 and 500 |
| Una lista de valores (las casillas de verificación del panel de filtro) | in A | B | C | filter=Region in West | North |
Nombres de columnas
Escribe el nombre de columna entre comillas dobles cuando contenga un espacio, una coma, un punto y coma o una comilla, y duplica la comilla que haya dentro: "Order Date", "Rep ""Ace"" Name".
Ejemplos
-- 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;
Dos conjuntos de resultados, cada uno con su propia organización:
-- 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;
Qué disposición gana
SQLly ya recuerda cómo dejaste las columnas de un resultado, por tabla o por consulta. Una
grid: la directiva tiene prioridad sobre ese diseño guardado, así que la consulta muestra la misma disposición para todos los que la ejecuten. Cambiar la cuadrícula a mano sigue funcionando por ahora; la directiva se vuelve a aplicar en la siguiente ejecución.
grid: línea, con los anchos y los formatos también. Ver Bloquear la cuadrícula.