復元リソースの使用

このドキュメントのtidbcloud_restoreリソースを使用して復元タスクを管理する方法を学習できます。

tidbcloud_restoreリソースの特徴は次のとおりです。

• バックアップに従って、TiDB 専用クラスターの復元タスクを作成します。

前提条件

• TiDB Cloud Terraform プロバイダーを入手する 。
• バックアップおよび復元機能は、TiDB サーバーレス クラスターでは使用できません。復元リソースを使用するには、TiDB 専用クラスターを作成していることを確認してください。

復元タスクを作成する

クラスターのバックアップを作成した後、 tidbcloud_restoreリソースを使用して復元タスクを作成することでクラスターを復元できます。

注記：

より小さいノード サイズから同じまたはより大きいノード サイズにのみデータを復元できます。

1. 復元用のディレクトリを作成して入力します。

2. restore.tfファイルを作成します。

   例えば：

   terraform {
    required_providers {
      tidbcloud = {
        source = "tidbcloud/tidbcloud"
      }
    }
   }
   
   provider "tidbcloud" {
    public_key = "your_public_key"
    private_key = "your_private_key"
   }
   resource "tidbcloud_restore" "example_restore" {
     project_id = tidbcloud_cluster.example_cluster.project_id
     backup_id  = tidbcloud_backup.example_backup.id
     name       = "restoreCluster"
     config = {
       root_password = "Your_root_password1."
       port          = 4000
       components = {
         tidb = {
           node_size : "8C16G"
           node_quantity : 2
         }
         tikv = {
           node_size : "8C32G"
           storage_size_gib : 500
           node_quantity : 6
         }
         tiflash = {
           node_size : "8C64G"
           storage_size_gib : 500
           node_quantity : 2
         }
       }
     }
   }
   

3. terraform applyコマンドを実行し、確認のためにyesを入力します。

   $ terraform apply
   tidbcloud_cluster.example_cluster: Refreshing state... [id=1379661944630234067]
   tidbcloud_backup.example_backup: Refreshing state... [id=1350048]
   
   Terraform used the selected providers to generate the following execution plan. Resource actions are indicated with the following symbols:
     + create
   
   Terraform will perform the following actions:
   
     # tidbcloud_restore.example_restore will be created
     + resource "tidbcloud_restore" "example_restore" {
         + backup_id        = "1350048"
         + cluster          = {
             + id     = (known after apply)
             + name   = (known after apply)
             + status = (known after apply)
           }
         + cluster_id       = (known after apply)
         + config           = {
             + components    = {
                 + tidb    = {
                     + node_quantity = 2
                     + node_size     = "8C16G"
                   }
                 + tiflash = {
                     + node_quantity    = 2
                     + node_size        = "8C64G"
                     + storage_size_gib = 500
                   }
                 + tikv    = {
                     + node_quantity    = 6
                     + node_size        = "8C32G"
                     + storage_size_gib = 500
                   }
               }
             + port          = 4000
             + root_password = "Your_root_password1."
           }
         + create_timestamp = (known after apply)
         + error_message    = (known after apply)
         + id               = (known after apply)
         + name             = "restoreCluster"
         + project_id       = "1372813089189561287"
         + status           = (known after apply)
       }
   
   Plan: 1 to add, 0 to change, 0 to destroy.
   
   Do you want to perform these actions?
     Terraform will perform the actions described above.
     Only 'yes' will be accepted to approve.
   
     Enter a value: yes
   
   tidbcloud_restore.example_restore: Creating...
   tidbcloud_restore.example_restore: Creation complete after 1s [id=780114]
   
   Apply complete! Resources: 1 added, 0 changed, 0 destroyed.
   

4. terraform state show tidbcloud_restore.${resource-name}コマンドを使用して、復元タスクのステータスを確認します。

   $ terraform state show tidbcloud_restore.example_restore
   
   # tidbcloud_restore.example_restore:
   resource "tidbcloud_restore" "example_restore" {
       backup_id        = "1350048"
       cluster          = {
           id     = "1379661944630264072"
           name   = "restoreCluster"
           status = "INITIALIZING"
       }
       cluster_id       = "1379661944630234067"
       config           = {
           components    = {
               tidb    = {
                   node_quantity = 2
                   node_size     = "8C16G"
               }
               tiflash = {
                   node_quantity    = 2
                   node_size        = "8C64G"
                   storage_size_gib = 500
               }
               tikv    = {
                   node_quantity    = 6
                   node_size        = "8C32G"
                   storage_size_gib = 500
               }
           }
           port          = 4000
           root_password = "Your_root_password1."
       }
       create_timestamp = "2022-08-26T08:16:33Z"
       id               = "780114"
       name             = "restoreCluster"
       project_id       = "1372813089189561287"
       status           = "PENDING"
   }
   

   復元タスクのステータスがPENDING 、クラスターのステータスがINITIALIZINGであることがわかります。

5. 数分間待ちます。次に、 terraform refershを使用してステータスを更新します。

6. クラスターのステータスがAVAILABLEに変化した後、復元タスクはRUNNINGなり、最終的にSUCCESSになります。

復元されたクラスターは Terraform によって管理されないことに注意してください。復元されたクラスターはそれをインポートするで管理できます。

復元タスクを更新する

復元タスクは更新できません。

復元タスクを削除する

復元タスクは削除できません。