Конструктор строк подключения SQLite
Создавайте строки подключения SQLite для Microsoft.Data.Sqlite, JDBC, SQLAlchemy, Python и Node из пути к файлу или вставьте строку URI, имени файла или Data Source, чтобы увидеть, что делает каждый параметр. Всё работает в вашем браузере: ничего из того, что вы вводите, никуда не отправляется.
Открыть это подключение в SQLly
Открывает редактор подключений SQLly с заполненными полями.
Открыть это подключение в SQLly
Приватность на уровне архитектуры. Конструктор и декодер — обычный JavaScript, работающий в этой вкладке. Страница никуда не отправляет то, что вы вводите, ничего не хранит (даже в вашем браузере) и продолжает работать офлайн после загрузки. Ссылка «Открыть в SQLly» ведёт из вашего браузера прямо в приложение на вашем компьютере.
Форматы строк подключения SQLite
«Строка подключения» SQLite в основном представляет собой путь к файлу, но каждая оболочка оформляет его по-своему: Data Source=app.db в .NET, jdbc:sqlite:/path в Java, sqlite:////abs/path.db (четыре слэша) в SQLAlchemy. URI-файлы SQLite (file:app.db?mode=ro) добавляют такие опции, как режим только для чтения, но лишь когда вызывающая сторона включает обработку URI.
Путь к файлу sqlite3 CLI, большинство драйверов, SQLly
/var/data/app.db
URI-имя файла (только для чтения) URI-имена файлов SQLite
file:///var/data/app.db?mode=ro
ADO.NET Microsoft.Data.Sqlite, EF Core
Data Source=/var/data/app.db;Mode=ReadOnly
JDBC xerial sqlite-jdbc
jdbc:sqlite:/var/data/app.db
URL SQLAlchemy Python SQLAlchemy
sqlite:////var/data/app.db
Заполнители, такие как your_password — это лишь примеры: соберите свою строку в форме выше. Подробнее о подключении SQLly к SQLite: SQLly для SQLite.
Параметры URI-имён файлов SQLite
Схема — file:; часть authority должна быть пустой или localhost, так что file:/abs/path, file:///abs/path и file://localhost/abs/path всё это один и тот же файл. Кодируйте ? как %3F и # как %23 в пути. Обработка URI по умолчанию выключена: включите её с помощью SQLITE_OPEN_URI, uri=True в Python или эквивалент из вашей обёртки.
| Ключевое слово | Синонимы | По умолчанию | Что оно делает |
|---|---|---|---|
mode |
- | rwc | ro только для чтения, rw чтение-запись (должен существовать), rwc чтение-запись-создание, memory в памяти. |
cache |
- | частный | shared позволяет подключениям в одном процессе использовать общий кэш. |
immutable |
- | 0 | 1 обещает, что файл никогда не меняется: никакой блокировки. Если кто-то всё же записывает, чтение вернёт повреждённые данные. |
nolock |
- | 0 | 1 отключает блокировку файлов. |
vfs |
- | VFS по умолчанию | Имя используемого модуля VFS. |
psow |
- | сборка по умолчанию | Безопасная при сбое питания перезапись (powersafe overwrite). |
Ключевые слова Microsoft.Data.Sqlite
Стиль ADO.NET. Data Source также может быть URI-именем файла.
| Ключевое слово | Синонимы | По умолчанию | Что оно делает |
|---|---|---|---|
Data Source |
Источник данных, Имя файла | пусто (временная база данных на диске) | Путь к файлу, :memory:, или URI-имя файла. |
Mode |
- | ReadWriteCreate | ReadWriteCreate, ReadWrite, ReadOnly, Memory. |
Cache |
- | По умолчанию | Default, Private, Shared. |
Password |
- | - | Отправляет PRAGMA key; требует сборку с поддержкой шифрования, такую как SQLCipher. |
Foreign Keys |
- | пусто (нет pragma) | True включает PRAGMA foreign_keys. |
Recursive Triggers |
- | Ложь | PRAGMA recursive_triggers. |
Default Timeout |
Тайм-аут команды | 30 | 6.0+. Секунды; а также сколько ждать при заблокированной базе данных. |
Pooling |
- | Истина | 6.0+. Пул подключений. |
Распространённые ошибки подключения к SQLite
unable to open database file
Почему: SQLITE_CANTOPEN: каталог не существует, процесс не может записывать в каталог (SQLite нужно создавать журнальные файлы рядом с базой данных), относительный путь, вычисленный от неожиданного рабочего каталога, или ~ использовался (SQLite его не расширяет).
Исправлено: Используйте абсолютный путь, создайте директорию и предоставьте процессу права на запись в директорию, а не только в файл.
database is locked
Почему: SQLITE_BUSY: другое соединение удерживает блокировку на запись, а это соединение не дождалось достаточно долго.
Исправлено: Установите тайм-аут занятости (Default Timeout в Microsoft.Data.Sqlite, timeout в Python, busy_timeout pragma), не затягивайте транзакции записи и рассмотрите PRAGMA journal_mode=WAL для параллельного чтения.
attempt to write a readonly database
Почему: Файл или его директория доступны только для чтения для этого процесса, или он был открыт с mode=ro / Mode=ReadOnly.
Исправлено: Исправьте права доступа к файлу и его директории или откройте файл для чтения и записи.
file is not a database
Почему: SQLITE_NOTADB: файл не является SQLite (например, файл DuckDB), зашифрован с использованием ключа, который вы не предоставили, или поврежден.
Исправлено: Проверьте, что это за файл (file app.db на macOS/Linux) и откройте его с правильным движком или ключом.
FAQ по строкам подключения SQLite
Что такое строка подключения SQLite?
Обычно это просто путь к файлу. В .NET это Data Source=/path/app.db, в Java jdbc:sqlite:/path/app.db, в SQLAlchemy sqlite:////path/app.db для абсолютного пути (sqlite:///app.db для относительного пути).
Как открыть базу данных SQLite только для чтения?
Используйте имя файла в формате URI с mode=ro (file:/path/app.db?mode=ro, с включенной обработкой URI) Mode=ReadOnly в Microsoft.Data.Sqlite, open_mode=1 в sqlite-jdbc, или readonly: true в better-sqlite3.
Как создать базу данных SQLite в памяти?
Используйте :memory: в качестве пути. Каждое подключение получает собственную приватную базу данных, если не использовать URI с разделяемым кэшем, например file::memory:?cache=shared.
Почему в URL SQLite у SQLAlchemy четыре слеша?
sqlite:// это схема и пустой хост, третий слеш завершает часть хоста, а остальное — это путь. Абсолютный путь начинается с собственного слеша, поэтому /var/data/app.db становится sqlite:////var/data/app.db.
Другие движки
- Строки подключения к SQL Server
- Строки подключения к PostgreSQL
- Строки подключения к MySQL
- Строки подключения к MariaDB
- Строки подключения к Oracle
- Строки подключения Redis
- Строки подключения ClickHouse
- Строки подключения DuckDB
- Строки подключения libSQL
- Все движки и форматы
- Форматировщик SQL
- Все бесплатные инструменты
Подключитесь один раз. А потом просто пишите SQL.
SQLly — это нативная рабочая среда SQL для macOS, Windows и Linux. Вставьте строку подключения в её редактор подключений, храните пароли в системной связке ключей и получайте IntelliSense с учётом схемы для SQLite и других баз данных.