Перейти к содержимому
Последнее обновление

ADMIN COPY TABLET

Описание​

Эта инструкция используется для создания снимка указанного tablet, главным образом для его локальной загрузки с целью воспроизведения проблемы.

Синтаксис​

ADMIN COPY TABLET <tablet_id> PROPERTIES ("<key>"="<value>" [,...]).

Обязательные параметры​

1. <tablet_id>

Идентификатор tablet, который нужно скопировать.

Необязательные параметры​

[ PROPERTIES ("<key>"="<value>" [, ... ]) ]

Предложение PROPERTIES позволяет задать дополнительные параметры:

1. <backend_id>

Задаёт идентификатор узла BE, на котором находится реплика. Если параметр не указан, реплика выбирается случайным образом.

2. <version>

Задаёт версию снимка. Версия должна быть меньше или равна наибольшей версии реплики. Если параметр не указан, используется наибольшая версия.

3. <expiration_minutes>

Время хранения снимка. По умолчанию: 1 час. По истечении этого времени снимок автоматически удаляется. Единица измерения: минуты.

Возвращаемое значение​

СтолбецТип данныхПримечание
TabletIdstringИдентификатор tablet, для которого создан снимок.
BackendIdstringИдентификатор узла BE, на котором хранится снимок.
IpstringIP-адрес узла BE, на котором хранится снимок.
PathstringПуть к месту хранения снимка на узле BE.
ExpirationMinutesstringВремя в минутах, по истечении которого снимок будет автоматически удалён.
CreateTableStmtstringИнструкция создания таблицы, соответствующей tablet. Это не исходная инструкция создания таблицы, а её упрощённый вариант для последующей локальной загрузки tablet.

Требования к управлению доступом​

Пользователь, выполняющий эту команду SQL, должен обладать как минимум следующими привилегиями:

ПривилегияОбъектПримечания
Admin_privБаза данныхТребуется для выполнения административных операций с базой данных, включая управление таблицами и разделами, а также выполнение команд системного уровня.

Примеры​

  • Создание снимка реплики на указанном узле BE

    ADMIN COPY TABLET 10020 PROPERTIES("backend_id" = "10003");
             TabletId: 10020
            BackendId: 10003
                   Ip: 192.168.10.1
                 Path: /path/to/be/storage/snapshot/20220830101353.2.3600
    ExpirationMinutes: 60
      CreateTableStmt: CREATE TABLE `tbl1` (
      `k1` int(11) NULL,
      `k2` int(11) NULL
    ) ENGINE=OLAP
    DUPLICATE KEY(`k1`, `k2`)
    DISTRIBUTED BY HASH(k1) BUCKETS 1
    PROPERTIES (
    "replication_num" = "1",
    "version_info" = "2"
    );

  • Создание снимка указанной версии реплики на указанном узле BE

    ADMIN COPY TABLET 10010 PROPERTIES("backend_id" = "10003", "version" = "10");
             TabletId: 10010
            BackendId: 10003
                   Ip: 192.168.10.1
                 Path: /path/to/be/storage/snapshot/20220830101353.2.3600
    ExpirationMinutes: 60
      CreateTableStmt: CREATE TABLE `tbl1` (
      `k1` int(11) NULL,
      `k2` int(11) NULL
    ) ENGINE=OLAP
    DUPLICATE KEY(`k1`, `k2`)
    DISTRIBUTED BY HASH(k1) BUCKETS 1
    PROPERTIES (
    "replication_num" = "1",
    "version_info" = "2"
    );
Report issue