Cuadrícula

funcional

Escribe 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.

AjusteSignificadoEjemplo
order=a, b, cOrden 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, bOcultar estas columnas.hide=Notes, RowVersion
freeze=NFija 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=colAgrupar filas por esta columna.group=Region
filter=col op valueUn filtro por columna. Repite la configuración para filtrar más columnas.filter=Status is Open
label=col:displayEtiqueta 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:

ValoresOperadoresEjemplo
Textocontains, 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 Bfilter=Total between 100 and 500
Una lista de valores (las casillas de verificación del panel de filtro)in A | B | Cfilter=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.

Deja que el bloqueo lo escriba. Organiza la cuadrícula con el ratón (arrastrar, ocultar, congelar, ordenar, filtrar) y luego haz clic en el candado junto al nombre del resultado. SQLly escribe la línea correspondiente grid: línea, con los anchos y los formatos también. Ver Bloquear la cuadrícula.