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

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

DuckDB работает внутри вашего процесса и открывает файл, поэтому его «строка подключения» — это путь. Сформируйте JDBC URL, вызов Python, SQLAlchemy URL и команду CLI для файла базы данных — в режиме только для чтения или в памяти. Всё работает в вашем браузере: ничего из того, что вы вводите, никуда не отправляется.

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

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