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

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

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

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

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

• Maven;

• Java версии 8+;

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

  Примечание

  Есть два способа получить исходные файлы примера:

  • Архив с полной документацией Tarantool DB, полученный по почте или скачанный в личном кабинете tarantool.io. Пример архива: tarantooldb-documentation-0.8.0.tar.gz. Пример java_crud расположен в таком архиве в директории ./doc/examples/java_crud/.

  • Отдельный архив java_crud.tar.gz, скачанный c сайта Tarantool.

Кроме того, для загрузки Java-коннектора нужно настроить конфигурацию Maven. Чтобы задать эту конфигурацию, используйте инструкцию Установка клиента tarantool-java-ee.

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

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

• 3301–3306;

• 8081–8086.

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

cd ./doc/examples/java_crud/tt

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

docker compose up -d

Команда развернет кластер Tarantool DB, состоящий из двух шардов и двух роутеров. После запуска должны работать все контейнеры, кроме tarantool-db-init.

Теперь откройте в браузере веб-интерфейс Tarantool DB по адресу http://localhost:8081. Перейдите во вкладку Cluster и проверьте, что отсутствуют ошибки или предупреждения. В течение нескольких секунд после старта кластер еще поднимается, так что могут появиться предупреждения. В примере не используется шардирование, поэтому модуль vshard не запущен.

После этого перейдите на вкладку Space Explorer и выберите любой узел, например, storage1. Проверьте, что на узле есть спейс test.

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

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

cd ./doc/examples/java_crud

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

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

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

Records inserted via CRUD in batches of 10000 records in 1106 ms
Rows verified

Необходимо убедиться, что в спейсе test появились данные.

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

Остановить стенд можно так:

docker compose down