Работа с кластером Tarantool DB через модуль CRUD с помощью Go-коннектора¶
В примере приложение записывает кортежи в спейс пачками через выбранный роутер, а также выполняет чтение.
Для взаимодействия в целях универсальности используется тип interface{}. Это означает, что значения после чтения нужно преобразовывать в нужный тип.
Для примера показано преобразование в число.
Узнать больше про Go-коннектор можно в репозитории tarantool/go-tarantool.
Содержание:
Пререквизиты¶
Для выполнения примера требуются:
установленный Docker-образ Tarantool DB;
приложение Docker compose;
исходные файлы примера
go_crud.Примечание
Есть два способа получить исходные файлы примера:
Архив с полной документацией Tarantool DB, полученный по почте или скачанный в личном кабинете tarantool.io. Пример архива:
tarantooldb-documentation-0.8.0.tar.gz. Примерgo_crudрасположен в таком архиве в директории./doc/examples/go_crud/.Отдельный архив go_crud.tar.gz, скачанный c сайта Tarantool.
Запуск стенда¶
Для успешного запуска должны быть свободны порты:
3301–3306;
8081–8086.
Перейдите в директорию go_crud/tt:
cd ./doc/examples/go_crud/tt
Запустите стенд:
docker compose up -d
Команда развернет кластер Tarantool DB, состоящий из двух шардов и двух роутеров.
После запуска должны работать все контейнеры, кроме tarantool-db-init.
Теперь откройте в браузере веб-интерфейс Tarantool DB по адресу http://localhost:8081.
Перейдите во вкладку Cluster и проверьте, что отсутствуют ошибки или предупреждения.
В течение нескольких секунд после старта кластер еще поднимается, так что могут появиться предупреждения.
В примере не используется шардирование, поэтому модуль
vshard не запущен.
После этого перейдите на вкладку Space Explorer и выберите любой узел, например, storage1.
Проверьте, что на узле есть спейс test.
Запуск приложения¶
Откройте вторую вкладку терминала.
В этой вкладке перейдите в директорию go_crud/go:
cd ./doc/examples/go_crud/go
Запустите Go-приложение:
go run -tags go_tarantool_ssl_disable main.go
Здесь:
go_tarantool_ssl_disable– опция, отключающая поддержку TLS. Так как для поддержки TLS требуется установленный OpenSSL 3.x, для простоты в примере поддержка TLS отключена.
Вывод после окончания работы приложения выглядит так:
Recorded via crud in batches of 10000 records in 147.229874ms
Rows verified
Необходимо убедиться, что в спейсе появились данные.