Конструктор строк подключения DuckDB
DuckDB работает внутри вашего процесса и открывает файл, поэтому его «строка подключения» — это путь. Сформируйте JDBC URL, вызов Python, SQLAlchemy URL и команду CLI для файла базы данных — в режиме только для чтения или в памяти. Всё работает в вашем браузере: ничего из того, что вы вводите, никуда не отправляется.
Открыть это подключение в SQLly
Открывает редактор подключений SQLly с заполненными полями.
Открыть это подключение в SQLly
Приватность на уровне архитектуры. Конструктор и декодер — обычный JavaScript, работающий в этой вкладке. Страница никуда не отправляет то, что вы вводите, ничего не хранит (даже в вашем браузере) и продолжает работать офлайн после загрузки. Ссылка «Открыть в SQLly» ведёт из вашего браузера прямо в приложение на вашем компьютере.
Форматы строк подключения DuckDB
Каждый клиент DuckDB открывает путь к файлу базы данных, или :memory: для временной базы данных в памяти. Открыть файл на чтение и запись одновременно может только один процесс; в режиме только для чтения его могут совместно использовать несколько.
Путь к файлу каждый клиент, SQLly
/var/data/analytics.duckdb
JDBC JDBC-драйвер DuckDB
jdbc:duckdb:/var/data/analytics.duckdb
URL SQLAlchemy duckdb-engine
duckdb:////var/data/analytics.duckdb
CLI, только для чтения duckdb
duckdb -readonly /var/data/analytics.duckdb
Заполнители, такие как your_password — это лишь примеры: соберите свою строку в форме выше. Подробнее о подключении SQLly к DuckDB: SQLly для DuckDB.
Открытие базы данных DuckDB
Режим только для чтения позволяет нескольким процессам читать один файл.
| Ключевое слово | Синонимы | По умолчанию | Что оно делает |
|---|---|---|---|
JDBC |
- | jdbc:duckdb: (в памяти) | jdbc:duckdb:/path/file.duckdb; только для чтения с помощью duckdb.read_only=true свойства подключения. Настройки могут следовать через точки с запятой: jdbc:duckdb:/path;threads=4. |
Python |
- | :memory: | duckdb.connect("file.duckdb", read_only=True). |
SQLAlchemy |
- | - | duckdb:///relative.duckdb, duckdb:////abs/path.duckdb, duckdb:///:memory:; только для чтения с помощью connect_args={"read_only": True}. |
CLI |
- | в памяти | duckdb file.duckdb; добавьте -readonly для режима только для чтения. |
Node.js |
- | - | @duckdb/node-api: await DuckDBInstance.create("file.duckdb"). |
Распространённые ошибки подключения к DuckDB
IO Error: Could not set lock on file "analytics.duckdb": Conflicting lock is held
Почему: Другой процесс уже открыл файл для чтения и записи (часто это блокнот, сеанс CLI или второй экземпляр приложения).
Исправлено: Закройте другой процесс или откройте оба только для чтения, если ни одному не нужно записывать.
IO Error: Cannot open database "analytics.duckdb" in read-only mode: database does not exist
Почему: Режим только для чтения никогда не создаёт файл, а путь неверен либо указан относительно неожиданной рабочей директории.
Исправлено: Используйте абсолютный путь к существующей базе данных.
Часто задаваемые вопросы о строках подключения DuckDB
Есть ли у DuckDB строка подключения?
Не в клиент-серверном смысле: DuckDB — встраиваемая СУБД, поэтому вы открываете путь к файлу (или :memory:). Обёртки различаются: jdbc:duckdb:/path в Java, duckdb:///path в SQLAlchemy, обычный путь в Python, Node и CLI.
Как открыть файл DuckDB только для чтения?
read_only=True в Python, свойство duckdb.read_only=true свойство в JDBC, connect_args={"read_only": True} в SQLAlchemy, или duckdb -readonly file.duckdb в CLI.
Могут ли две программы использовать один и тот же файл DuckDB?
Только один процесс может иметь к нему доступ на чтение и запись. Несколько процессов могут одновременно открывать его только для чтения.
Другие движки
- Строки подключения к SQL Server
- Строки подключения к PostgreSQL
- Строки подключения к MySQL
- Строки подключения к MariaDB
- Строки подключения к SQLite
- Строки подключения к Oracle
- Строки подключения Redis
- Строки подключения ClickHouse
- Строки подключения libSQL
- Все движки и форматы
- Форматировщик SQL
- Все бесплатные инструменты
Подключитесь один раз. А потом просто пишите SQL.
SQLly — это нативная рабочая среда SQL для macOS, Windows и Linux. Вставляйте строку подключения в её редактор подключений, храните пароли в системной связке ключей и получайте IntelliSense с учётом схемы для DuckDB и других баз.