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

Воспроизведение содержимого файлов .snap и .xlog на экземпляре Tarantool

$ tt play URI FILE ... [OPTION ...]

Команда tt play воспроизводит содержимое файлов снимков (.snap) и WAL (.xlog) на другом экземпляре Tarantool. Один вызов tt play может воспроизвести несколько файлов.

Параметры

-u USERNAME, --username USERNAME

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

-p PASSWORD, --password PASSWORD

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

--from LSN

Воспроизвести операции, начиная с указанного LSN.

--to LSN

Воспроизвести операции до указанного LSN. По умолчанию 18446744073709551615.

--replica ID

Фильтрация операций по ID реплики. Может передаваться несколько раз.

При вызове tt play с фильтрами по LSN (флаги --from и --to) и ID реплики (--replica) учитывайте, что LSN различаются между репликами. Поэтому при передаче более одного ID реплики через --from или --to результат может не отражать фактическую последовательность операций.

--space ID

Фильтрация вывода по ID спейса. Может передаваться несколько раз.

--show-system

Показать операции над системными спейсами.

Подробности

Команда tt play воспроизводит операции из файлов .xlog и .snap на целевом экземпляре по одной. Все изменения данных происходят так же, как если бы они были выполнены на этом экземпляре. Это означает, что:

  • Все затронутые спейсы должны существовать на целевом экземпляре. Они должны иметь ту же структуру и space_id, что и на экземпляре, создавшем файл снимка или WAL.

    Для воспроизведения снимка или WAL на чистом экземпляре добавьте флаг --show-system, чтобы включить операции над системными спейсами. С этим флагом tt воспроизводит операции, создающие и настраивающие пользовательские спейсы.

  • LSN операций изменяются, если не воспроизводятся все операции, выполненные с момента запуска экземпляра.

  • ID реплик изменяются в соответствии с конфигурацией целевого экземпляра.

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

Для передачи имени пользователя и пароля при подключении к экземпляру используйте один из следующих способов:

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

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

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

    $ export TT_CLI_USERNAME=myuser$ export TT_CLI_PASSWORD=p4$$w0rD$ tt play 192.168.10.10:3301 00000000000000000000.xlog

Примеры

  • Воспроизведение содержимого файла 00000000000000000000.xlog на экземпляре 192.168.10.10:3301:

    $ tt play 192.168.10.10:3301 00000000000000000000.xlog
  • Воспроизведение операций над спейсами с space_id 512 и 513 из файла снимка 00000000000000000012.snap:

    $ tt play 192.168.10.10:3301 00000000000000000012.snap --space 512 --space 513
  • Воспроизведение содержимого файла 00000000000000000000.xlog, включая операции над системными спейсами:

    $ tt play 192.168.10.10:3301 00000000000000000000.xlog --show-system