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

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

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

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

Содержание:

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

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

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

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

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

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

• 3301
• 8081

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

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

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

 
docker compose up -d

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

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

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

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

 
cd ./docs/docs/ru/assets/examples/go_directly/go

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

 
go run -tags go_tarantool_ssl_disable main.go

Здесь:

• go_tarantool_ssl_disable — опция, отключающая поддержку TLS. Так как для поддержки TLS требуется установленный OpenSSL 3.x, для простоты в примере поддержка TLS отключена.

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

 
Directly recorded 10000 rows one at a time in 670.147941msTuples [{{} 1 77 WjishcEWgbUGSerPYtkmAhtSrRYXmyYaXDyScIFcRCpFwIMYpGZwrZbYRSBUdPAP}]

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

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

 
docker compose down