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

バックアップ

説明​

このステートメントは、指定されたデータベース下のデータをバックアップするために使用されます。このコマンドは非同期操作です。送信が成功した後、SHOW BACKUPコマンドを通じて進行状況を確認する必要があります。

構文​

BACKUP SNAPSHOT [<db_name>.]<snapshot_name>
TO `<repository_name>`
[ { ON | EXCLUDE } ]
    ( <table_name> [ PARTITION ( <partition_name> [, ...] ) ]
    [, ...] ) ]

[ PROPERTIES ( "<key>" = "<value>" [ , ... ] )]

必須パラメータ​

1.<db_name>

バックアップ対象データが属するデータベースの名前。

2.<snapshot_name>

データスナップショット名を指定します。スナップショット名は重複できず、グローバルで一意である必要があります。

3.<repository_name>

ウェアハウス名。CREATE REPOSITORYでリポジトリを作成できます。

オプションパラメータ​

1.<table_name>

バックアップ対象のテーブル名。指定されていない場合、データベース全体がバックアップされます。

  • ON句は、バックアップが必要なテーブルとパーティションを識別します。パーティションが指定されていない場合、デフォルトでテーブルのすべてのパーティションがバックアップされます
  • バックアップが不要なテーブルとパーティションはEXCLUDE句で識別されます。指定されたテーブルまたはパーティションを除く、このデータベース内のすべてのテーブルのすべてのパーティションデータをバックアップします。

2.<partition_name>

バックアップ対象のパーティション名。指定されていない場合、対応するテーブルのすべてのパーティションがバックアップされます。

3.[ PROPERTIES ( "<key>" = "<value>" [ , ... ] ) ]

データスナップショット属性、形式：<key> = <value>、現在以下のプロパティをサポートしています：

  • "type" = "full"：これがフル更新であることを示します（デフォルト）
  • "timeout" = "3600"：タスクのタイムアウト期間、デフォルトは1日。秒単位。

アクセス制御要件​

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

権限オブジェクト備考
LOAD_PRIVUSER or ROLEこの操作は、LOAD_PRIV権限を持つユーザーまたはロールのみが実行できます

使用上の注意​

  • OLAPタイプのテーブルのバックアップのみサポートされています。
  • 同じデータベース下では1つのバックアップ操作のみ実行できます。
  • バックアップ操作は、指定されたテーブルまたはパーティションの基本テーブルと同期マテリアライズドビューをバックアップし、1つのレプリカのみがバックアップされます。非同期マテリアライズドビューはサポートされていません。
  • バックアップ操作の効率性：バックアップ操作の効率性は、データ量、Compute Nodeの数、ファイル数に依存します。バックアップデータシャードが配置されている各Compute Nodeは、バックアップ操作のアップロード段階に参加します。ノード数が多いほど、アップロード効率が高くなります。ファイルデータ量は、シャード数と各シャード内のファイル数のみを指します。シャードが多い場合、またはシャード内に小さなファイルが多い場合、バックアップ操作時間が増加する可能性があります。

例​

  1. example_db下のテーブルexample_tblをウェアハウスexample_repoに完全バックアップ：
BACKUP SNAPSHOT example_db.snapshot_label1
TO example_repo
ON (example_tbl)
PROPERTIES ("type" = "full");
  1. フルバックアップの下で、example_db、テーブル example_tbl の p1、p2 パーティション、およびテーブル example_tbl2 をウェアハウス example_repo に：
BACKUP SNAPSHOT example_db.snapshot_label2
TO example_repo
ON
(
    example_tbl PARTITION (p1,p2),
    example_tbl2
);
  1. example_db下のテーブルexample_tblを除く全テーブルのフルバックアップをwarehouse example_repoに実行:
BACKUP SNAPSHOT example_db.snapshot_label3
TO example_repo
EXCLUDE (example_tbl);
  1. example_db配下のテーブルを完全にリポジトリexample_repoにバックアップする：
BACKUP SNAPSHOT example_db.snapshot_label3
TO example_repo;