管理標準備份

Cloud SQL 標準備份可讓您排定自動備份、建立隨選備份，以及查看資料庫執行個體的現有備份。定期備份可防止資料意外遺失或損毀，並支援災難復原。如果執行個體使用強化備份，請參閱「管理強化備份」。

在進階備份選項推出前建立的執行個體，預設會使用標準備份。如要升級執行個體以使用進階級備份，請參閱「啟用進階級備份」。如要進一步瞭解備份的運作方式和可用的備份選項，請參閱「Cloud SQL 備份總覽」和「選擇備份選項」。

建立按照需求執行的備份

建立隨選備份：

控制台

  1. 前往 Cloud de Confiance 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 點選執行個體名稱，開啟執行個體的「總覽」頁面。
  3. 在 SQL 導覽選單中，選取「備份」。
  4. 按一下「Create backup」(建立備份)。
  5. 在「Create backup」(建立備份) 頁面中，視需要新增說明，然後按一下「Create」(建立)。

gcloud

建立備份：

gcloud sql backups create \
--async \
--instance=INSTANCE_NAME

您可以使用 --description 參數提供備份說明。

如要在自訂位置建立備份，請按照下列步驟操作：

gcloud sql backups create \
--async \
--instance=INSTANCE_NAME \
--location=BACKUP_LOCATION

REST v1

使用任何要求資料之前，請先修改下列項目的值：

  • project-id：專案 ID
  • instance-id：執行個體 ID

HTTP 方法和網址：

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

REST v1beta4

使用任何要求資料之前，請先修改下列項目的值：

  • project-id：專案 ID
  • instance-id：執行個體 ID

HTTP 方法和網址：

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

設定自動備份

執行個體運作期間，系統會按照排定的頻率自動備份。您也可以設定自動備份的保留期限。如要進一步瞭解自動備份的運作方式，請參閱「自動備份」。

排定自動備份

為執行個體排定自動備份時程：

控制台

  1. 前往 Cloud de Confiance 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 點選執行個體名稱，開啟執行個體的「總覽」頁面。
  3. 在 SQL 導覽選單中，選取「備份」。
  4. 按一下「設定」旁的「編輯」。
  5. 選擇自動備份資料的時間範圍。
  6. 按一下 [儲存]。

gcloud

  1. 編輯執行個體，指定備份開始時間： 
    gcloud sql instances patch INSTANCE_NAME --backup-start-time=HH:MM
     backup-start-time 參數是以 24 小時制格式指定，時區為 UTC±00，並指定 4 小時備份時段的開始時間。備份作業可在備份期間內隨時啟動。
  2. 確認變更： 
    gcloud sql instances describe INSTANCE_NAME
     在 backupConfiguration 部分中，確認您看到 enabled: true 和您指定的時間。

Terraform

如要建立資料庫備份，請使用 Terraform 資源。

