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

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

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

    ПараметрОбязательныйОписание
    QUERYIDНетID задания экспорта, которое вы хотите запросить. Этот параметр используется для запроса информации о выполнении одного задания экспорта.
    STATEНетСтатус заданий экспорта, которые вы хотите запросить. Допустимые значения:
    • 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: разделы, в которых находятся экспортируемые данные. Если в качестве значения для этого ключа возвращается подстановочный знак (*), задание экспорта выполняется для экспорта данных из всех разделов.
    • column separator: разделитель столбцов, используемый в экспортируемом файле данных.
    • columns: имена столбцов, данные которых экспортируются.
    • tablet num: общее количество tablet, которые экспортируются.
    • broker: В версии 2.4 и более ранних это поле используется для возврата имени брокера, который используется заданием экспорта. Начиная с версии 1.5.0, это поле возвращает пустую строку.
    • coord num: количество планов запросов, на которые разделено задание экспорта.
    • db: имя базы данных, к которой принадлежат экспортируемые данные.
    • tbl: имя таблицы, к которой принадлежат экспортируемые данные.
    • row delimiter: разделитель строк, используемый в экспортируемом файле данных.
    • mem limit: максимальный объем памяти, разрешенный для задания экспорта. Единица: байты.

  • 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;