Подключение и работа в консоли

В данном разделе приведены сведения, которые помогут подключиться к запущенному экземпляру Picodata и начать работу в консоли.

Методы подключения

Подключение при запуске Picodata

По умолчанию команда picodata run запускает инстанс, но не предоставляет доступ к управлению им в консоли. Для подключения к интерактивной Lua-консоли следует запускать инстанс с ключом -i (picodata run -i). Встроенная консоль предоставляет привилегии уровня администратора СУБД (admin) и разрешает все действия в рамках локальной консоли. При этом, привилегия SESSION, позволяющая подключаться к удаленным инстансам по сети, у локального администратора отсутствует. Подробнее см. в разделе Управление доступом.

Подключение к ранее запущенному экземпляру

Подключение с помощью адреса экземпляра

picodata connect localhost:3301

По умолчанию, подключение производится под пользователем guest без пароля. У такого пользователя имеется единственная привилегия SESSION.

Подключение с помощью сокета

Для этого экземпляр должен быть запущен с указанием такого сокета:

picodata run --console-sock /tmp/file.socket

Подключение к сокету:

picodata connect --unix /tmp/file.socket

В данном случае откроется административная консоль (подключение с правами пользователя admin).

Переключение языка консоли

По умолчанию используется синтаксис Lua. Для переключения на язык SQL:

\set language sql

Для включения многострочного ввода на SQL следует задать разделитель команд (для примера указан символ ;):

\set delimiter ;

Для возврата к Lua:

\set language lua

Рабочие файлы инстанса

В директории с данными инстанса автоматически появляются следующие файлы:

*.snap — файлы снапшотов БД
*.xlog — файлы журнала упреждающей записи (Write-ahead log, WAL) c инкрементными изменениями БД
*.vylog — также файлы с инкрементными изменениями БД, но для таблиц, использующих движок хранения vinyl.

При перезапуске инстанса эти файлы необходимы для восстановления его состояния, обеспечивая персистентное хранение данных.

Файлы снапшотов (*.snap) и журнала WAL (*.xlog/*.vylog) не полностью взаимозаменяющие, так как, например, при аварийном завершении инстанса часть записей может не попасть в последний снапшот, но при этом попадет в файл журнала. В таком случае для полного восстановления данных нужен будет и последний снапшот, и один или несколько файлов журнала.

Параметры запуска из командной строки описаны в разделе Аргументы командной строки.