{"canonical_url":"https://engineer.company/uk/glossary/cte/","content_markdown":"# CTE\n\n## Що це таке\n\nCTE, скорочення від common table expression («загальний табличний вираз»), —\nце запит, якому дають ім'я в конструкції WITH на початку інструкції, щоб решта\nінструкції читала його рядки так, ніби вони надходять із таблиці. Одна\nінструкція може визначити кілька CTE, кожна з них бачить ті, що названі раніше,\nа останній запит унизу складає їх докупи. Посібник PostgreSQL описує їх як\nтимчасові таблиці, що існують лише для одного запиту. Образ точний з одним\nзастереженням: під цим ім'ям нічого не зберігається, і наступна інструкція його\nвже не побачить. CTE може бути SELECT, а в PostgreSQL також INSERT, UPDATE,\nDELETE або MERGE, і інструкція, до якої прикріплено WITH, теж може бути\nбудь-якою з них.\n\nПитання на кшталт «у яких лічильників хоча б за один з останніх 30 днів споживання більш ніж утричі перевищило звичайний для них рівень» природно розпадається на кроки:\n\n```sql\nWITH per_day AS (\n  SELECT meter_id, taken_at::date AS day, sum(kwh) AS kwh\n  FROM meter_readings\n  WHERE taken_at \u003e= current_date - 30\n  GROUP BY meter_id, taken_at::date\n),\nbaseline AS (\n  SELECT meter_id, avg(kwh) AS avg_kwh\n  FROM per_day\n  GROUP BY meter_id\n)\nSELECT p.meter_id, p.day, p.kwh, b.avg_kwh\nFROM per_day AS p\nJOIN baseline AS b USING (meter_id)\nWHERE p.kwh \u003e 3 * b.avg_kwh\nORDER BY p.day, p.meter_id;\n```\n\nПерший крок підсумовує показники кожного лічильника за день, другий бере\nсереднє цих денних сум для кожного лічильника, а останній порівнює кожен день\nіз середнім свого лічильника. Ту саму відповідь можна записати вкладеними\nпідзапитами, але тоді денні суми двічі з'являться в тексті, одна всередині\nіншої, і читачеві доведеться розбирати запит зсередини назовні. З WITH логіка\nчитається згори донизу, а кожен крок можна запустити окремо, поки його\nперевіряють.\n\nСлово RECURSIVE дозволяє CTE читати власний результат, і саме цього звичайний\nSQL інакше виразити не може. Рекурсивна CTE складається з початкового запиту,\nдалі UNION або UNION ALL, а потім запиту, що посилається на саму CTE.\nPostgreSQL виконує початковий запит, кладе його рядки в робочу таблицю і знову\nй знову виконує другий запит над найновішими рядками, доки черговий прохід не\nдодасть жодного. Так інструкція обходить дерево невідомої глибини, наприклад\nусі підрозділи під одним відділом:\n\n```sql\nWITH RECURSIVE unit_tree AS (\n  SELECT id, parent_id, title, 1 AS depth\n  FROM org_units\n  WHERE id = 7\n  UNION ALL\n  SELECT u.id, u.parent_id, u.title, t.depth + 1\n  FROM org_units AS u\n  JOIN unit_tree AS t ON u.parent_id = t.id\n)\nSELECT id, title, depth FROM unit_tree ORDER BY depth, title;\n```\n\n## Чому це важливо\n\nПерша причина — читабельність. Аналітичний запит на сотню рядків із чотирма\nрівнями вкладеності важко переглядати і ще важче змінювати. Та сама логіка у\nвигляді ланцюжка названих кроків дає рецензентові одне речення на крок, дає\nавторові місце для коментаря і дозволяє будь-кому запустити один крок окремо,\nщоб побачити, чи правильні в нього рядки, перш ніж довіряти наступному.\n\nДруга причина — те, як база обчислює кроки, і тут деталі з часом змінилися.\nPostgreSQL зазвичай обчислює запит із WITH один раз за виконання інструкції,\nнавіть коли інструкція звертається до нього кілька разів, тож дороге\nобчислення, потрібне у двох місцях, виконується один раз. Ціна цієї гарантії в\nтому, що планувальник не може протиснути фільтр із зовнішнього запиту всередину\nCTE, яку використовують кілька разів, адже фільтр має стосуватися лише одного\nз використань. CTE обчислюється повністю, а зайві рядки відкидаються потім.\n\nДо PostgreSQL 12 так було з усіма CTE: кожну обчислювали раніше за решту\nзапиту і ніколи не вбудовували в нього. Версія 12 змінила типову поведінку.\nCTE, яка не рекурсивна, не має побічних ефектів і використовується лише один\nраз, тепер вбудовується в зовнішній запит, тож планувальник оптимізує обидва\nрівні разом і може скористатися індексом на фільтрі, якого раніше не бачив.\nMATERIALIZED примусово повертає стару поведінку, а NOT MATERIALIZED примусово\nвбудовує навіть CTE, яку використовують кілька разів, ризикуючи виконати її\nроботу двічі. SQLite приймає ці самі два ключові слова як необов'язкові\nпідказки й прямо пише, що запозичила ідею в PostgreSQL. Інші рушії вирішують\nсамі, і перевіряти це слід у плані.\n\nТретя причина — CTE може змінювати дані. DELETE з RETURNING усередині WITH\nможе передати рядки в INSERT основної інструкції, і тоді рядки переходять з\nоднієї таблиці в іншу за одну інструкцію, яка або виконується повністю, або не\nвиконується зовсім. CTE, що змінюють дані, виконуються рівно один раз і завжди\nдо кінця, незалежно від того, чи читає хтось їхній результат. Це робить їх\nінструментом для кількох записів разом, а не способом описати результат.\n\n## Як це виглядає на практиці\n\nРобота, описана в\n[Прискорила продуктивність PostgreSQL у 10 разів](/uk/portfolio/accelerated-postgresql-performance-by-10x/),\nстосувалася бази з обліковими записами користувачів, орендарями,\nгеографічними даними й щоденними показниками споживання електроенергії, яка\nсповільнювалася з ростом обсягів. Рішення мало три частини: цільові індекси,\nзокрема GiST для геопросторових даних, партиціонування таблиці\nелектроенергетичних даних за днями або місяцями та переписування запитів.\nСкладні запити переписали, щоб уникнути повного сканування таблиць, з\nвикористанням CTE і матеріалізованих представлень для часто потрібних наборів\nданих, а `EXPLAIN ANALYZE` вказав на неефективні з'єднання й підзапити.\nДесятикратне покращення часу відповіді й зниження використання ресурсів на\n40% дали всі три частини разом, а не самі CTE. Поєднання варте уваги, бо ці\nдвоє виконують різну роботу: CTE дає ім'я проміжному результату на час однієї\nінструкції, а матеріалізоване представлення зберігає результат, який читають\nбагато інструкцій, доки його не оновлять.\n\nІнший бік CTE, читабельність, лежав в основі\n[500 звітів з аналізу даних електроенергетики та GIS](/uk/portfolio/released-500-electricity-and-gis-data-reports/).\nКожен звіт написано чистим SQL безпосередньо в PostgreSQL і BigQuery над\nданими розумних лічильників із геолокаційними координатами, ідентифікаторами\nлічильників і споживанням із часовими мітками, а скрипти поєднували CTE з\nвіконними функціями, підзапитами й геопросторовими з'єднаннями. До кожного\nзвіту додавався анотований SQL-код, щоб колеги могли відтворити й перевірити\nаналіз, а також нотатки про типові проблеми якості даних, як-от відсутні\nGPS-координати чи пошкоджені значення лічильників. Звіти стали стандартним\nдовідковим матеріалом у різних підрозділах і сприяли покращенню ефективності\nопераційного планування на 10–15%. Саме названі кроки роблять такий SQL\nпридатним до анотування: над кожним кроком можна поставити примітку про те, що\nвін відкидає або що припускає.\n\n## Де виникають проблеми\n\n**Фільтр, що спрацьовує, коли робота вже зроблена.** CTE, до якої звертаються\nдвічі або яку позначено MATERIALIZED, обчислюється повністю ще до того, як\nзовнішній запит її відфільтрує, а копія, яку вона створює, не має індексів.\nЗапит, якому вистачило б кількох рядків, читає всю таблицю. Читайте план: якщо\nCTE стоїть окремим кроком і кількість рядків у ньому значно більша за ту, яку\nповертає запит, спробуйте NOT MATERIALIZED або перепишіть запит так, щоб\nзвернення до CTE було одне. Залишайте матеріалізовану форму там, де CTE\nвикликає дорогу функцію, щоб та виконувалася раз на рядок, а не раз на кожне\nзвернення.\n\n**Рекурсивний запит, що не зупиняється.** Дані з циклом, наприклад два\nпідрозділи, кожен із яких записаний батьківським для іншого, женуть рекурсивну\nCTE з UNION ALL по колу, доки це дозволяє сервер. UNION допомагає лише тоді,\nколи повторюються цілі рядки, а з колонкою глибини таке трапляється рідко.\nЗберігайте шлях відвіданих ключів у масиві й зупиняйтеся, коли ключ\nз'являється вдруге, або користуйтеся конструкцією CYCLE, яку додав\nPostgreSQL 14. LIMIT у зовнішньому запиті годиться як прийом для тестування, а\nпосібник не радить покладатися на нього в робочому середовищі. SQL Server\nтипово обмежує рекурсію 100 рівнями й скасовує інструкцію далі, тож та сама\nпомилка зупиняється, замість крутитися без кінця.\n\n**Зміни, яких решта інструкції не бачить.** CTE, що змінює дані, і основний\nзапит виконуються одночасно на одному знімку даних, тож основний запит, який\nчитає цільову таблицю напряму, бачить рядки такими, якими вони були до зміни.\nЄдиний канал між ними — RETURNING. Ще гірше, коли дві частини однієї інструкції\nзмінюють той самий рядок: спрацьовує лише одна зміна, і яка саме, передбачити\nважко. Читайте змінені рядки з результату RETURNING у CTE і залишайте кожному\nрядку одного автора змін на інструкцію.\n\n**План, що змінився разом з оновленням.** Код, написаний для PostgreSQL 11 або\nдавніших версій, інколи розраховував на те, що CTE обчислюється першою, як\nсвідомий бар'єр проти плану, якого автор не хотів. Після оновлення до 12 або\nновішої версії та сама CTE вбудовується в зовнішній запит, і планувальник\nобирає щось нове, зазвичай швидше, а часом значно повільніше. Порівняйте вивід\nEXPLAIN для повільних інструкцій до й після оновлення і додайте MATERIALIZED\nтам, де бар'єр був навмисним.\n\n## Що почитати далі\n\n- [7.8. WITH Queries (Common Table Expressions)](https://www.postgresql.org/docs/current/queries-with.html)\n  — розділ посібника про CTE: рекурсія, виявлення циклів, матеріалізація та\n  інструкції, що змінюють дані.\n- [E.23. Release 12](https://www.postgresql.org/docs/12/release-12.html)\n  — випуск, з якого PostgreSQL почав вбудовувати одноразові CTE в зовнішній\n  запит.\n- [E.25. Release 14](https://www.postgresql.org/docs/14/release-14.html)\n  — випуск, що додав стандартні для SQL конструкції SEARCH і CYCLE.\n- [The WITH Clause](https://www.sqlite.org/lang_with.html)\n  — версія SQLite з її підказками щодо матеріалізації та поясненням, звідки\n  вони взялися.\n- [WITH common_table_expression (Transact-SQL)](https://learn.microsoft.com/en-us/sql/t-sql/queries/with-common-table-expression-transact-sql)\n  — правила SQL Server для CTE, зокрема обмеження рекурсії MAXRECURSION.\n\n\u003chttps://engineer.company/uk/glossary/cte/\u003e\n","date_modified":"2026-11-08T02:22:23Z","description":"Що таке CTE в SQL, коли PostgreSQL вбудовує її в зовнішній запит, а коли обчислює один раз, як працює рекурсія і де WITH підводить.","formats":{"gemtext":"https://engineer.company/uk/glossary/cte/index.gmi","gopher":"https://engineer.company/uk/glossary/cte/gophermap","html":"https://engineer.company/uk/glossary/cte/","json":"https://engineer.company/uk/glossary/cte/index.json","markdown":"https://engineer.company/uk/glossary/cte/index.md","pdf":"https://engineer.company/uk/glossary/cte/index.pdf"},"kind":"page","language":"uk","title":"Що таке CTE?","url":"https://engineer.company/uk/glossary/cte/","version":1}