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

SHOW EXPORT

デスクリプション​

このステートメントは、指定されたエクスポートジョブの実行状況を表示するために使用されます。

Syntax​

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

戻り値​

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への読み取りアクセスが必要です。

例​

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

    SHOW EXPORT;

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

```sql
 SHOW EXPORT FROM example_db ORDER BY StartTime DESC;
```

  • 指定されたdbに対して、状態が"exporting"であるエクスポートジョブを、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";