メインコンテンツまでスキップ
に最終更新

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>: 任意のパラメータです。表示するエクスポートジョブの ID を指定します。

3. <label>: 任意のパラメータです。表示するエクスポートジョブのラベルを指定します。

4. <column_name>: 任意のパラメータです。並べ替えに使用する列名を指定します。

5. <limit>: 任意のパラメータです。指定した場合は、一致するレコードを指定した件数だけ表示します。指定しない場合は、すべてのレコードを表示します。

返却結果​

列データ型説明
JobIdstringジョブの一意の ID
Labelstringエクスポートジョブのラベル。指定しない場合は、システムがデフォルトで生成します。
Statestringジョブの状態：
- PENDING：スケジュール待ち
- EXPORTING：データのエクスポート中
- FINISHED：ジョブ成功
- CANCELLED：ジョブ失敗
Progressstringジョブの進捗。この進捗はクエリプラン単位で測定されます。たとえば、スレッドが 10 個あり、そのうち 3 個が完了した場合、進捗は 30% です。
TaskInfojsonJSON 形式で表示されるジョブ情報：
- db：データベース名
- tbl：テーブル名
- 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 コマンドを実行するユーザーには、少なくとも次の権限が必要です。

権限対象説明
SELECT_PRIVデータベース（Database）データベースとテーブルに対する読み取りアクセス権が必要です。

例​

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

    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