Подключение

Подключение или создание базы данных

Для использования DuckDB необходимо сначала установить подключение к базе данных. Точный синтаксис варьируется в зависимости от клиентских API, но обычно это подразумевает передачу аргумента для настройки персистентности.

Персистентность

DuckDB может работать как в режиме персистентности, где данные сохраняются на диск, так и в режиме оперативной памяти, где весь набор данных хранится в оперативной памяти.

Подсказка. И персистентные, и базы данных в оперативной памяти используют разлив на диск, чтобы облегчить обработку задач, объём которых превышает объём памяти (т.е., обработку вне ядра).

Персистентная база данных

Для создания или открытия персистентной базы данных укажите путь к файлу базы данных, например, my_database.duckdb, при создании подключения. Этот путь может указывать на существующую базу данных или на файл, которого ещё нет, и DuckDB откроет или создаст базу данных в этом месте по мере необходимости. Файл может иметь произвольное расширение, но .db или .duckdb — два распространённых варианта, а .ddb иногда также используется.

Начиная с версии v0.10, формат хранения DuckDB является обратно совместимым, т.е. DuckDB может читать файлы баз данных, созданные более старыми версиями DuckDB. Например, DuckDB v0.10 может читать и работать с файлами, созданными предыдущей версией DuckDB, v0.9. Более подробную информацию о формате хранения DuckDB см. на странице хранения.

База данных в оперативной памяти

DuckDB может работать в режиме оперативной памяти. В большинстве клиентов это можно активировать, передав специальное значение :memory: в качестве файла базы данных или опуская аргумент файла базы данных. В режиме оперативной памяти данные не сохраняются на диск, поэтому все данные теряются при завершении процесса.