# Установка и администрирование
# 1 УСТАНОВКА
# 1.1 Установка под Windows
Для установки NitrosBase под Windows достаточно запустить сетап файл nbsetup.exe
Требования к операционной системе
- Windows Server 2016 и выше
- Windows 10
Требования к аппаратному обеспечению
- Количество ядер процессора — от 4;
- Частота процессора — от 2.0 GHz;
- Объем оперативной памяти — от 16 GB;
- Объем свободного места на жестком диске (предпочтителен SSD) — от 128 GB.
Развертывание демонстрационной БД
Запустите терминал, перейдите в папку bin и выполните следующие команды:
Создание демонстрационной базы данных
sntest1
:
nbase sntest1 -c create -p 3020
Заполнение базы тестовыми данными:
nbase -p 3020 -q < ../samples.data/sntest1/prepare.sql
Выполнение простого демонстрационного запроса:
nbase -p 3020 -q "select name, lastname, age from person limit 10"
# 1.2 Установка под Linux
Для установки NitrosBase под Linux достаточно распаковать архив с дистрибутивом в любой каталог.
Требования к операционной системе
- Linux x64
- GNU library GLIBC 2.23 и выше
Требования к аппаратному обеспечению
- Количество ядер процессора — от 4;
- Частота процессора — от 2.0 GHz;
- Объем оперативной памяти — от 16 GB;
- Объем свободного места на жестком диске (предпочтителен SSD) — от 128 GB.
Развертывание демонстрационной БД
Запустите терминал, перейдите в папку bin и выполните следующие команды:
Создание демонстрационной базы данных
sntest1
:
./nbase sntest1 -c create -p 3020
Заполнение базы тестовыми данными:
./nbase -p 3020 -q < ../samples.data/sntest1/prepare.sql
Выполнение простого демонстрационного запроса:
./nbase -p 3020 -q "select name, lastname, age from person limit 10"
# 2 АДМИНИСТРИРОВАНИЕ
Программа nbase
позволяет администрировать базы данных NitrosBase.
Для работы в терминальном режиме можно использовать команды CLI (Command Line Interface).
Также nbase
является веб сервером для удаленного администрирования с помощью стандартного веб браузера.
# 2.1 Интерфейс командной строки
Программа nbase
предоставляет интерфейс командной строки для выполнения базовых задач по администрированию СУБД NitrosBase.
nbase [dbname] [options]
OPTIONS:
--help
-h -- show this help
--command=<command>
-c <command> -- command:
create - create new database and start server for it
(dbname and port are required)
open - start server for database specified
(dbname and port are required)
close - stop server of database specified
(port is required)
backup - backup database specified
(port is required)
restore - restore database specified
(dbname, port and backuppath are required)
--port=<port>
-p <port> -- TCP port listened by server
--folder <path>
-f <path> -- path to folder where database will be created
default is setuppath/data
(c:/nitrosbaseuni/data for windows)
--query="sqlcommand"
-q "sql command" -- execute SQL query against database specified
(port is required);
if query is omitted, it will be red
from standard input
-b <path> -- backup path
-t -- terminate nbase background process
Usage 2:
nbase a -- start admin panel
# Примеры
# Создание и запуск базы данных
nbase sntest1 -c create -p 3020
По умолчанию база создается в папке setuppath/data (c:/nitrosbaseuni/data for windows). Для создания базы данных в другой папке можно использовать параметр -f
nbase sntest2 -f d:\tmp -c create -p 3021
# Запуск существующей базы данных
nbase sntest1 -c open -p 3020
# Остановка базы данных
nbase -c close -p 3020
# Выполнение SQL-запроса
nbase -p 3020 -q "select * from person limit 10"
# Выполнение SQL-запроса из файла
nbase -p 3020 -q < query.sql
# 2.2 WEB Интерфейс администратора
WEB Интерфейс администратора будет доступен в версии NitrosBase 2.2
NitrosBase Admin
- это веб-приложение для управления СУБД NitrosBase. Оно поддерживает все функции, необходимые для работы с СУБД: от написания простых SQL-запросов до разработки сложных баз данных.
NitrosBase
Admin поддерживается операционными системами Windows
и Linux
.
Для запуска приложения под Windows
необходимо перейти в меню Пуск
, найти папку NitrosBase
и внутри нее выбрать NitrosBase Аdmin
. Веб-приложение NitrosBase Admin
запускается в Web браузере.
Для запуска приложения под Linux
выполните команду
nbase a
Вы также можете запустить браузер и указать URL: 127.0.0.1:8000
В общем виде интерфейс программы представлен:
- главным меню, расположенным вверху страницы;
- левой панелью, содержащей дерево объектов управления (базы данных, таблицы, колонки, индексы): для примера в программе представлена тестовая база данных;
- областью запросов, позволяющей создавать каждый запрос в отдельной вкладке;
- областью данных, отображающей результаты запросов.
Для создания баз данных и выполнения операций над объектами базы данных предусмотрено контекстное меню, содержащее команды по созданию, изменению и удалению объектов базы данных. Все изменения, производимые в базе данных, отображаются в дереве объектов на левой панели.
Для работы с запросами в NitrosBase Admin
создан отдельный раздел меню Query
, позволяющий создавать, сохранять, открывать сохраненные запросы, запускать их выполнение и т.д.
Для удобства пользователя в разделе Help
представлены информационные ресурсы, которые помогут в работе с данным приложением.
# 2.3 Структура каталогов
Распакованный дистрибутив содержит следующие каталоги:
bin
— исполняемые файлы сервера и клиента СУБД, часть библиотекdata
— папка, в которой создаются базы данныхinclude
— заголовочные файлы C/C++samples.c++
— примеры на языке С++samples.java
— примеры на языке Javasamples.data
— данные для тестовой базы данных