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

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

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

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

Содержание:

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

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

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

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

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

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

• 2379
• 3301--3303
• 8081

Перейдите в директорию примера go_directly:

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

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

• кластера 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. После применения настроек кластер будет выглядеть так:

Нажмите на набор реплик storage-1, чтобы просмотреть экземпляры в нем. Обратите внимание, что все экземпляры кластера в этом наборе реплик являются лидерами. Это означает, что набор реплик работает в режиме мультимастер.

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

 
box.space

Спейс 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 появились данные. Для этого в веб-интерфейсе TCM в окне выбранного узла нажмите на кнопку вызова меню ... (Actions):

В выпадающем меню выберите пункт Explorer. Здесь приведены список спейсов всех типов, которые есть на данном экземпляре кластера, включая нешардированные спейсы. В открывшемся списке выберите спейс test. Убедитесь, что спейс содержит данные.

Проверьте этот спейс на других узлах и убедитесь, что репликация работает исправно.

Для остановки стенда:

• В первом терминале выполните команду:

   
  make stop

• Во втором терминале выполните команду Ctrl + Z.