Grade

funcional

Escreva 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çãoSignificadoExemplo
order=a, b, cOrdem 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, bOcultar essas colunas.hide=Notes, RowVersion
freeze=NFixar 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=colAgrupar linhas por esta coluna.group=Region
filter=col op valueUm filtro por coluna. Repita a configuração para filtrar mais colunas.filter=Status is Open
label=col:displayRó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:

ValoresOperadoresExemplo
Textocontains, 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 Bfilter=Total between 100 and 500
Uma lista de valores (as caixas de seleção do painel de filtro)in A | B | Cfilter=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.

Deixe o cadeado escrever. Organize a grade com o mouse (arrastar, ocultar, congelar, ordenar, filtrar), depois clique no cadeado em frente ao nome do resultado. O SQLly escreve a linha correspondente grid: linha, com as larguras e os formatos também. Veja Bloquear grade.