Запуск YDB из бинарного файла

В данном разделе описывается процесс разворачивания локального одноузлового кластера YDB c использованием собранного бинарного файла. В настоящее время поддерживается только сборка для Linux. Сборки под Windows и MacOS будут добавлены позже.

Параметры соединения

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

Установка

Создайте рабочую директорию. Запустите в ней скрипт скачивания архива с исполняемым файлом ydbd и необходимыми для работы YDB библиотеками, а также набора скриптов и вспомогательных файлов для запуска и остановки сервера:

curl https://binaries.ydb.tech/local_scripts/install.sh | bash

Запуск

Локальный сервер YDB может быть запущен в режиме работы с диском или в памяти:

  • Для эффективной работы YDB рекомендуется использовать физические (не виртуальные) диски объемом более 800 ГБ как блочные устройства.

    Минимальный объем диска должен быть не менее 80 ГБ, при меньшем объеме узел YDB не сможет использовать устройство. Корректная и бесперебойная работа с дисками минимального объема не гарантируется. Использовать такие диски рекомендуется исключительно в ознакомительных целях.

    Важно

    Конфигурации с дисками объемом меньше 800 ГБ или с любыми видами виртуализации системы хранения нельзя использовать для сервисов, находящихся в промышленной эксплуатации, а также для тестирования производительности системы.

    Мы не рекомендуем использовать для хранения данных YDB диски, которые используются другими процессами (в том числе операционной системой).

  • При первом запуске скрипта в рабочей директории будет создан файл ydb.data размером 80 ГБ. Убедитесь, что у вас есть достаточно свободного места для его создания.

  • Выполните следующую команду из рабочей директории:

    ./start.sh disk

  • При хранении данных в памяти остановка сервера приведет к их потере.

  • Выполните следующую команду из рабочей директории:

    ./start.sh ram

Запуск сервера YDB производится в контексте текущего окна терминала. Закрытие окна терминала приведет к остановке сервера.

Если при запуске вы получаете ошибку Failed to set up IC listener on port 19001 errno# 98 (Address already in use), то возможно сервер уже был запущен ранее, и вам нужно остановить его скриптом stop.sh (см. ниже).

Остановка

Для остановки сервера выполните команду в рабочей директории:

./stop.sh

Выполнение запросов через YDB CLI

Установите YDB CLI и выполнить запросы, как описано в статье YDB CLI - Начало работы, используя эндпоинт и путь базы данных в начале данной статьи, например:

ydb -e grpc://localhost:2136 -d /Root/test scheme ls

Работа с базой данных через Web UI

Для работы со структурой и данными в базе данных также доступен встроенный в процесс ydbd web-интерфейс по адресу http://localhost:8765. Подробней возможности встроенного веб-интерфейса описаны в разделе Embedded UI.

Дополнительные возможности

Описание развертывания многоузловых кластеров и их конфигурирования находится в разделе Управление кластером.

В этой статье: