Перейти к основному содержимому
Версия: 2.0.x

SHOW EXPORT

SHOW EXPORT запрашивает информацию о выполнении задач экспорта, которые соответствуют указанным условиям.

Синтаксис​

SHOW EXPORT
[ FROM <db_name> ]
[
WHERE
    [ QUERYID = <query_id> ]
    [ STATE = { "PENDING" | "EXPORTING" | "FINISHED" | "CANCELLED" } ]
]
[ ORDER BY <field_name> [ ASC | DESC ] [, ... ] ]
[ LIMIT <count> ]

Параметры​

Этот оператор может содержать следующие опциональные предложения:

  • FROM

    Указывает имя базы данных, которую вы хотите запросить. Если вы не указываете предложение FROM, Selena запрашивает текущую базу данных.

  • WHERE

    Указывает условия, на основе которых вы хотите фильтровать задачи экспорта. Только задачи экспорта, соответствующие указанным условиям, возвращаются в результирующем наборе запроса.

    ParameterRequiredDescription
    QUERYIDNoID задачи экспорта, которую вы хотите запросить. Этот параметр используется для запроса информации о выполнении одной задачи экспорта.
    STATENoСтатус задач экспорта, которые вы хотите запросить. Допустимые значения:
    • PENDING: указывает запрос задач экспорта, ожидающих планирования.
    • EXPORTING: указывает запрос задач экспорта, которые выполняются.
    • FINISHED: указывает запрос задач экспорта, которые были успешно завершены.
    • CANCELLED: указывает запрос задач экспорта, которые завершились неудачей.

  • ORDER BY

    Указывает имя поля, на основе которого вы хотите отсортировать записи задач экспорта в результирующем наборе запроса. Вы можете указать несколько полей, которые должны быть разделены запятыми (,). Кроме того, вы можете использовать ключевое слово ASC или DESC, чтобы указать, что записи задач экспорта сортируются в порядке возрастания или убывания на основе указанного поля.

  • LIMIT

    Ограничивает результирующий набор запроса указанным максимальным количеством строк. Допустимые значения: положительное целое число. Если вы не указываете предложение LIMIT, Selena возвращает все задачи экспорта, соответствующие указанным условиям.

Возвращаемый результат​

Например, запросим информацию о выполнении задачи экспорта с ID edee47f0-abe1-11ec-b9d1-00163e1e238f:

SHOW EXPORT
WHERE QUERYID = "edee47f0-abe1-11ec-b9d1-00163e1e238f";

Возвращается следующая информация о выполнении:

     JobId: 14008
   QueryId: edee47f0-abe1-11ec-b9d1-00163e1e238f
     State: FINISHED
  Progress: 100%
  TaskInfo: {"partitions":["*"],"column separator":"\t","columns":["*"],"tablet num":10,"broker":"","coord num":1,"db":"db0","tbl":"tbl_simple","row delimiter":"\n","mem limit":2147483648}
      Path: hdfs://127.0.0.1:9000/users/230320/
CreateTime: 2023-03-20 11:16:14
 StartTime: 2023-03-20 11:16:17
FinishTime: 2023-03-20 11:16:26
   Timeout: 7200

Параметры в возвращаемом результате описаны следующим образом:

  • JobId: ID задачи экспорта.

  • QueryId: ID запроса.

  • State: статус задачи экспорта.

    Допустимые значения:

    • PENDING: Задача экспорта ожидает планирования.
    • EXPORTING: Задача экспорта выполняется.
    • FINISHED: Задача экспорта была успешно завершена.
    • CANCELLED: Задача экспорта завершилась неудачей.

  • Progress: прогресс задачи экспорта. Прогресс измеряется в единицах планов запросов. Предположим, что задача экспорта разделена на 10 планов запросов, и три из них завершены. В этом случае прогресс задачи экспорта составляет 30%.

  • TaskInfo: информация о задаче экспорта.

    Информация представляет собой объект JSON, состоящий из следующих ключей:

    • partitions: partitions, на которых находятся экспортированные данные. Если в качестве значения для этого ключа возвращается подстановочный знак (*), задача экспорта выполняется для экспорта данных из всех partitions.
    • column separator: разделитель столбцов, используемый в экспортированном файле данных.
    • columns: имена столбцов, данные которых экспортируются.
    • tablet num: общее количество tablets, которые экспортируются.
    • broker: В v1.5.2 и более ранних версиях это поле используется для возврата имени broker, который используется задачей экспорта. Начиная с v1.5.2, это поле возвращает пустую строку.
    • coord num: количество планов запросов, на которые разделена задача экспорта.
    • db: имя базы данных, к которой принадлежат экспортированные данные.
    • tbl: имя таблицы, к которой принадлежат экспортированные данные.
    • row delimiter: разделитель строк, используемый в экспортированном файле данных.
    • mem limit: максимальный объём памяти, разрешённый для задачи экспорта. Единица: bytes.

  • Path: путь, по которому экспортированные данные хранятся на удалённом хранилище.

  • CreateTime: время создания задачи экспорта.

  • StartTime: время, когда задача экспорта начала планироваться.

  • FinishTime: время завершения задачи экспорта.

  • Timeout: время, которое задача экспорта заняла больше ожидаемого. Единица: секунды. Время отсчитывается от CreateTime.

  • ErrorMsg: причина, по которой задача экспорта выдаёт ошибку. Это поле возвращается только когда задача экспорта сталкивается с ошибкой.

Примеры​

  • Запрос всех задач экспорта в текущей базе данных:

    SHOW EXPORT;

  • Запрос задачи экспорта с ID 921d8f80-7c9d-11eb-9342-acde48001122 в базе данных example_db:

    SHOW EXPORT FROM example_db
    WHERE queryid = "921d8f80-7c9d-11eb-9342-acde48001122";

  • Запрос задач экспорта, которые находятся в статусе EXPORTING в базе данных example_db, и указание сортировки записей задач экспорта в результирующем наборе по StartTime в порядке возрастания:

    SHOW EXPORT FROM example_db
    WHERE STATE = "exporting"
    ORDER BY StartTime ASC;

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

    SHOW EXPORT FROM example_db
    ORDER BY StartTime DESC;