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

SHOW EXPORT

Описание​

Эта инструкция используется для просмотра состояния выполнения указанного задания экспорта.

Синтаксис​

SHOW EXPORT
[ FROM <db_name> ]
  [
    WHERE
      [ ID = <job_id> ]
      [ STATE = { "PENDING" | "EXPORTING" | "FINISHED" | "CANCELLED" } ]
      [ LABEL = <label> ]
   ]
[ ORDER BY <column_name> [ ASC | DESC ] [, column_name [ ASC | DESC ] ... ] ]
[ LIMIT <limit> ];

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

1. <db_name>: Необязательный параметр. Если не указан, используется текущая база данных по умолчанию.

2. <job_id>: Необязательный параметр. Задаёт идентификатор задания экспорта, которое нужно отобразить.

3. <label>: Необязательный параметр. Задаёт метку задания экспорта, которое нужно отобразить.

4. <column_name>: Необязательный параметр. Задаёт имя столбца для сортировки.

5. <limit>: Необязательный параметр. Если указан, отображается только заданное количество подходящих записей; если не указан, отображаются все записи.

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

СтолбецТип данныхОписание
JobIdstringУникальный идентификатор задания
LabelstringМетка задания экспорта. Если не указана, система генерирует её по умолчанию.
StatestringСостояние задания:
- PENDING: Задание ожидает запуска планировщиком
- EXPORTING: Выполняется экспорт данных
- FINISHED: Задание успешно выполнено
- CANCELLED: Задание завершилось с ошибкой
ProgressstringПрогресс задания, измеряемый по числу выполненных планов запросов. Например, если из 10 потоков завершены 3, прогресс составляет 30%.
TaskInfojsonИнформация о задании в формате JSON:
- db: Имя базы данных
- tbl: Имя таблицы
- partitions: Разделы, указанные для экспорта; пустой (empty) список означает все разделы
- column_separator: Разделитель столбцов в экспортируемом файле
- line_delimiter: Разделитель строк в экспортируемом файле
- tablet num: Общее количество задействованных tablet
- broker: Имя используемого брокера
- coord num: Количество планов запросов
- max_file_size: Максимальный размер экспортируемого файла
- delete_existing_files: Нужно ли удалять существующие файлы и каталоги в каталоге экспорта
- columns: Столбцы для экспорта; пустое значение означает экспорт всех столбцов
- format: Формат экспортируемого файла
PathstringПуть экспорта в удалённом хранилище
CreateTimestringВремя создания задания
StartTimestringВремя начала выполнения задания
FinishTimestringВремя завершения задания
TimeoutintВремя ожидания выполнения задания (в секундах). Отсчитывается от CreateTime.
ErrorMsgstringЕсли при выполнении задания возникает ошибка, здесь отображается её причина.
OutfileInfostringЕсли задание экспорта выполнено успешно, здесь отображается подробная информация о результате SELECT INTO OUTFILE.

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

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

ПравоОбъектПримечания
SELECT_PRIVБаза данных (база данных)Требуется доступ на чтение к базе данных и таблице.

Примеры​

  • Показать все задания экспорта для базы данных по умолчанию

    SHOW EXPORT;

  • Показать задания экспорта для указанной базы данных, отсортированные по StartTime в порядке убывания

     SHOW EXPORT FROM example_db ORDER BY StartTime DESC;

  • Показать задания экспорта для указанной базы данных в состоянии "exporting", отсортированные по StartTime в порядке убывания

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

  • Показать задание экспорта для указанной базы данных с указанным job_id

      SHOW EXPORT FROM example_db WHERE ID = job_id;

  • Показать задание экспорта для указанной базы данных с указанной меткой

     SHOW EXPORT FROM example_db WHERE LABEL = "mylabel";
Report issue