Работа напрямую с экземпляром Tarantool DB через Java-коннектор

В примере операции выполняются напрямую с конкретным экземпляром. Такой подход может увеличить производительность, но требует дополнительной экспертизы — понимания внутреннего устройства кластера Tarantool DB и принципа его работы.

В этом примере показано, как выполнять операции напрямую с конкретным экземпляром: приложение записывает по одной строке напрямую в спейс, а также выполняет чтение. Чтобы удобно просматривать содержимое спейсов, в примере используется роль space-explorer. Другие роли в этом примере не используются.

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

Содержание:

• Пререквизиты
• Запуск стенда
• Запуск приложения
• Остановка стенда

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

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

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

• Maven;

• Java версии 8+;

• установленный tarantool-java-ee версии 1.3.1.

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

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

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

• 3301
• 8081

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

 
cd ./docs/docs/ru/assets/examples/java_directly/tt

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

 
docker compose up -d

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

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

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

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

 
cd ./docs/docs/ru/assets/examples/java_directly

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

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

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

 
Directly recorded 10000 rows one at a time in 483 millisecondsTuples: [[1, 4677746723089159966, aHRDJPQVkTEBttESWzzUH]]

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

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

 
docker compose down