TDB Documentation portal logo
Помощь
Обновлена 30 июня 2026 г. в 07:00

Работа с кластером Tarantool DB через модуль CRUD с помощью Java-коннектора

В примере приложение записывает кортежи в спейс пачками через выбранный роутер, а также проверяет эти записанные кортежи.

Узнать больше про Java-коннектор можно в репозитории tarantool/tarantool-java-ee.

Содержание:

Пререквизиты

Для выполнения примера требуются:

  • установленный Docker-образ Tarantool DB;

  • приложение Docker Compose;

  • Maven;

  • Java версии 8+;

  • установленный Java-коннектор версии 1.1.3. Для установки используйте инструкцию Установка клиента tarantool-java-ee;

  • исходные файлы примера java_crud.

Запуск стенда

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

  • 2379
  • 3301--3308
  • 8081

Перейдите в директорию java_crud:

cd ./docs/docs/ru/assets/examples/java_crud

Стенд состоит из:

  • кластера Tarantool DB:
    • 2 роутера;
    • 2 набора реплик по 3 хранилища;
  • кластера etcd из 3 узлов;
  • 1 Tarantool Cluster Manager (TCM);
  • клиентского приложения, подающего нагрузку.

Запустите стенд:

make start

После запуска должны работать все контейнеры, кроме init_host.

Также после запуска кластера становится доступен веб-интерфейс TCM. Для входа в TCM откройте в браузере адрес http://localhost:8081. Логин и пароль для входа:

  • Username: admin
  • Password: secret

В TCM откройте вкладку Stateboard. После применения настроек кластер будет выглядеть так:

Работа с кластером Tarantool DB через модуль CRUD с помощью Java-коннектора

Выберите в наборе реплик router-msk узел router-msk и в открывшемся окне перейдите на вкладку Terminal. Во вкладке Terminal проверьте наличие спейса test:

box.space

Спейс test должен присутствовать в выводе, он создается при запуске кластера.

Запуск приложения

Откройте вторую вкладку терминала. В этой вкладке перейдите в директорию java_crud:

cd ./docs/docs/ru/assets/examples/java_crud

Запустите Java-приложение:

mvn clean compilemvn exec:java -Dexec.mainClass="org.example.App"

Вывод после окончания работы приложения выглядит так:

Records inserted via CRUD in batches of 10000 records in 1106 msRows verified

Теперь проверьте, что в спейсе test появились данные. Для этого в TCM перейдите на вкладку Tuples и выберите в списке спейс test. Откроется новая вкладка с содержимым кортежей спейса test.

Остановка стенда

Чтобы остановить стенд, в локальном терминале выполните следующую команду:

make stop