Перейти к содержанию

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

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

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

  • подключение к консоли администратора для управления текущим инстансом
  • подключение к кластерной SQL-консоли под заранее созданным пользователем для выполнения SQL-команд в рамках распределенного кластера

Консоль администратора

Доступ к консоли

Консоль администратора предоставляет доступ к учетной записи Администратора СУБД (admin). Для запуска консоли используйте следующую команду с указанием файла unix-сокета:

picodata admin ./admin.sock

По умолчанию файл unix-сокета расположен в директории с данными инстанса Picodata. Размещение этого файла настраивается при запуске инстанса параметром picodata run --admin-sock.

При успешном подключении отобразится приглашение:

$ picodata admin ./admin.sock
Connected to admin console by socket path "./admin.sock"
type '\help' for interactive help
picodata>

Консоль администратора интерпретирует вводимые команды на языке SQL.

Задание пароля администратора

По умолчанию у Администратора СУБД отсутствует пароль, поэтому подключиться к консоли администратора возможно только при наличии доступа к ОС, в которой запущен инстанс Picodata. Для того чтобы подключаться к инстансу по сети, требуется задать пароль администратора:

ALTER USER "admin" WITH PASSWORD 'T0psecret'

После этого Администратор СУБД сможет подключиться, использую следующую команду:

picodata connect admin@localhost:3301

Создание учетной записи пользователя

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

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

CREATE USER "alex" WITH PASSWORD 'T0psecret';

Чтобы новый пользователь мог создавать таблицы, ему понадобится соответствующая привилегия:

GRANT CREATE TABLE TO "alex";

SQL-консоль

SQL-консоль позволяет выполнять распределенные SQL-команды в рамках кластера. После того как в системе создана пользовательская учетная запись, можно подключиться к SQL-консоли любого локального или удаленного инстанса. Для этого используется команда picodata connect. Пример для localhost:

picodata connect alex@localhost:3301

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

См. также:

Специальные команды в консоли

Следующие специальные команды поддерживаются в консоли Picodata:

  • Alt+Enter — переход к новой строке. Данная комбинация позволяет вводить многострочные команды. Для завершения ввода следует нажать Enter
  • Ctrl+C — отмена текущего ввода
  • Ctrl+D — выход из консоли Picodata

См. также: