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

BACKUP

説明​

指定されたデータベース、テーブル、またはパーティションのデータをバックアップします。現在、StarRocks は OLAP テーブルのデータのみをバックアップすることをサポートしています。詳細については、 data backup and restoration を参照してください。

BACKUP は非同期操作です。 SHOW BACKUP を使用して BACKUP ジョブのステータスを確認したり、 CANCEL BACKUP を使用して BACKUP ジョブをキャンセルしたりできます。 SHOW SNAPSHOT を使用してスナップショット情報を表示できます。

注意

  • ADMIN 権限を持つユーザーのみがデータをバックアップできます。
  • 各データベースでは、一度に実行中の BACKUP または RESTORE ジョブは 1 つだけ許可されます。それ以外の場合、StarRocks はエラーを返します。
  • StarRocks はデータバックアップのためのデータ圧縮アルゴリズムの指定をサポートしていません。

構文​

BACKUP SNAPSHOT <db_name>.<snapshot_name>
TO <repository_name>
[ ON ( <table_name> [ PARTITION ( <partition_name> [, ...] ) ]
       [, ...] ) ]
[ PROPERTIES ("key"="value" [, ...] ) ]

パラメータ​

パラメータ説明
db_nameバックアップするデータを格納するデータベースの名前。
snapshot_nameデータスナップショットの名前を指定します。グローバルに一意です。
repository_nameリポジトリ名。 CREATE REPOSITORY を使用してリポジトリを作成できます。
ONバックアップするテーブルの名前。このパラメータが指定されていない場合、データベース全体がバックアップされます。
PARTITIONバックアップするパーティションの名前。このパラメータが指定されていない場合、テーブル全体がバックアップされます。
PROPERTIESデータスナップショットのプロパティ。有効なキー:type: バックアップの種類。現在、完全バックアップ FULL のみがサポートされています。デフォルト: FULL。timeout: タスクのタイムアウト。単位: 秒。デフォルト: 86400。

例​

例 1: データベース example_db をリポジトリ example_repo にバックアップします。

BACKUP SNAPSHOT example_db.snapshot_label1
TO example_repo
PROPERTIES ("type" = "full");

例 2: example_db のテーブル example_tbl を example_repo にバックアップします。

BACKUP SNAPSHOT example_db.snapshot_label2
TO example_repo
ON (example_tbl);

例 3: example_db の example_tbl のパーティション p1 と p2 およびテーブル example_tbl2 を example_repo にバックアップします。

BACKUP SNAPSHOT example_db.snapshot_label3
TO example_repo
ON(
    example_tbl PARTITION (p1, p2),
    example_tbl2
);

使用上の注意​

  • グローバル、データベース、テーブル、およびパーティションレベルでのバックアップおよびリストア操作には異なる権限が必要です。
  • 各データベースでは、一度に実行中の BACKUP または RESTORE ジョブは 1 つだけ許可されます。それ以外の場合、StarRocks はエラーを返します。
  • BACKUP および RESTORE ジョブは StarRocks クラスターの多くのリソースを占有するため、StarRocks クラスターが高負荷でないときにデータをバックアップおよびリストアすることができます。
  • StarRocks はデータバックアップのためのデータ圧縮アルゴリズムの指定をサポートしていません。
  • データはスナップショットとしてバックアップされるため、スナップショット生成時にロードされたデータはスナップショットに含まれません。そのため、スナップショットが生成された後、RESTORE ジョブが完了する前に古いクラスターにデータをロードした場合、データがリストアされるクラスターにもデータをロードする必要があります。データ移行が完了した後、データとサービスの正確性を確認した後にアプリケーションを新しいクラスターに移行することをお勧めします。
  • RESTORE ジョブが完了する前に、リストアされるテーブルを操作することはできません。
  • 主キーテーブルは v2.5 より前の StarRocks クラスターにリストアすることはできません。
  • リストアするテーブルを新しいクラスターにリストアする前に作成する必要はありません。RESTORE ジョブが自動的に作成します。
  • リストアされるテーブルと重複する名前を持つ既存のテーブルがある場合、StarRocks はまず既存のテーブルのスキーマがリストアされるテーブルのスキーマと一致するかどうかを確認します。スキーマが一致する場合、StarRocks はスナップショット内のデータで既存のテーブルを上書きします。スキーマが一致しない場合、RESTORE ジョブは失敗します。AS キーワードを使用してリストアされるテーブルの名前を変更するか、データをリストアする前に既存のテーブルを削除することができます。
  • RESTORE ジョブが既存のデータベース、テーブル、またはパーティションを上書きする場合、ジョブが COMMIT フェーズに入った後に上書きされたデータをリストアすることはできません。この時点で RESTORE ジョブが失敗またはキャンセルされた場合、データが破損しアクセスできなくなる可能性があります。この場合、RESTORE 操作を再度実行し、ジョブが完了するのを待つしかありません。そのため、現在のデータがもはや使用されていないことが確実でない限り、上書きによるデータのリストアはお勧めしません。上書き操作はまずスナップショットと既存のデータベース、テーブル、またはパーティション間のメタデータの整合性をチェックします。不整合が検出された場合、RESTORE 操作は実行できません。
  • 現在、StarRocks はビューのバックアップおよびリストアをサポートしていません。
  • 現在、StarRocks はユーザーアカウント、権限、およびリソースグループに関連する設定データのバックアップおよびリストアをサポートしていません。
  • 現在、StarRocks はテーブル間の Colocate Join 関係のバックアップおよびリストアをサポートしていません。