{"canonical_url":"https://engineer.company/uk/glossary/schema/","content_markdown":"# Схема бази даних\n\n## Що це таке\n\nСхема бази даних — це простір імен усередині бази даних: контейнер для таблиць,\nпредставлень, типів даних, функцій і операторів, завдяки якому те саме ім'я\nможна використати у двох схемах без конфлікту. Посібник PostgreSQL порівнює\nсхеми з каталогами файлової системи, з тією різницею, що вкладати їх одна в одну\nне можна: база даних містить схеми, а схеми містять об'єкти. Слово має й друге,\nширше значення, не менш поширене: схема бази даних — це вся її структура, кожна\nтаблиця, колонка, ключ і обмеження, і зміна в схемі означає зміну будь-чого з\nцього. Нижче трапляються обидва значення. Коли текст описує схему як структуру,\nце видно з контексту, а «кілька схем» майже завжди означає простори імен.\n\nБілінг застосунку може жити у власній схемі, а сесія може вибрати, у яких схемах\nшукати:\n\n```sql\nCREATE SCHEMA billing;\n\nCREATE TABLE billing.invoices (\n  id     bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,\n  total  numeric(12, 2) NOT NULL\n);\n\nSHOW search_path;                  -- \"$user\", public\nSET search_path = billing, public;\nSELECT count(*) FROM invoices;     -- тепер це billing.invoices\n```\n\nІм'я, записане разом зі схемою, як-от `billing.invoices`, завжди означає ту саму\nтаблицю. Ім'я без схеми шукається через search_path — список схем, які сервер\nобходить по черзі, доки не знайде збіг. Типовий список — `\"$user\", public`:\nспершу схема з іменем поточної ролі, якщо така існує, потім схема public, з якою\nпочинається кожна нова база даних. Перша наявна схема зі шляху — це також місце,\nкуди CREATE TABLE кладе таблицю, ім'я якої записане без схеми, тому об'єкти\nпотрапляють у public, якщо хтось не вкаже інакше. Якщо ім'я є лише в схемі поза\nсписком, пошук завершується помилкою, навіть коли таблиця існує в тій самій базі\nданих.\n\n## Чому це важливо\n\nПерша причина — порядок. Базі даних із кількома сотнями таблиць потрібен рівень\nнад таблицею, і схеми його дають: білінг в одній, облікові записи в іншій,\nтаблиці стороннього інструмента в третій. Клієнтське з'єднання дістається лише\nоднієї бази даних, але схеми не відокремлені жорстко: роль може користуватися\nоб'єктами в будь-якій схемі бази, до якої під'єднана, якщо дозволяють права, а\nодин запит може з'єднувати таблиці з кількох схем.\n\nДруга причина — контроль доступу. Право USAGE на схему дозволяє ролі знаходити\nоб'єкти в ній, а CREATE — створювати нові. Якщо забрати USAGE, доступ до\nоб'єктів закривається, але їхні імена й далі можна прочитати в системних\nкаталогах, тож схема захищає дані, а не знання про те, що існує.\n`CREATE SCHEMA name AUTHORIZATION role` передає нову схему ролі, а імена, що\nпочинаються з `pg_`, зарезервовані для системи.\n\nТретя причина — безпека, бо схеми беруть участь у пошуку імен. Більшість імен у\nзапитах пишуть без схеми, тож, за словами посібника, додати схему до search_path\nфактично означає довіряти кожній ролі, яка може створювати в ній об'єкти. Така\nроль може змусити звичайний запит виконати функції на її вибір так, ніби їх\nвикликав той, хто виконує запит. Безпечні шаблони тримають схеми, у які можуть\nписати інші, поза шляхом користувача, наприклад по одній приватній схемі на\nкористувача, створеній командою `CREATE SCHEMA alice AUTHORIZATION alice`, яку\nелемент `\"$user\"` тоді знаходить першою. PostgreSQL 15 зрушив нові бази даних у\nцей бік: версія забрала в усіх ролей право створювати об'єкти в public і зробила\nвласника бази даних, через роль pg_database_owner, власником public.\n\nОстання причина — переносимість. Стандарт SQL має схеми, але не має схеми\npublic, а посібник зауважує, що деякі системи SQL можуть узагалі не\nреалізовувати схем. Кваліфіковані імена переносяться краще, ніж код, що\nспирається на search_path.\n\n## Як це виглядає на практиці\n\nМодель даних у\n[Змоделювала морський домен у 348 таблицях і 34 схемах](/uk/portfolio/modeled-348-tables-across-34-postgres-schemas/)\nвикористовує схеми в першому значенні, як рівень над таблицею. Морський домен із\nфахівцями, компаніями, суднами, вакансіями й відгуками організовано як\nнормалізовані схеми PostgreSQL, згруповані за доменами, — 348 таблиць у 34\nсхемах. Таблиці мають імена в множині всередині схем з іменами в однині, без\nвинятків, що також дає змогу уникнути багатьох конфліктів із зарезервованими\nсловами, а зв'язки підтримують реальні зовнішні ключі та обмеження. Додавання\nфункції зазвичай означає розширення схеми за наявною логікою, а не боротьбу\nпроти неї, і сторінка називає це єдиною причиною, чому 34 схеми — це структура,\nа не розповзання.\n\nСхема може бути й межею між двома завданнями. У\n[Побудувала рівень платежів і прав доступу](/uk/portfolio/built-stripe-and-in-app-purchase-entitlements/)\nкарткові платежі Stripe та in-app-покупки Apple і Google сходяться в схемі\npayments із 9 таблиць і 34 функцій. Окрема схема access, 11 таблиць і 34\nфункції, відповідає на «чи можна цьому обліковому запису зробити це?», не\nзнаючи, через який магазин надійшла оплата, і ця відповідь, яку сервер перевіряє\nповторно на кожен запит, регулює доступ до каталогу компаній, пошуку й експорту даних. Ціна,\nяк пише сторінка, — дві схеми там, де меншому продуктові вистачило б однієї,\nплюс перевірка прав на запитах, які інакше були б безкоштовними.\n\nДруге значення слова — тема сторінки\n[Тримала схему узгодженою впродовж 1 022 міграцій](/uk/portfolio/1022-migrations-behind-a-schema-drift-gate/).\nУ більшості проєктів схема описана двічі: у початковому налаштуванні, яке будує\nїї з нуля, і в міграціях, які її виростили, а без перевірки ці описи\nрозходяться. Тут база даних версіонована як 1 022 міграції, пронумеровані від\n036 до 1102, і CI-задача на кожну зміну збирає її двічі, один раз зі свіжої\nсхеми, а другий з кожною міграцією, відтвореною по черзі, і порівнює обидві:\nзасіяні дані так само, як структуру. Міграція, яка неправильно заповнює\nдовідкову таблицю, шкодить так само, як та, що забула колонку, а в diff схеми\nпотрапляє тільки одна з них. Будь-яка розбіжність валить білд із виведеною\nрізницею, тож кожна міграція має працювати у відтворенні й з холодного старту.\n\n## Де виникають проблеми\n\n**Функція, підкинута в спільну схему.** Розбір CVE-2018-1058 у вікі PostgreSQL\nпоказує атаку: один користувач створює `lower(varchar)` у public. Вбудована\n`lower` міститься в pg_catalog і приймає text, тож для колонки varchar підкинута\nфункція підходить точніше, і колега, який виконує\n`SELECT lower(full_name) FROM a`, запускає підкинутий код. Кваліфікуйте виклики\nв чутливому коді як `pg_catalog.lower`, заберіть CREATE на public у ролей, яким\nвоно не потрібне, і перегляньте, що там уже лежить, командою `\\df public.*`.\n\n**Оновлення, що зберегло старі права.** Безпечніша типова поведінка PostgreSQL\n15 стосується нових кластерів і щойно створених баз даних. Оновлення кластера\nабо відновлення дампа зберігає права, які public уже мала, тож сервер версії 15\nчи новішої все ще може дозволяти кожній ролі створювати там об'єкти. Посібник\nназиває типовий шлях разом із правом CREATE на public шаблоном, який ніколи не\nбуває безпечним, і зауважує, що саме він типовий у базах даних, оновлених із\nверсії 14 або давнішої. У такій базі виконайте\n`REVOKE CREATE ON SCHEMA public FROM PUBLIC`, а потім перевірте public на\nоб'єкти з іменами, схожими на імена в pg_catalog.\n\n**Таблиця, створена не там.** Міграція створює `invoices` без схеми, і таблиця\nпотрапляє в першу наявну схему на шляху тієї ролі, яка запускає міграцію.\nЗастосунок, що під'єднується з іншим шляхом, тоді читає іншу таблицю або отримує\n`relation \"invoices\" does not exist`. Кваліфікуйте кожне ім'я в міграціях і\nперевіряйте `SELECT current_schema()` у сесії, яка їх запускає.\n\n**DROP, що сягає за межі схеми.** `DROP SCHEMA billing` відмовляє, поки в схемі\nщось є, бо типовим є RESTRICT. З CASCADE команда видаляє всі об'єкти в схемі й\nусі об'єкти, що від них залежать, і посібник попереджає, що так можна видалити\nоб'єкти й в інших схемах, крім названої. Порада посібника — спершу виконати DROP\nбез CASCADE і прочитати рядки DETAIL, які перелічують, що буде видалено.\n\n**Ім'я, яке система знаходить першим.** Якщо pg_catalog не зазначено в\nsearch_path, пошук у ньому неявно відбувається раніше, ніж у схемах, перелічених\nна шляху. Якщо його зазначено явно, порядок пошуку визначає його позиція на\nшляху. Вашу власну таблицю з іменем, що починається з `pg_`, може затінити\nсистемна таблиця з тим самим іменем, яку додасть пізніша версія, тому посібник\nрадить уникати таких імен. Зарезервовані слова, як-от `user` і `order`, дають\nм'якшу версію тієї самої проблеми: таблиця з таким іменем потребує подвійних\nлапок у кожній інструкції.\n\n## Що почитати далі\n\n- [5.10. Schemas](https://www.postgresql.org/docs/current/ddl-schemas.html)\n  — розділ посібника: кваліфіковані імена, схема public, search_path, безпечні\n  шаблони використання й переносимість.\n- [CREATE SCHEMA](https://www.postgresql.org/docs/current/sql-createschema.html)\n  — синтаксис команди, конструкція AUTHORIZATION, зарезервований префікс `pg_` і\n  місця, де PostgreSQL відходить від стандарту.\n- [5.8. Privileges](https://www.postgresql.org/docs/current/ddl-priv.html)\n  — що означають USAGE і CREATE для схеми, поряд з усіма іншими правами.\n- [E.20. Release 15](https://www.postgresql.org/docs/15/release-15.html)\n  — випуск, який забрав CREATE на public у нових базах даних і зберіг його в\n  оновлених.\n- [A Guide to CVE-2018-1058: Protect Your Search Path](https://wiki.postgresql.org/wiki/A_Guide_to_CVE-2018-1058%3A_Protect_Your_Search_Path)\n  — розбір атаки з підкинутою функцією від самого проєкту, з виправленнями й\n  командами для перевірки бази даних.\n\n\u003chttps://engineer.company/uk/glossary/schema/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що таке схема бази даних у PostgreSQL, як search_path вирішує, яку таблицю означає ім'я, чому схему public треба закрити і де виникають проблеми.","formats":{"gemtext":"https://engineer.company/uk/glossary/schema/index.gmi","gopher":"https://engineer.company/uk/glossary/schema/gophermap","html":"https://engineer.company/uk/glossary/schema/","json":"https://engineer.company/uk/glossary/schema/index.json","markdown":"https://engineer.company/uk/glossary/schema/index.md","pdf":"https://engineer.company/uk/glossary/schema/index.pdf"},"kind":"page","language":"uk","title":"Що таке схема бази даних?","url":"https://engineer.company/uk/glossary/schema/","version":1}