Canevas

fonctionnel

Disposez librement les volets de résultats lorsque la réponse est plus facile à comprendre côte à côte.

Canevas dispose les ensembles de résultats sur une grille que vous définissez avec des commentaires. C'est fait pour les requêtes façon tableau de bord, où le résumé a sa place à un endroit et les ensembles de détail ailleurs, et comme la mise en page vit dans le SQL, elle voyage avec le fichier.

Déclarer la grille

Une directive définit la taille du tableau, rows × columns. Chaque directive de placement va ensuite au-dessus à une instruction et revendique une cellule comme row|column, les deux basés sur 1 :

-- sqlly 2x2

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

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

Fusion de cellules

Chacun des deux côtés du | peut être une plage, donc un ensemble de résultats peut occuper un bloc. Un résumé large en haut d'un tableau de quatre colonnes, avec des détails en dessous :

-- sqlly 2x4

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

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

Vous n'avez pas besoin de tout placer

Toute instruction sans placement, et tout ensemble de résultats supplémentaire qu'une instruction retourne, est automatiquement placé dans la prochaine cellule libre, en balayant de gauche à droite et de haut en bas. Vous pouvez ainsi positionner les deux ensembles qui comptent et laisser le reste se placer.

Lorsque le tableau ne fonctionne pas

SQLly signale les problèmes de disposition au lieu de faire n'importe quoi en silence. Les problèmes visibles dans le SQL sont soulignés dans l'éditeur, sur la directive ou l'instruction fautive, et un jeu de résultats qui ne révèle être vide qu'à l'exécution est signalé dans une note sous le canevas. Une requête sans -- sqlly RxC ligne sur sa première ligne non vide affiche ses ensembles de résultats empilés à la place.

  • A placement mal formé - pas row|column, pas des entiers positifs, ou une plage qui se termine avant de commencer - est signalé, et cet ensemble de résultats est placé automatiquement à la place.
  • A cellule revendiquée deux fois, ou un placement en dehors de la grille déclarée, est signalé, et cet ensemble de résultats est placé automatiquement à la place.
  • Un tableau de plus de 8×8, ou dont une dimension vaut zéro, est signalé, et la requête affiche ses ensembles de résultats empilés.
  • Un commentaire de placement non suivi d'une instruction produisant un résultat est signalé - c'est la raison habituelle pour laquelle une cellule que vous comptiez remplir reste vide.
  • Plus aucune cellule libre pour un ensemble de résultats indique exactement lequel n'a pas pu être placé, vous savez donc qu'il faut agrandir le tableau.
SQLly
Disposition des résultats en mode canevas de SQLlyDisposition des résultats en mode canevas de SQLly
Une disposition en canevas : des ensembles de résultats organisés en grille de cellules définie par des commentaires SQL.