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

戻り値

Column	DataType	Note
JobId	string	ジョブの一意のID
Label	string	エクスポートジョブのラベル。指定されない場合、システムがデフォルトで生成します。
State	string	ジョブステータス: - PENDING: スケジューリング待ちのジョブ - EXPORTING: データエクスポート中 - FINISHED: ジョブ成功 - CANCELLED: ジョブ失敗
Progress	string	ジョブの進捗。この進捗はクエリプランの単位で測定されます。例えば、10のスレッドがあり、3つが完了した場合、進捗は30%です。
TaskInfo	json	JSON形式で表示されるジョブ情報: - db: データベース名 - tbl: テーブル名 - partitions: エクスポート用に指定されたパーティション、emptyリストはすべてのパーティションを意味します - column_separator: エクスポートファイルのカラム区切り文字 - line_delimiter: エクスポートファイルの行区切り文字 - tablet num: 関連するtabletの総数 - broker: 使用されるbrokerの名前 - coord num: クエリプランの数 - max_file_size: エクスポートファイルの最大サイズ - delete_existing_files: エクスポートディレクトリ内の既存のファイルとディレクトリを削除するかどうか - columns: エクスポートするカラム、空の値はすべてのカラムをエクスポートすることを意味します - format: エクスポートのファイル形式
Path	string	リモートストレージ上のエクスポートパス
CreateTime	string	ジョブ作成時刻
StartTime	string	ジョブ開始時刻
FinishTime	string	ジョブ完了時刻
Timeout	int	ジョブタイムアウト（秒単位）。時間はCreateTimeから計算されます。
ErrorMsg	string	ジョブでエラーが発生した場合、エラー理由がここに表示されます。
OutfileInfo	string	エクスポートジョブが成功した場合、具体的なSELECT INTO OUTFILEの結果情報がここに表示されます。

アクセス制御要件

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

Privilege	Object	Notes
SELECT_PRIV	Database (Database)	データベースとテーブルへの読み取りアクセスが必要です。

例

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

  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のエクスポートジョブを表示する

```sql
  SHOW EXPORT FROM example_db WHERE ID = job_id;
```

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

   SHOW EXPORT FROM example_db WHERE LABEL = "mylabel";