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: Table名 - partitions: エクスポート対象の指定パーティション、emptyリストは全パーティションを意味します - column_separator: エクスポートファイルのカラム区切り文字 - line_delimiter: エクスポートファイルの行区切り文字 - tablet num: 関与するタブレットの総数 - 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	注釈
SELECT_PRIV	Database (Database)	データベースとTableへの読み取りアクセスが必要です。

例

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

```sql
 SHOW EXPORT FROM example_db WHERE LABEL = "mylabel";
```