{"canonical_url":"https://engineer.company/uk/glossary/sqlite/","content_markdown":"# SQLite\n\n## Що це таке\n\nSQLite — це рушій SQL-бази даних, який працює як бібліотека всередині програми,\nщо ним користується: без серверного процесу, мережевого порту й адміністратора,\nа таблиці, індекси, тригери та представлення лежать разом в одному звичайному\nфайлі на диску. Назва трапляється й у формі `sqlite3`: так звуть консольну\nоболонку, так названо єдиний файл із сирцями на C, `sqlite3.c`, і з `sqlite3_`\nпочинається кожна функція її C-інтерфейсу. Сам проєкт описує рушій як\nсамодостатній, безсерверний, без конфігурації та транзакційний і радить\nпорівнювати його з `fopen()`, а не з Oracle. Він заміняє саморобний файл даних,\nа не сервер бази даних.\n\nПроєкт стартував 9 травня 2000 року, а код перебуває в суспільному надбанні\n(public domain), тож перед вбудовуванням у продукт не треба розбиратися з\nліцензією. Формат файлу — частина домовленості: базу, записану на 32-бітній\nмашині, можна скопіювати на 64-бітну або між процесорами big-endian і\nlittle-endian та відкрити без змін. Розробники мають намір підтримувати SQLite\nдо 2050 року, а Бібліотека Конгресу США рекомендує цей формат для зберігання\nданих. З усіма увімкненими можливостями бібліотека може займати менше ніж\n900KiB, тому вона живе в телефонах, автомобілях, годинниках і настільних\nпрограмах так само, як і на серверах.\n\nУсередині це повноцінний SQL: з'єднання, підзапити, представлення, тригери й\nтранзакції з властивостями ACID, які зберігаються навіть тоді, коли живлення\nзникає посеред запису. Від серверних баз SQLite відрізняють два рішення. Перше\nстосується паралельної роботи: читати одночасно може скільки завгодно з'єднань,\nа писати в кожну мить — лише одне, і блокування охоплює весь файл. Друге\nстосується типів. Оголошений тип стовпчика — лише побажання, яке SQLite називає\nспорідненістю (affinity), а справжній тип належить кожному окремому значенню.\nТож стовпчик, оголошений як `INTEGER`, охоче прийме текст, геть не схожий на\nчисло.\n\nМежа з альтернативами чітка. PostgreSQL, MySQL і SQL Server — спільні сервіси,\nдо яких багато машин звертаються мережею. SQLite — приватне сховище однієї\nпрограми на одній машині. Порівняно з файлами CSV чи JSON SQLite додає мову\nзапитів, індекси, обмеження й транзакції ціною однієї залежності, яку більшість\nмов програмування вже мають у комплекті.\n\n## Чому це важливо\n\nНайважче питання про базу даних часто стосується не швидкості, а того, хто її\nобслуговуватиме. Сервер треба встановити, оновлювати, захищати, моніторити й\nрезервувати, і комусь за це платять. SQLite прибирає цю статтю витрат цілком.\nВідкрити базу — означає відкрити файл, резервна копія — це копія файлу, знята\nчерез backup API навіть під час роботи, а набір тестів може дати кожному тесту\nвласну свіжу базу.\n\nSQLite змінює й уявлення про те, чим може бути файл. Програма, яка інакше\nвигадувала б власний формат, писала б до нього парсер і сподівалася, що збій не\nтрапиться посеред збереження, може тримати свій стан у SQLite й отримати\nатомарне збереження задарма. Проєкт сам називає такі сценарії: формат файлу\nзастосунку, контейнер для перенесення даних між системами, де отримувач пише SQL\nзамість парсера, і тимчасова база для сортування та підсумовування даних, що\nприйшли в іншій формі.\n\nВибір зводиться до одного питання, на яке можна відповісти ще до першого рядка\nкоду: скільки процесів пишуть і на скількох машинах? Одна програма на одній\nмашині, що пише короткими сплесками, — рідна територія SQLite, і більшість\nсайтів із низьким чи помірним трафіком почуваються на ній добре. Кілька\nсерверів, що пишуть в одні й ті самі дані, або багато користувачів, які пишуть\nщомиті, — це справа клієнт-серверної бази. Розмір рідко щось вирішує, адже один\nфайл уміщує до 281 терабайта. Вирішує кількість тих, хто пише.\n\nНавіть на рідній території є ціна. `ALTER TABLE` уміє лише перейменувати таблицю\nчи стовпчик і додати або видалити стовпчик, тож більшість інших змін структури\nозначає нову таблицю, копіювання рядків і обмін назвами. Зовнішні ключі\nвимкнено, доки кожне з'єднання не ввімкне їх саме. А вільна типізація тихо\nпропускає хибні дані, якщо таблицю не оголошено так, щоб вона їх відкидала.\n\n## Як це виглядає на практиці\n\nНа задокументованому етапі розробки SQLite був джерелом істини для генератора\nрезюме, аркушів із рекомендаціями, портфоліо та супровідних листів:\n[усе бралося з бази SQLite на 23 таблиці](/uk/portfolio/built-a-database-driven-cv-generator/),\nвід досягнень і компаній до профілів і рекомендацій, яку збирав конвеєр із 19\nкроків: від порожнього файлу до повної бази однією командою. Кожен крок можна\nбуло безпечно повторити, тож конвеєр проганяли й по наявній базі, не дублюючи\nжодного рядка. З цього одного файлу 41 модуль Python загальним обсягом 10 580\nрядків видавав шість форматів, і залежностей під час виконання було рівно дві.\nДокумент для певного читача був запитом до досягнень, заданим профілем, а не\nвідредагованою копією. Ціну сторінка теж називала: система стала єдиним способом\nотримати документ.\n\nНа задокументованому етапі експорту портфоліо цього сайту генерувалося з тієї\nж бази, і тут SQLite був вхідними даними для збирання.\n[Експортер відкривав файл SQLite лише для читання й писав 495 сторінок](/uk/portfolio/generated-495-pages-from-a-sqlite-export/)\nтрьома мовами, користуючись тільки стандартною бібліотекою Python, а результат\nзберігався в репозиторії, тож сайт збирався без середовища генератора. Адреси\nсторінок зберігалися як рядки, по одному на адресу на досягнення, тож\nпереформульоване речення більше не пересувало сторінку. Під час тієї ж роботи\nзафіксували пастку з наступного розділу: порівняння періоду з текстовим\nстовпчиком зачепило всі тридцять два рядки.\n\nНайменший і найтиповіший випадок — SQLite як місце, де переглядають результати.\nКонвеєр, що перетворював сирі показники електроенергії на погодинне споживання\nпо зонах, записував результати в CSV або\n[у легку базу SQLite для перегляду](/uk/portfolio/a-month-of-meter-readings-in-180-milliseconds/),\nі версія на Python обробляла дані за один день за 34 мс, а за тридцять днів — за\n180 мс. Така база не потребує жодного налаштування: будь-хто з оболонкою\n`sqlite3` відкриє файл і поставить йому запит.\n\n## Де виникають проблеми\n\nБільшість клопотів із SQLite починається тоді, коли з нею поводяться як із\nмаленьким PostgreSQL. Це інша машина з іншими гострими кутами.\n\n**Фільтр за роком повертає всі рядки.** SQLite перетворює значення перед\nпорівнянням лише тоді, коли один із боків має спорідненість. Результат функції\nна кшталт `substr()` її не має, як і голе число, тому текст `'2019'`\nпорівнюється з цілим `2025` як є. А в порядку сортування SQLite будь-яке число\nстоїть перед будь-яким текстом:\n\n```sql\nCREATE TABLE stint (period TEXT, hours TEXT);\nINSERT INTO stint VALUES\n  ('2019-03', '9'), ('2024-11', '10'), ('2026-01', '42');\n\nSELECT count(*) FROM stint\nWHERE substr(period, 1, 4) \u003e= 2025;                   -- 3\n\nSELECT count(*) FROM stint\nWHERE CAST(substr(period, 1, 4) AS INTEGER) \u003e= 2025;  -- 1\n```\n\nЯвно приводьте типи там, де текст зустрічається з числом. Новим таблицям давайте\nсправжні типи й ключове слово `STRICT`, доступне з версії 3.37.0: суворий\nстовпчик `INTEGER` і далі приймає `'42'` та зберігає його як число, а `'ten'`\nвідкидає з помилкою.\n\n**Запис раптом завершується помилкою `database is locked`.** Одне з'єднання\nтримає блокування запису, а наступний записувач чекає або здається одразу.\nПричина зазвичай у довгій транзакції або в читачеві, який у типовому режимі\nrollback-журналу затримує записувача. Увімкніть write-ahead logging, щоб читачі\nй записувач перестали блокувати одне одного, тримайте транзакції запису\nкороткими і задайте busy timeout, щоб записувач трохи чекав, а не повертав\nпомилку. Якщо записувачів справді багато й вони пишуть постійно, це сигнал\nпереходити на сервер.\n\n**Файл псується на мережевому диску.** SQLite покладається на файлові блокування\nопераційної системи, а в багатьох мережевих файлових системах саме вони\nреалізовані з помилками, тож дві машини можуть водночас писати в ту саму частину\nфайлу. Write-ahead logging над мережевою файловою системою не працює взагалі, бо\nвсі процеси, що користуються базою, мають ділити пам'ять на одній машині.\nТримайте базу на локальному диску тієї єдиної програми, яка в неї пише, а якщо\nданих потребують інші машини, поставте перед ними сервер.\n\n**Рядок переживає батьківський запис, на який посилається.** Зовнішні ключі\nзаписано в схемі, але вони неактивні, доки кожне з'єднання не виконає\n`PRAGMA foreign_keys = ON`. Видалення через з'єднання, яке це пропустило, тихо\nзалишає рядки-сироти. Вмикайте прагму там, де програма відкриває з'єднання, в\nодному місці коду, і перевіряйте тестом, що вона справді ввімкнена.\n\n## Що почитати далі\n\n- [About SQLite](https://sqlite.org/about.html)\n  — опис від самого проєкту: у процесі програми, без сервера, у суспільному\n  надбанні, один файл для всіх платформ.\n- [Datatypes In SQLite](https://sqlite.org/datatype3.html)\n  — класи зберігання, спорідненість типів і правила порівняння, що стоять за\n  пасткою вище.\n- [STRICT Tables](https://sqlite.org/stricttables.html)\n  — як змусити таблицю дотримуватися оголошених типів стовпчиків.\n- [Write-Ahead Logging](https://sqlite.org/wal.html)\n  — читачі й записувач паралельно і чому для цього потрібна одна машина.\n- [Appropriate Uses For SQLite](https://sqlite.org/whentouse.html)\n  — де SQLite доречна, де краще підходить клієнт-серверна база, і\n  контрольний список.\n- [SQLite Foreign Key Support](https://sqlite.org/foreignkeys.html)\n  — чому обмеження за замовчуванням вимкнені і як їх увімкнути.\n\n\u003chttps://engineer.company/uk/glossary/sqlite/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"SQLite замінює сервер бази даних бібліотекою і файлом: добрий вибір, коли пише один процес на одній машині, хоча вільна типізація вміє ввести в оману.","formats":{"gemtext":"https://engineer.company/uk/glossary/sqlite/index.gmi","gopher":"https://engineer.company/uk/glossary/sqlite/gophermap","html":"https://engineer.company/uk/glossary/sqlite/","json":"https://engineer.company/uk/glossary/sqlite/index.json","markdown":"https://engineer.company/uk/glossary/sqlite/index.md","pdf":"https://engineer.company/uk/glossary/sqlite/index.pdf"},"kind":"page","language":"uk","title":"Що таке SQLite?","url":"https://engineer.company/uk/glossary/sqlite/","version":1}