Tarantool CE/EE Documentation portal logo
Помощь
Обновлена 15 сентября 2026 г. в 08:55

Подключение к экземпляру Tarantool

$ tt connect {URI|INSTANCE_NAME} [OPTION ...]

Команда tt connect устанавливает подключение к экземпляру Tarantool по его URI или имени экземпляра, указанному в текущем окружении.

Параметры

-u USERNAME, --username USERNAME

Пользователь Tarantool для подключения к экземпляру.

-p PASSWORD, --password PASSWORD

Пароль пользователя.

-f FILEPATH, --file FILEPATH

Подключение и выполнение скрипта из файла.

- - чтение скрипта из stdin.

-i, --interactive

Переход в интерактивный режим после выполнения скрипта, переданного в -f/--file.

-l LANGUAGE, --language LANGUAGE

Язык ввода интерактивной консоли tt: lua (по умолчанию) или sql.

-x FORMAT, --outputformat FORMAT

Формат вывода интерактивной консоли tt: yaml (по умолчанию), lua, table, ttable.

--sslcertfile FILEPATH

Путь к файлу SSL-сертификата для зашифрованных подключений.

--sslkeyfile FILEPATH

Путь к файлу закрытого SSL-ключа для зашифрованных подключений.

--sslcafile FILEPATH

Путь к файлу доверенных центров сертификации (CA) для зашифрованных подключений.

--sslciphers STRING

Список наборов шифров SSL, используемых для зашифрованных подключений, разделенный двоеточиями (:).

Подробности

Для подключения к экземпляру tt обычно требуется его URI – имя хоста или IP-адрес и порт.

Также можно подключаться к экземплярам в том же окружении tt (то есть использующим тот же файл конфигурации и установку Tarantool) по их именам.

Аутентификация

При подключении к экземпляру по URI tt connect устанавливает удаленное соединение, для которого требуется аутентификация. Используйте один из следующих способов передачи имени пользователя и пароля:

  • Параметры -u (--username) и -p (--password):

    $ tt connect 192.168.10.10:3301 -u myuser -p p4$$w0rD
  • Строка подключения:

    $ tt connect myuser:p4$$w0rD@192.168.10.10:3301
  • Переменные окружения TT_CLI_USERNAME и TT_CLI_PASSWORD:

    $ export TT_CLI_USERNAME=myuser$ export TT_CLI_PASSWORD=p4$$w0rD$ tt connect 192.168.10.10:3301

Если для удаленного подключения учетные данные не указаны, используется пользователь guest.

Зашифрованное подключение

Для подключения к экземплярам, использующим SSL-шифрование, укажите файлы SSL-сертификата и SSL-ключа в параметрах --sslcertfile и --sslkeyfile. При необходимости добавьте другие SSL-параметры – --sslcafile и --sslciphers.

Выполнение скрипта

По умолчанию команда tt connect открывает интерактивную консоль tt. Вместо этого можно открыть подключение для выполнения Lua-скрипта из файла или stdin. Для этого передайте путь к файлу в параметре -f (--file) или используйте -f -, чтобы взять скрипт из stdin.

$ tt connect app -f test.lua

Примеры

  • Подключение к экземпляру app в том же окружении:

    $ tt connect app
  • Подключение к экземпляру master приложения app в том же окружении:

    $ tt connect app:master
  • Подключение к хосту 192.168.10.10 на порту 3301 с аутентификацией:

    $ tt connect 192.168.10.10:3301 -u myuser -p p4$$w0rD
  • Подключение к экземпляру app и выполнение кода из файла test.lua:

    $ tt connect app -f test.lua
  • Подключение к экземпляру app и выполнение кода из stdin:

    $ echo "function test() return 1 end" | tt connect app -f - # Создание функции test()$ echo "test()" | tt connect app -f -                       # Вызов этой функции