メインコンテンツまでスキップ

SHOW EXPORT

SHOW EXPORT

概要​

指定された条件を満たすエクスポートジョブの実行情報をクエリします。

構文​

SHOW EXPORT
[ FROM <db_name> ]
[
WHERE
    [ QUERYID = <query_id> ]
    [ STATE = { "PENDING" | "EXPORTING" | "FINISHED" | "CANCELLED" } ]
]
[ ORDER BY <field_name> [ ASC | DESC ] [, ... ] ]
[ LIMIT <count> ]

パラメータ​

このステートメントは以下のオプションの句を含むことができます。

  • FROMクエリしたいデータベースの名前を指定します。FROM句を指定しない場合、StarRocksは現在のデータベースをクエリします。

  • WHEREエクスポートジョブをフィルタリングするための条件を指定します。指定した条件を満たすエクスポートジョブだけがクエリ結果のレコードセットに返されます。

    パラメータ

    必須

    説明

    QUERYID

    いいえ

    クエリするエクスポートジョブのIDです。このパラメータは、単一のエクスポートジョブの実行情報をクエリするために使用されます。

    STATE

    いいえ

    クエリしたいエクスポートジョブのステータスです。有効な値:

    • PENDING：スケジュール待ちのエクスポートジョブをクエリします。

    • EXPORTING：実行中のエクスポートジョブをクエリします。

    • FINISHED：正常に完了したエクスポートジョブをクエリします。

    • CANCELLED：失敗したエクスポートジョブをクエリします。

  • ORDER BYクエリ結果のエクスポートジョブのレコードを指定したフィールドでソートするためのフィールドの名前を指定します。複数のフィールドを指定する場合は、カンマ（,）で区切る必要があります。さらに、ASCまたはDESCキーワードを使用して、指定したフィールドを基準にエクスポートジョブのレコードを昇順または降順でソートできます。

  • LIMITクエリの結果セットを指定した最大行数に制限します。有効な値: 正の整数。LIMIT句を指定しない場合、StarRocksは指定した条件を満たすすべてのエクスポートジョブを返します。

結果​

例えば、IDがedee47f0-abe1-11ec-b9d1-00163e1e238fのエクスポートジョブの実行情報をクエリします：

SHOW EXPORT
WHERE QUERYID = "edee47f0-abe1-11ec-b9d1-00163e1e238f";

以下の実行情報が返されます：

     JobId: 14008
   QueryId: edee47f0-abe1-11ec-b9d1-00163e1e238f
     State: FINISHED
  Progress: 100%
  TaskInfo: {"partitions":["*"],"column separator":"\t","columns":["*"],"tablet num":10,"broker":"","coord num":1,"db":"db0","tbl":"tbl_simple","row delimiter":"\n","mem limit":2147483648}
      Path: hdfs://127.0.0.1:9000/users/230320/
CreateTime: 2023-03-20 11:16:14
 StartTime: 2023-03-20 11:16:17
FinishTime: 2023-03-20 11:16:26
   Timeout: 7200

返される結果のパラメータは以下のように説明されます：

  • JobId: エクスポートジョブのIDです。
  • QueryId: クエリのIDです。
  • State: エクスポートジョブのステータスです。有効な値:
    • PENDING: エクスポートジョブはスケジュール待ちです。
    • EXPORTING: エクスポートジョブは実行中です。
    • FINISHED: エクスポートジョブは正常に完了しました。
    • CANCELLED: エクスポートジョブは失敗しました。
  • Progress: エクスポートジョブの進捗状況です。進捗はクエリプランの単位で測定されます。エクスポートジョブが10のクエリプランに分割され、そのうちの3つが完了した場合、エクスポートジョブの進捗は30%です。詳細については、「"EXPORT > ワークフローを使用したデータのエクスポート"」を参照してください。
  • TaskInfo: エクスポートジョブの情報です。この情報は、次のキーからなるJSONオブジェクトで構成されています：
    • partitions: エクスポートデータがあるパーティション。このキーの値としてワイルドカード（*）が返された場合、エクスポートジョブはすべてのパーティションからデータをエクスポートするために実行されます。
    • column separator: エクスポートされたデータファイルで使用される列の区切り文字。
    • columns: エクスポートされるデータのカラムの名前。
    • tablet num: エクスポートされるトータルのタブレット数。
    • broker: v2.4以前では、このフィールドはエクスポートジョブで使用されるブローカーの名前を返すために使用されます。v2.5以降では、このフィールドは空の文字列を返します。詳細については、「"EXPORT > バックグラウンド情報を使用したデータのエクスポート"」を参照してください。
    • coord num: エクスポートジョブが分割されるクエリプランの数。
    • db: エクスポートされるデータが所属するデータベースの名前。
    • tbl: エクスポートされるデータが所属するテーブルの名前。
    • row delimiter: エクスポートされたデータファイルで使用される行の区切り文字。
    • mem limit: エクスポートジョブに許可される最大メモリ量。単位: バイト。
  • Path: エクスポートされたデータがリモートストレージ上に保存されているパスです。
  • CreateTime: エクスポートジョブが作成された時刻。
  • StartTime: エクスポートジョブがスケジュールされる開始時刻。
  • FinishTime: エクスポートジョブが終了した時刻。
  • Timeout: エクスポートジョブが予想よりもかかった時間。単位: 秒。時間はCreateTimeからカウントされます。
  • ErrorMsg: エクスポートジョブがエラーをスローする理由です。このフィールドは、エクスポートジョブがエラーに遭遇した場合にのみ返されます。

例​

  • 現在のデータベースのすべてのエクスポートジョブをクエリします：

    SHOW EXPORT;

  • データベースexample_db内のIDが921d8f80-7c9d-11eb-9342-acde48001122のエクスポートジョブをクエリします：

    SHOW EXPORT FROM example_db
    WHERE queryid = "921d8f80-7c9d-11eb-9342-acde48001122";

  • データベースexample_db内のEXPORTINGステータスのエクスポートジョブをクエリし、結果セットのエクスポートジョブのレコードをStartTimeで昇順にソートします：

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

  • データベースexample_db内のすべてのエクスポートジョブをクエリし、結果セットのエクスポートジョブのレコードをStartTimeで降順にソートします：

    SHOW EXPORT FROM example_db
    ORDER BY StartTime DESC;