メインコンテンツまでスキップ
バージョン: 26.x

SHOW EXPORT

説明​

このステートメントは、指定された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> ];

Optional パラメータ​

1. <db_name>: オプション パラメータ。指定されない場合は、現在のデフォルト データベースが使用されます。

2. <job_id>: オプション パラメータ。表示するエクスポート ジョブ ID を指定するために使用されます。

3. <label>: オプション パラメータ。表示するエクスポート ジョブのラベルを指定するために使用されます。

4. <column_name>: オプション パラメータ。ソート用の列名を指定するために使用されます。

5. <limit>: オプション パラメータ。指定された場合、指定された数の一致するレコードのみが表示されます。指定されない場合は、すべてのレコードが表示されます。

戻り値​

ColumnDataTypeNote
JobIdstringジョブの一意ID
Labelstringエクスポート ジョブのラベル。指定されない場合、システムがデフォルトで生成します。
Statestringジョブ ステータス:
- PENDING: スケジューリング待ちのジョブ
- EXPORTING: データ エクスポート中
- FINISHED: ジョブ成功
- CANCELLED: ジョブ失敗
Progressstringジョブの進行状況。この進行状況はクエリ プラン単位で測定されます。例えば、10個のスレッドがあり3個が完了している場合、進行状況は30%です。
TaskInfojsonJSON形式で表示されるジョブ情報:
- db: データベース名
- tbl: Table名
- partitions: エクスポート用に指定されたパーティション、emptyリストは全パーティションを意味します
- column_separator: エクスポート ファイルの列区切り文字
- line_delimiter: エクスポート ファイルの行区切り文字
- tablet num: 関与するタブレットの総数
- broker: 使用されるbrokerの名前
- coord num: クエリ プランの数
- max_file_size: エクスポート ファイルの最大サイズ
- delete_existing_files: エクスポート ディレクトリ内の既存ファイルとディレクトリを削除するかどうか
- columns: エクスポートする列、空の値は全列をエクスポートすることを意味します
- format: エクスポートのファイル形式
Pathstringリモート ストレージ上のエクスポート パス
CreateTimestringジョブ作成時刻
StartTimestringジョブ開始時刻
FinishTimestringジョブ完了時刻
Timeoutintジョブ タイムアウト（秒単位）。時間はCreateTimeから計算されます。
ErrorMsgstringジョブでエラーが発生した場合、エラー理由がここに表示されます。
OutfileInfostringエクスポート ジョブが成功した場合、具体的なSELECT INTO OUTFILEの結果情報がここに表示されます。

アクセス制御要件​

このSQLコマンドを実行するユーザーは、少なくとも以下の権限を持つ必要があります：

PrivilegeObject注釈
SELECT_PRIVDatabase (Database)データベースとTableへの読み取りアクセスが必要です。

例​

  • デフォルト データベースのすべてのエクスポート ジョブを表示

    SHOW EXPORT;

  • 指定されたdbのエクスポートジョブをStartTimeの降順で表示する

     SHOW EXPORT FROM example_db ORDER BY StartTime DESC;

  • 状態が"exporting"である指定されたdbのエクスポートジョブを、StartTimeの降順で表示する

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

  • 指定されたdbとjob_idのエクスポートジョブを表示する

      SHOW EXPORT FROM example_db WHERE ID = job_id;

  • 指定されたdbとlabelのエクスポートジョブを表示する

     SHOW EXPORT FROM example_db WHERE LABEL = "mylabel";