メインコンテンツまでスキップ
に最終更新

RECOVER

説明​

このステートメントは、以前に削除されたデータベース、テーブル、またはパーティションを復元するために使用します。

名前または ID を指定してメタデータを復元でき、復元したメタデータの名前を変更することもできます。

構文:​

RECOVER { DATABASE <db_name> [<db_id>] [AS <new_db_name>]
| TABLE [<db_name>.]<table_name> [<table_id>] [AS <new_table_name>]
| PARTITION <partition_name> [<partition_id>] FROM [<db_name>.]<table_name> [AS <new_partition_name>] }

必須パラメータ​

データベースを復元する

1. <db_name>

復元するデータベースの名前。

テーブルを復元する

1. <table_name>

復元するテーブルの名前。

パーティションを復元する

1. <partition_name>

復元するパーティションの名前。

2. <table_name>

パーティションが存在するテーブルの名前。

オプションパラメータ​

データベースを復元する

1. <db_id>

復元するデータベースの ID。

2. <new_db_name>

復元したデータベースの新しい名前。

テーブルを復元する

1. <db_name>

テーブルが存在するデータベースの名前。

2. <table_id>

復元するテーブルの ID。

3. <new_table_name>

復元したテーブルの新しい名前。

パーティションを復元する

1. <partition_id>

復元するパーティションの ID。

2. <db_name>

テーブルが存在するデータベースの名前。

3. <new_partition_name>

復元したパーティションの新しい名前。

アクセス制御要件​

権限オブジェクト備考
ADMIN_PRIV

使用上の注意​

  • この操作で復元できるのは、一定期間内に削除されたメタデータのみです。デフォルトは 1 日です(catalog_trash_expire_second パラメータは fe.conf で設定可能)。
  • メタデータの復元時に ID を指定しない場合、同じ名前で最後に削除されたメタデータがデフォルトで復元されます。
  • 現在復元可能なメタデータは SHOW CATALOG RECYCLE BIN を使用して照会できます。
  • 復元では、リサイクルビンにある既存のメタデータ、データ、レプリカが再アタッチされ、新しいデータ書き込みまたはレプリカ作成として扱われません。そのため、復元したオブジェクトによってデータベースの使用量がクォータを超えても、データクォータとレプリカクォータによって RECOVER がブロックされることはありません。以降のデータまたはレプリカを追加する操作には、引き続きクォータが適用されます。

例​

  1. example_db という名前のデータベースを復元する

    RECOVER DATABASE example_db;
  2. example_tbl という名前のテーブルを復元する

    RECOVER TABLE example_db.example_tbl;
  3. テーブル example_tbl から p1 という名前のパーティションを復元する

    RECOVER PARTITION p1 FROM example_tbl;
  4. ID が example_db_id で、名前が example_db のデータベースを復元する

    RECOVER DATABASE example_db example_db_id;
  5. ID が example_tbl_id で、名前が example_tbl のテーブルを復元する

    RECOVER TABLE example_db.example_tbl example_tbl_id;
  6. ID が p1_id で名前が p1 のパーティションを、テーブル example_tbl から復元する

    RECOVER PARTITION p1 p1_id FROM example_tbl;
  7. ID が example_db_id で名前が example_db のデータベースを復元し、new_example_db に名前を変更する

    RECOVER DATABASE example_db example_db_id AS new_example_db;
  8. example_tbl という名前のテーブルを復元し、new_example_tbl に名前を変更する

    RECOVER TABLE example_db.example_tbl AS new_example_tbl;
  9. ID が p1_id で名前が p1 のパーティションをテーブル example_tbl から復元し、new_p1 に名前を変更する

    RECOVER PARTITION p1 p1_id AS new_p1 FROM example_tbl;