Canvas

funcional

Organize os painéis de resultados livremente quando a resposta for mais fácil de entender lado a lado.

Canvas distribui os conjuntos de resultados em uma grade que você define com comentários. É para consultas no estilo de painel, onde um resumo pertence a um lugar e conjuntos de detalhes pertencem a outro lugar, e como o layout fica no SQL, ele viaja com o arquivo.

Declarando a grade

Uma diretiva define o tamanho do quadro, rows × columns. Cada diretiva de posicionamento então vai acima uma instrução e ocupa uma célula como row|column, ambos baseados em 1:

-- sqlly 2x2

-- sqlly result: 1|1
SELECT ...;   -- top-left cell

-- sqlly result: 1|2
SELECT ...;   -- next cell across

Células mescladas

De qualquer lado do | pode ser um intervalo, então um conjunto de resultados pode ocupar um bloco. Um resumo largo no topo de um painel de quatro colunas, com detalhes abaixo:

-- sqlly 2x4

-- sqlly result: 1|1-4
SELECT ...;   -- full-width banner row

-- sqlly result: 2|1-2
SELECT ...;   -- bottom-left half

Você não precisa colocar tudo

Qualquer instrução sem posição definida, e qualquer conjunto de resultados extra que uma instrução retorne - é colocado automaticamente na próxima célula livre, da esquerda para a direita e de cima para baixo. Assim você posiciona os dois conjuntos que importam e deixa o resto se encaixar.

Quando o quadro não funciona

O SQLly relata problemas de layout em vez de simplesmente fazer algo arbitrário em silêncio. Problemas visíveis no SQL ficam sublinhados no editor, na diretiva ou instrução com falha, e um conjunto de resultados que só se revela sem células quando a consulta roda é listado em uma nota abaixo do quadro do canvas. Uma consulta sem -- sqlly RxC linha em sua primeira linha não vazia mostra seus conjuntos de resultados empilhados em vez disso.

  • A posicionamento malformado - não row|column, não serem inteiros positivos ou um intervalo que termina antes de começar - é sinalizado, e esse conjunto de resultados é posicionado automaticamente em vez disso.
  • A célula atribuída duas vezes, ou um posicionamento fora da grade declarada, é sinalizado, e esse conjunto de resultados é colocado automaticamente em vez disso.
  • Um quadro maior que 8×8 ou com dimensão zero é sinalizado, e a consulta mostra os conjuntos de resultados empilhados.
  • Um comentário de posicionamento não seguido por uma instrução que produza resultados é sinalizado - é a causa comum de uma célula que você esperava preenchida continuar vazia.
  • Nenhuma célula aberta restante para um conjunto de resultados diz exatamente qual não coube, então você sabe que precisa ampliar o quadro.
SQLly
Layout de resultados do canvas do SQLlyLayout de resultados do canvas do SQLly
Um layout de canvas: conjuntos de resultados dispostos em uma grade de células definida por comentários SQL.