resource "google_sql_database_instance" "instance" {
  name             = "mysql-instance-backup"
  region           = "asia-northeast1"
  database_version = "MYSQL_8_0"
  settings {
    tier = "db-f1-micro"
    backup_configuration {
      enabled            = true
      binary_log_enabled = true
      start_time         = "20:55"
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

套用變更

如要在 Cloud de Confiance 專案中套用 Terraform 設定，請完成下列各節的步驟。

準備 Cloud Shell

  1. 啟動 Cloud Shell。

  2. 設定要套用 Terraform 設定的預設 Cloud de Confiance 專案。

    每個專案只需執行這個指令一次，而且可以在任何目錄中執行。

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    如果您在 Terraform 設定檔中設定明確的值，環境變數就會遭到覆寫。

準備目錄

每個 Terraform 設定檔都必須有自己的目錄 (也稱為根模組)。

  1. 在 Cloud Shell 中建立目錄，並在該目錄中建立新檔案。檔案名稱必須有 .tf 副檔名，例如 main.tf。在本教學課程中，這個檔案稱為 main.tf。
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. 如果您正在進行教學課程，可以複製每個章節或步驟中的程式碼範例。

    將程式碼範例複製到新建立的 main.tf。

    您也可以從 GitHub 複製程式碼。如果 Terraform 程式碼片段是端對端解決方案的一部分，建議您採用這種做法。

  3. 請查看並修改範例參數，以便套用至您的環境。
  4. 儲存變更。
  5. 初始化 Terraform。每個目錄只需執行一次這項操作。 
    terraform init

    如要使用最新版 Google 供應商，請視需要加入 -upgrade 選項：

    terraform init -upgrade

套用變更

  1. 查看設定，確認 Terraform 要建立或更新的資源符合預期：
    terraform plan

    視需要修正設定。

  2. 執行下列指令，並在提示中輸入 yes，套用 Terraform 設定：
    terraform apply

    等待 Terraform 顯示「Apply complete!」訊息。

  3. 開啟 Cloud de Confiance 專案即可查看結果。在 Cloud de Confiance 控制台的使用者介面中，前往資源頁面，確認 Terraform 已建立或更新資源。

刪除變更

如要刪除變更，請按照下列步驟操作：

  1. 如要停用防刪除功能，請在 Terraform 設定檔中將 deletion_protection 引數設為 false。
    deletion_protection =  "false"
  2. 執行下列指令，並在提示中輸入 yes，套用更新後的 Terraform 設定：
    terraform apply

  1. 執行下列指令，並在提示中輸入 yes，移除先前使用 Terraform 設定套用的資源：

    terraform destroy

REST v1

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID： Cloud de Confiance 專案的 ID 或專案編號，該專案包含執行個體
  • INSTANCE_NAME：要設定高可用性的主要或唯讀副本執行個體名稱
  • START_TIME：時間 (小時和分鐘)

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON 要求主體：

{
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "binaryLogEnabled": true
    }
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

您可以在 backupConfiguration 物件中將 pointInTimeEnabled 設為 true，同時啟用二進位記錄。

REST v1beta4

您可以在 backupConfiguration 物件中將 binaryLogEnabled 設為 true，同時啟用二進位記錄。

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID： Cloud de Confiance 專案的 ID 或專案編號，該專案包含執行個體
  • INSTANCE_NAME：要設定高可用性的主要或唯讀副本執行個體名稱
  • START_TIME：時間 (小時和分鐘)

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON 要求主體：

{
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "binaryLogEnabled": true
    }
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

設定自動備份保留期限

如要設定要保留的自動備份數量，請按照下列步驟操作：

控制台

  1. 前往 Cloud de Confiance 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 點選執行個體名稱，開啟執行個體的「總覽」頁面。
  3. 在 SQL 導覽選單中，選取「備份」。
  4. 按一下 [編輯]。
  5. 在「自動備份」部分，展開「進階選項」。
  6. 輸入一次要儲存的備份數量。
  7. 按一下 [儲存]。

gcloud

編輯執行個體，設定要保留的自動備份數量。這個數字不得小於預設值 (七)。 

gcloud sql instances patch INSTANCE_NAME \
--retained-backups-count=NUM_TO_RETAIN

Terraform

如要指定資料庫執行個體要保留的自動備份數量，請使用 Terraform 資源。

resource "google_sql_database_instance" "default" {
  name             = "mysql-instance-backup-retention"
  region           = "asia-northeast1"
  database_version = "MYSQL_8_0"
  settings {
    tier = "db-f1-micro"
    backup_configuration {
      enabled = true
      backup_retention_settings {
        retained_backups = 365
        retention_unit   = "COUNT"
      }
    }
  }
}

REST v1beta4

使用任何要求資料之前，請先修改下列項目的值：

  • unit：選用。保留單位可以是整數或字串。目前支援 (且預設) 的值為 1 或「COUNT」。
  • num-to-retain：要保留的自動備份數量，範圍為 1 到 365。
  • project-id：專案 ID
  • instance-id：執行個體 ID

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON 要求主體：

{
  "settings":
  {
    "backupConfiguration":
    {
      "backupRetentionSettings":
      {
        "retentionUnit": unit,
        "retainedBackups": "num-to-retain"
      }
    }
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

停用自動備份

如要停用執行個體的自動備份功能，請按照下列步驟操作：

控制台

  1. 前往 Cloud de Confiance 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 點選執行個體名稱，開啟執行個體的「總覽」頁面。
  3. 在 SQL 導覽選單中，選取「備份」。
  4. 按一下「Manage automated backups」(管理自動備份)
  5. 取消勾選「自動備份」。
  6. 按一下「儲存並重新啟動」。

gcloud

編輯執行個體以停用備份：

gcloud sql instances patch INSTANCE_NAME \
--no-backup

REST v1

使用任何要求資料之前，請先修改下列項目的值：

  • project-id：專案 ID
  • instance-id：執行個體 ID

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

JSON 要求主體：

{
  "settings":
  {
    "backupConfiguration":
    {
      "enabled": false,
      "binaryLogEnabled": false
    }
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

REST v1beta4

使用任何要求資料之前，請先修改下列項目的值：

  • project-id：專案 ID
  • instance-id：執行個體 ID

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON 要求主體：

{
  "settings":
  {
    "backupConfiguration":
    {
      "enabled": false,
      "binaryLogEnabled": false
    }
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

刪除備份

您可以刪除自動及隨選備份。

如果是 MySQL 執行個體，刪除備份可能無法釋出與備份大小相同的空間。這是因為備份是遞增的，因此刪除舊備份可能會將部分內容轉移到較新的備份，以保留較新備份的完整性。

控制台

  1. 前往 Cloud de Confiance 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 點選執行個體名稱，開啟執行個體的「總覽」頁面。
  3. 在 SQL 導覽選單中，選取「備份」。
  4. 針對要刪除的備份，按一下「更多動作」圖示 更多動作圖示。。
  5. 選取 [刪除]。
  6. 在「Delete backup」(刪除備份) 視窗中，在欄位中輸入 Delete，然後按一下「Delete」(刪除)。

gcloud

刪除 Cloud SQL 執行個體的備份：

gcloud beta sql backups delete BACKUP_ID \
--instance INSTANCE_NAME

如需完整的參數清單，請參閱 gcloud beta sql backups delete 指令參考資料頁面。

REST v1

  1. 列出備份，取得要刪除的備份 ID：

    使用任何要求資料之前，請先修改下列項目的值：

    • project-id：專案 ID
    • instance-id：執行個體 ID

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns

    請展開以下其中一個選項，以傳送要求：

    您應該會收到如下的 JSON 回覆：

  2. 刪除備份：

    使用任何要求資料之前，請先修改下列項目的值：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • backup-id：備份 ID

    HTTP 方法和網址：

    DELETE https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id

    請展開以下其中一個選項，以傳送要求：

    您應該會收到如下的 JSON 回覆：

REST v1beta4

  1. 列出備份，取得要刪除的備份 ID：

    使用任何要求資料之前，請先修改下列項目的值：

    • project-id：專案 ID
    • instance-id：執行個體 ID

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

    請展開以下其中一個選項，以傳送要求：

    您應該會收到如下的 JSON 回覆：

  2. 刪除備份：

    使用任何要求資料之前，請先修改下列項目的值：

    • project-id：專案 ID
    • instance-id：執行個體 ID
    • backup-id：備份 ID

    HTTP 方法和網址：

    DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns/backup-id

    請展開以下其中一個選項，以傳送要求：

    您應該會收到如下的 JSON 回覆：

設定自訂備份位置

除非法規要求，否則請勿使用自訂備份位置。如非必要，請使用預設的多區域備份位置。

您可以為隨選和自動備份使用自訂位置。如需有效位置值的完整清單，請參閱「執行個體位置」。

如要更新執行個體的自訂位置，請按照下列步驟操作：

控制台

  1. 前往 Cloud de Confiance 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 點選執行個體名稱，開啟執行個體的「總覽」頁面。
  3. 在 SQL 導覽選單中，選取「備份」。
  4. 按一下「設定」旁邊的「編輯」。
  5. 在「Automated Backups」(自動備份) 區段中，展開「Advanced Options」(進階選項)。
  6. 按一下「多區域 (預設)」或「區域」。
  7. 從「Location」(位置) 下拉式選單中選取位置。
  8. 按一下 [儲存]。

gcloud

如需參考資訊，請參閱 gcloud sql instances patch。

gcloud sql instances patch INSTANCE_NAME \
--backup-location=BACKUP_LOCATION

Terraform

如要指定資料庫執行個體備份的自訂位置，請使用 Terraform 資源。

resource "google_sql_database_instance" "default" {
  name             = "mysql-instance-with-backup-location"
  region           = "asia-northeast1"
  database_version = "MYSQL_8_0"
  settings {
    tier = "db-f1-micro"
    backup_configuration {
      enabled  = true
      location = "asia-northeast1"
    }
  }
}

REST v1

使用執行個體的 settings.backupConfiguration.location 參數做為備份位置。

使用任何要求資料之前，請先修改下列項目的值：

  • region：專案區域
  • backup-region：備份區域
  • project-id：專案 ID
  • instance-id：執行個體 ID

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

JSON 要求主體：

{
  "region": "region"
  "settings":
  {
    "backupConfiguration":
    {
      "location": "backup-region",
      "enabled": true,
    }
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

REST v1beta4

使用執行個體的 settings.backupConfiguration.location 參數做為備份位置。

使用任何要求資料之前，請先修改下列項目的值：

  • region：專案區域
  • backup-region：備份區域
  • project-id：專案 ID
  • instance-id：執行個體 ID

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON 要求主體：

{
  "region": "region"
  "settings":
  {
    "backupConfiguration":
    {
      "location": "backup-region",
      "enabled": true,
    }
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

查看備份清單

如要查看備份清單和備份詳細資料，請使用下列選項。

Cloud de Confiance 控制台不會在備份記錄中顯示略過或失敗的備份。如要查看略過的備份，請使用 gcloud 或 API。

控制台

  1. 前往 Cloud de Confiance 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 點選執行個體名稱，開啟執行個體的「總覽」頁面。
  3. 從 SQL 導覽選單中選取「備份」，即可查看最近的備份，以及建立時間和備份類型。

gcloud

  • 列出執行個體的備份： 
    gcloud sql backups list \
--instance INSTANCE_NAME

    您可以使用標準清單參數篩選及控管結果。 如需完整清單，請參閱 gcloud sql backups list 指令參考資料頁面。

  • 從 backups list 指令的輸出內容中指定備份 ID，即可查看備份詳細資料。
    gcloud sql backups describe BACKUP_ID \
--instance INSTANCE_NAME

REST v1

您也可以使用 BackupRuns:list 頁面上的 APIs Explorer 傳送 REST API 要求。

使用任何要求資料之前，請先修改下列項目的值：

  • project-id：專案 ID
  • instance-id：執行個體 ID

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

REST v1beta4

您也可以使用 BackupRuns:list 頁面上的 APIs Explorer 傳送 REST API 要求。

使用任何要求資料之前，請先修改下列項目的值：

  • project-id：專案 ID
  • instance-id：執行個體 ID

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

在服務中斷期間查看備份清單

如果執行個體所在的區域發生中斷，您只能使用萬用字元 (-) 搭配 backupRuns.list API，查看該執行個體的備份。萬用字元會傳回專案中的所有備份。請參閱「還原至其他執行個體」。

如果執行個體啟用了客戶自行管理的加密金鑰 (CMEK)，當該執行個體所在區域發生服務中斷時，您無法將該執行個體的備份還原至其他區域。這是因為在執行個體啟用 CMEK 時，Cloud SQL 會使用區域 Cloud KMS 金鑰進行加密。如要還原 CMEK 執行個體的備份，Cloud SQL 必須具備 CMEK 金鑰的存取權。如果區域服務中斷，就無法存取該區域的 Cloud KMS 金鑰。

gcloud

  1. 列出專案中每個執行個體的備份： 
    gcloud sql backups list --instance -

    指令會傳回類似下列的資訊：

    {
      "kind": "sql#backupRun",
      "status": "SUCCESSFUL",
      "enqueuedTime": "2020-01-21T11:25:33.818Z",
      "id": "backup-id",
      "startTime": "2020-01-21T11:25:33.858Z",
      "endTime": "2020-01-21T11:26:18.663Z",
      "type": "AUTOMATED",
      "windowStartTime": "2020-01-21T10:00:00.479Z",
      "instance": "instance-id",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id",
      "location": "us"
      "backupKind": "SNAPSHOT"
    }
  2. 找出所需執行個體的備份。如要還原這個備份，請參閱「還原至其他執行個體」。

REST v1

  1. 列出專案中的所有備份：

    使用任何要求資料之前，請先修改下列項目的值：

    • PROJECT_ID：專案 ID
    • INSTANCE_ID：執行個體 ID，或 - (用於列出專案中的所有備份)

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/-/backupRuns

    請展開以下其中一個選項，以傳送要求：

    您應該會收到如下的 JSON 回覆：

  2. 找出所需執行個體的備份。如要還原這個備份，請參閱「還原至其他執行個體」。

REST v1beta4

  1. 列出專案中的所有備份：

    使用任何要求資料之前，請先修改下列項目的值：

    • project-id：專案 ID
    • instance-id：執行個體 ID，或 - (用於列出專案中的所有備份)

    HTTP 方法和網址：

    GET https://sqladmin.googleapis.com/v1beta4/projects/project-id/instances/-/backupRuns

    請展開以下其中一個選項，以傳送要求：

    您應該會收到如下的 JSON 回覆：

  2. 找出所需執行個體的備份。如要還原這個備份，請參閱「還原至其他執行個體」。

查看備份位置

如要查看執行個體備份的位置，請使用 backupRuns：

控制台

  1. 前往 Cloud de Confiance 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 點選執行個體名稱，開啟執行個體的「總覽」頁面。
  3. 在 SQL 導覽選單中，選取「備份」。
  4. 在備份清單中，「Location」(位置) 欄會列出位置類型 (多區域或區域)，以及每個備份的特定多區域或區域。

gcloud

如需參考資訊，請參閱 gcloud sql instances describe。

  1. 列出執行個體的備份： 
    gcloud sql backups list \
--instance INSTANCE_NAME

    您可以使用標準清單參數篩選及控管結果。 如需完整清單，請參閱 gcloud sql backups list 指令參考資料頁面。

  2. 如要列出單一備份的詳細資料，請使用 backups list 指令輸出內容中的 ID。
    gcloud sql backups describe BACKUP_ID \
--instance INSTANCE_NAME

REST v1

使用任何要求資料之前，請先修改下列項目的值：

  • project-id：專案 ID
  • instance-id：執行個體 ID

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

在上述範例中：
  • REGION 是原始執行個體的所在地區。
  • BACKUP_LOCATION 是您要 Cloud SQL 儲存備份的位置。

REST v1beta4

使用任何要求資料之前，請先修改下列項目的值：

  • project-id：專案 ID
  • instance-id：執行個體 ID

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

在上述範例中：
  • REGION 是原始執行個體的所在地區。
  • BACKUP_LOCATION 是您要 Cloud SQL 儲存備份的位置。

查看備份大小

您可以使用 gcloud CLI 或 API，查看 Cloud SQL 執行個體的備份大小。

gcloud

  1. 如要取得與 Cloud de Confiance 專案相關聯的所有備份清單，請使用 gcloud sql backups list 指令：

    gcloud sql backups list

  2. 如要查看備份大小，請使用 gcloud sql backups describe 指令：

    gcloud sql backups describe BACKUP_ID \
--instance=INSTANCE_NAME \
--project=PROJECT_ID

    請依指示取代下列項目：

    • BACKUP_ID：備份 ID。執行 gcloud sql backups list 指令後，即可從輸出內容取得這個 ID。
    • INSTANCE_NAME：執行個體的名稱。
    • PROJECT_ID： Cloud de Confiance 專案的 ID 或專案編號，該專案包含執行個體。

    在輸出內容中，maxChargeableBytes 參數會顯示備份大小 (以位元組為單位)。

REST

取得備份清單

使用這個範例，即可取得與 Cloud de Confiance 專案相關聯的所有備份清單。如需這項呼叫的完整參數清單，請參閱 backupRuns.list 頁面。

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID： Cloud de Confiance 專案的 ID 或專案編號，該專案包含執行個體
  • INSTANCE_NAME：執行個體的名稱

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/backupRuns

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

查看備份詳細資料

使用這個範例查看備份詳細資料，包括備份大小。如需這項呼叫的完整參數清單，請參閱 backupRuns.get 頁面。

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID： Cloud de Confiance 專案的 ID 或專案編號，該專案包含執行個體。
  • INSTANCE_NAME：執行個體的名稱。
  • BACKUP_ID：備份 ID。您可以從先前呼叫的輸出內容中取得這個 ID。

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/backupRuns/BACKUP_ID

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

設定最終備份

您可以啟用最終備份執行個體設定，並設定最終備份保留期限，讓執行個體自動建立備份。如果刪除前未啟用執行個體的最終備份功能，您也可以在刪除執行個體時建立最終備份。如要進一步瞭解最終備份的運作方式，請參閱「最終備份」。

如要在執行個體刪除後管理最終備份，請參閱「管理已刪除執行個體的備份」。

啟用最終備份

如要為執行個體啟用最終備份功能，請按照下列步驟操作：

控制台

  1. 前往 Cloud de Confiance 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 找出要啟用最終備份的執行個體。按一下執行個體名稱，開啟執行個體的「Overview」(總覽) 頁面。

  3. 按一下 [編輯]。

  4. 在「自訂執行個體」下方，展開「資料保護」。

  5. 如要啟用最終備份，請勾選「Instance deletion protection」(執行個體防刪除功能) 下方的「Final backup on instance deletion」(刪除執行個體時建立最終備份) 方塊。

    預設保留期限為 30 天。如要變更，請在「Days of retention」(保留天數) 方塊中輸入 1 到 365 之間的數字。

  6. 按一下 [儲存]。

gcloud

使用 gcloud sql instances 指令啟用最終備份。

  gcloud sql instances patch INSTANCE_NAME \
  --final-backup \
  --final-backup-retention-days=RETENTION_DAYS

更改下列內容：

  • INSTANCE_NAME：Cloud SQL 執行個體的名稱。
  • RETENTION_DAYS：最終備份的保留天數。這個範圍可以是 1 到 365 天，預設值為 30 天。

REST v1

如要啟用最終備份，請按照下列步驟操作：

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：專案 ID
  • INSTANCE_ID：執行個體 ID
  • RETENTION_DAYS：最終備份的保留天數

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 要求主體：

{
  "settings": {
    "FinalBackupConfig": {
      "enabled": true,
      "retentionDays: RETENTION_DAYS
    }
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

如要啟用最終備份，請按照下列步驟操作：

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：專案 ID
  • INSTANCE_ID：執行個體 ID
  • RETENTION_DAYS：最終備份的保留天數

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 要求主體：

{
  "settings": {
    "FinalBackupConfig": {
      "enabled": true,
      "retentionDays: RETENTION_DAYS
    }
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

設定最終備份保留期限

如要設定執行個體的最終備份保留期限，請按照下列步驟操作：

控制台

  1. 前往 Cloud de Confiance 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 找出要啟用最終備份的執行個體。按一下執行個體名稱，開啟執行個體的「Overview」(總覽) 頁面。

  3. 按一下 [編輯]。

  4. 在「自訂執行個體」下方，展開「資料保護」。

  5. 如要變更最終備份保留期限，請在「Final backup after instance deletion」(刪除執行個體後的最終備份) 設定下方的「Days of retention」(保留天數) 方塊中，輸入 1 到 365 之間的數字。

    預設保留期限為 30 天。

  6. 按一下 [儲存]。

gcloud

使用 gcloud sql instances 指令，更新最終備份保留天數設定。

  gcloud sql instances patch INSTANCE_NAME \
  --final-backup-retention-days=RETENTION_DAYS

更改下列內容：

  • INSTANCE_NAME：Cloud SQL 執行個體的名稱。
  • RETENTION_DAYS：最終備份的保留天數。這個範圍可以是 1 到 365 天，預設值為 30 天。

REST v1

如要更新最終備份保留天數設定，請按照下列步驟操作：

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：專案 ID
  • INSTANCE_ID：執行個體 ID
  • RETENTION_DAYS：最終備份的保留天數

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 要求主體：

{
  "settings": {
    "FinalBackupConfig": {
      "retentionDays: RETENTION_DAYS
    }
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

如要更新最終備份保留天數設定，請按照下列步驟操作：

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：專案 ID
  • INSTANCE_ID：執行個體 ID
  • RETENTION_DAYS：最終備份的保留天數

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 要求主體：

{
  "settings": {
    "FinalBackupConfig": {
      "retentionDays: RETENTION_DAYS
    }
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

停用最終備份

如要停用執行個體的最終備份，請按照下列步驟操作：

控制台

  1. 前往 Cloud de Confiance 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 找出要啟用最終備份的執行個體。按一下執行個體名稱，開啟執行個體的「Overview」(總覽) 頁面。

  3. 按一下 [編輯]。

  4. 在「自訂執行個體」下方，展開「資料保護」。

  5. 如要停用最終備份，請取消勾選「Instance deletion protection」(執行個體防刪除功能) 下方的「Final backup on instance deletion」(刪除執行個體時建立最終備份) 方塊。

  6. 按一下 [儲存]。

gcloud

使用 gcloud sql instances 指令停用最終備份。

  gcloud sql instances patch INSTANCE_NAME \
  --no-final-backup

更改下列內容：

  • INSTANCE_NAME：Cloud SQL 執行個體的名稱。

REST v1

如要停用最終備份，請按照下列步驟操作：

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：專案 ID
  • INSTANCE_ID：執行個體 ID

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 要求主體：

{
  "settings": {
    "FinalBackupConfig": {
      "enabled": false
    }
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

如要停用最終備份，請按照下列步驟操作：

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：專案 ID
  • INSTANCE_ID：執行個體 ID

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 要求主體：

{
  "settings": {
    "FinalBackupConfig": {
      "enabled": false
    }
  }s
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

設定保留的備份

您可以設定執行個體，在刪除執行個體時自動保留所有自動和隨選備份。這些備份會根據刪除時的備份保留期限保留。如要進一步瞭解最終備份的運作方式，請參閱「最終備份」。

如要管理執行個體刪除後保留的備份，請參閱「管理已刪除執行個體的備份」。

啟用保留備份

如要為執行個體啟用保留備份，請按照下列步驟操作：

控制台

  1. 前往 Cloud de Confiance 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 找出要啟用保留備份功能的執行個體。按一下執行個體名稱，開啟執行個體的「Overview」(總覽) 頁面。

  3. 按一下 [編輯]。

  4. 在「自訂執行個體」下方，展開「資料保護」。

  5. 如要啟用保留備份，請勾選「Instance deletion protection」(執行個體防刪除功能) 下方的「Retain backups after instance deletion」(刪除執行個體後保留備份) 方塊。

  6. 按一下 [儲存]。

gcloud

使用 gcloud sql instances 指令啟用保留備份。

  gcloud sql instances patch INSTANCE_NAME \
  --retain-backups-on-delete

更改下列內容：

  • INSTANCE_NAME：Cloud SQL 執行個體的名稱。

REST v1

如要啟用保留備份，請按照下列步驟操作：

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：專案 ID
  • INSTANCE_ID：執行個體 ID

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 要求主體：

{
  "settings": {
    "retainBackupsOnDelete": true
    }
  }

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

如要啟用保留備份，請按照下列步驟操作：

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：專案 ID
  • INSTANCE_ID：執行個體 ID

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 要求主體：

{
  "settings": {
    "retainBackupsOnDelete": true
    }
  }

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

停用保留的備份

如要停用執行個體的保留備份，請按照下列步驟操作：

控制台

  1. 前往 Cloud de Confiance 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 找出要啟用保留備份功能的執行個體。按一下執行個體名稱，開啟執行個體的「Overview」(總覽) 頁面。

  3. 按一下 [編輯]。

  4. 在「自訂執行個體」下方，展開「資料保護」。

  5. 如要停用保留的備份，請取消勾選「Instance deletion protection」(執行個體防刪除功能) 下方的「Retain backups after instance deletion」(刪除執行個體後保留備份) 方塊。

  6. 按一下 [儲存]。

gcloud

使用 gcloud sql instances 指令停用保留的備份。

  gcloud sql instances patch INSTANCE_NAME \
  --no-retain-backups-on-delete

更改下列內容：

  • INSTANCE_NAME：Cloud SQL 執行個體的名稱。

REST v1

如要停用保留的備份，請按照下列步驟操作：

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：專案 ID
  • INSTANCE_ID：執行個體 ID

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 要求主體：

{
  "settings": {
    "retainBackupsOnDelete": false
    }
  }

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

如要停用保留的備份，請按照下列步驟操作：

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：專案 ID
  • INSTANCE_ID：執行個體 ID

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

JSON 要求主體：

{
  "settings": {
    "retainBackupsOnDelete": true
    }
  }

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

後續步驟