// бесплатный инструмент

Конструктор строк подключения SQLite

Создавайте строки подключения SQLite для Microsoft.Data.Sqlite, JDBC, SQLAlchemy, Python и Node из пути к файлу или вставьте строку URI, имени файла или Data Source, чтобы увидеть, что делает каждый параметр. Всё работает в вашем браузере: ничего из того, что вы вводите, никуда не отправляется.

Открыть это подключение в 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.

SQLly — это нативная рабочая среда SQL для macOS, Windows и Linux. Вставьте строку подключения в её редактор подключений, храните пароли в системной связке ключей и получайте IntelliSense с учётом схемы для SQLite и других баз данных.