Grade
funcionalEscreva a ordem das colunas, colunas ocultas e congeladas, ordenação, agrupamento e filtros na consulta.
A diretiva de grade escreve o arranjo das colunas da grade de resultados na consulta: quais colunas vêm primeiro, quais estão ocultas ou congeladas, como as linhas são ordenadas, agrupadas e filtradas, e quais chaves estrangeiras mostram um rótulo legível. Ela volta em cada execução, para qualquer pessoa que abrir o arquivo.
Sintaxe
-- sqlly grid: <setting>; <setting>…
-- sqlly grid <n>: <setting>; <setting>…
As configurações são separadas por ;, em qualquer ordem. Sem um número, a linha se aplica a todos os conjuntos de resultados da execução, como lines:. Com um, grid 2: se aplica apenas ao segundo conjunto de resultados, contando a partir de 1.
| Configuração | Significado | Exemplo |
|---|---|---|
order=a, b, c | Ordem de exibição. As colunas listadas vêm primeiro, nesta ordem; as outras colunas visíveis seguem em sua ordem natural. | order=Id, Name, Total |
hide=a, b | Ocultar essas colunas. | hide=Notes, RowVersion |
freeze=N | Fixar as primeiras N colunas exibidas enquanto você rola horizontalmente. | freeze=1 |
sort=col [asc|desc], … | Classificar por uma ou mais colunas. asc é o padrão. | sort=Total desc, Name |
group=col | Agrupar linhas por esta coluna. | group=Region |
filter=col op value | Um filtro por coluna. Repita a configuração para filtrar mais colunas. | filter=Status is Open |
label=col:display | Rótulo de chave estrangeira: mostrar display da tabela referenciada ao lado col. label=col:off desliga o rótulo. | label=CustomerId:Name |
Operadores de filtro
A filter= usa as mesmas condições do painel de filtro por coluna da grade:
| Valores | Operadores | Exemplo |
|---|---|---|
| Texto | contains, not contains, begins with, ends with, is, is not, matches (uma expressão regular) | filter=Email ends with @example.com |
| Números e datas | =, !=, >, >=, <, <=, between A and B, not between A and B | filter=Total between 100 and 500 |
| Uma lista de valores (as caixas de seleção do painel de filtro) | in A | B | C | filter=Region in West | North |
Nomes das colunas
Escreva um nome de coluna entre aspas duplas quando ele contiver um espaço, uma vírgula, um ponto e vírgula ou uma aspa, e dobre uma aspa dentro dele: "Order Date", "Rep ""Ace"" Name".
Exemplos
-- 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;
Dois conjuntos de resultados, cada um com seu próprio arranjo:
-- 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;
Qual arranjo vence
O SQLly já lembra como você deixou as colunas de um resultado, por tabela ou por consulta. Uma
grid: diretiva prevalece sobre esse layout lembrado, então a consulta mostra o mesmo arranjo para todos que a executarem. Alterar a grade manualmente ainda funciona por enquanto; a diretiva se aplica novamente na próxima execução.
grid: linha, com as larguras e os formatos também. Veja Bloquear grade.