Проверка GROUP BY

функциональный

Запрос с GROUP BY, выбирающий столбец, который не участвует ни в группировке, ни в агрегации, подчёркивается прямо при вводе — с указанием причины и исправлением в один клик.

Когда запрос выполняет агрегацию - COUNT, SUM, MAX и подобные - или имеет GROUP BY, каждый столбец, который он выбирает, должен либо быть сгруппирован, либо находиться внутри агрегата. В противном случае база данных не сможет понять, какие значения группы показывать, и SQL Server выдаст ошибку 8120. SQLly обнаруживает это во время ввода, до того как вы что-либо выполните.

SELECT
    Category,        → ✖ not grouped or aggregated
    COUNT(1)
from
    Shared.Settings

Запустите это на SQL Server, и вы получите Столбец 'Shared.Settings.Category' недопустим в списке выбора, потому что он не входит ни в агрегатную функцию, ни в предложение GROUP BY. В SQLly Category в этом случае подчёркивается, как только запрос принимает такую форму.

Почему это помечается и как исправить

Наведите курсор на подчеркнутый столбец и во всплывающем окне объясняется проблема: запрос группирует свои строки, поэтому каждая строка результата представляет собой целую группу, и значение столбца может отличаться от строки к строке внутри группы. Ниже объяснения есть Исправить ссылка, в которой перечислены добавляемые столбцы. Щёлкните по ней, и SQLly впишет их в GROUP BY, как одно изменение, которое можно отменить:

-- after "Fix this: add Category to GROUP BY"
SELECT
    Category,
    COUNT(1)
from
    Shared.Settings
group by
    Category
  • Пока нет GROUP BY: предложение пишется после FROM и WHERE, перед любым HAVING или ORDER BY. Оформление повторяет сам запрос: отдельные строки и отступы — как у вашего FROM стоит в ту же строку, если запрос в одну строку, и в том регистре ключевых слов, который использует ваш FROM использования.
  • GROUP BY уже есть: недостающие столбцы дописываются к нему — с новых строк, если список уже разбит по строкам.
  • Несколько отсутствующих столбцов: каждый из них подчёркивается, и исправление добавляет их все сразу.
  • Столбцы добавляются ровно в том виде, как вы написали их в списке SELECT, поэтому s.Category остаётся с указанием псевдонима.

То же замечание показывается в списке, когда вы запускаете Проверить SQL (⌘⇧V).

Автодополнение внутри GROUP BY

Автодополнение использует ту же проверку. Когда курсор находится в GROUP BY списке, столбцы, которые ему всё ещё нужны, появляются сначала, отмеченный ● обязательны для SELECT и выделены жирным шрифтом, за которыми следуют остальные столбцы запроса. Таблицы, представления и процедуры там не предлагаются. После того как столбец сгруппирован, он больше не отмечается как обязательный.

Что проверяется и что оставляется без изменений

Проверка намеренно осторожна: она помечает только тот элемент списка SELECT, который является простой ссылкой на столбец, например Category, s.Category, или [dbo].[T].[Category]. Столбец считается сгруппированным, когда любой GROUP BY ключ его и называет, будь то квалифицированное имя, простое или псевдоним из SELECT. На выражениях вроде UPPER(Name), на *, литералы, переменные, подзапросы и оконные функции, такие как COUNT(*) OVER (...). Каждый подзапрос, тело CTE и UNION ветка проверяется независимо.

Насколько строго — зависит от движка. SQL Server, PostgreSQL и Oracle всегда отклоняют столбец, не включённый в группировку, поэтому он помечается как ошибка. В MySQL и MariaDB всё зависит от серверной настройки ONLY_FULL_GROUP_BY настройка, поэтому это только предупреждение. SQLite такое разрешает и выбирает значение из группы — там SQLly молчит.