本頁面中的部分或全部資訊可能不適用於 Trusted Cloud by S3NS。

本頁面由 Cloud Translation API 翻譯而成。

使用時間點復原 (PITR)

MySQL | PostgreSQL | SQL Server

本頁說明如何使用時間點復原 (PITR) 功能，還原主要 Cloud SQL 執行個體。

如要進一步瞭解 PITR，請參閱「時間點復原 (PITR)」。

如果您建立 Cloud SQL Enterprise Plus 版執行個體，系統會預設啟用 PITR，無論您使用哪種建立方法都一樣。如要停用這項功能，請手動操作。

如果您在 Trusted Cloud 控制台中建立 Cloud SQL Enterprise 版執行個體，系統預設會啟用 PITR。否則，如果您使用 gcloud CLI、Terraform 或 Cloud SQL Admin API 建立執行個體，系統預設會停用 PITR。在這種情況下，如要啟用這項功能，就必須手動操作。

時間點復原功能的記錄檔儲存空間

Cloud SQL 會使用預先寫入記錄 (WAL) 歸檔功能進行 PITR。

2023 年 1 月 9 日，我們推出將時間點復原 (PITR) 的預先寫入記錄檔儲存在 Cloud Storage 的功能。自推出這項功能以來，適用下列條件：

所有 Cloud SQL Enterprise Plus 版執行個體都會將預先寫入記錄儲存在 Cloud Storage 中。只有從 Cloud SQL Enterprise 版本升級，且在 2023 年 1 月 9 日前啟用 PITR 的 Cloud SQL Enterprise Plus 版本執行個體，才會繼續在磁碟上儲存記錄。
在 2023 年 1 月 9 日前建立的 Cloud SQL Enterprise 版執行個體，如果已啟用 PITR，系統會繼續在磁碟上儲存記錄。
如果您在 2024 年 8 月 15 日後，將 Cloud SQL Enterprise 版執行個體升級至 Cloud SQL Enterprise Plus 版，且該執行個體會將時間點復原 (PITR) 的交易記錄儲存在磁碟上，升級程序會為您將 PITR 交易記錄的儲存位置切換至 Cloud Storage。詳情請參閱使用就地升級功能將執行個體升級為 Cloud SQL Enterprise Plus 版本。
自 2023 年 1 月 9 日起，凡是啟用 PITR 功能後建立的 Cloud SQL Enterprise 版執行個體，都會將記錄儲存在 Cloud Storage 中。

如果執行個體只將預先寫入記錄儲存在磁碟上，您可以使用 gcloud CLI 或 Cloud SQL Admin API，將用於 PITR 的交易記錄儲存位置從磁碟切換至 Cloud Storage，且不會造成任何停機時間。詳情請參閱「將交易記錄儲存空間切換為 Cloud Storage」。

記錄保留期限

如要查看執行個體是否將用於 PITR 的記錄檔儲存在 Cloud Storage 中，請使用「檢查用於 PITR 的交易記錄儲存位置」。

使用 psql 或 pgAdmin 等 PostgreSQL 用戶端連線至執行個體的資料庫後，請執行下列指令：show archive_command。如果 Cloud Storage 中有任何預先寫入記錄檔，就會顯示 -async_archive -remote_storage。

對於已啟用 PITR 的所有其他現有執行個體，系統會繼續將記錄儲存在磁碟上。

如果記錄儲存在 Cloud Storage，Cloud SQL 會每五分鐘或更短時間上傳記錄。因此，如果 Cloud SQL 執行個體可用，即可還原至最新時間。不過，如果執行個體無法使用，復原點目標通常為五分鐘或更短。使用 gcloud CLI 或 Admin API 檢查執行個體可還原的最新時間，然後還原至該時間點。

使用 PITR 時，系統會自動刪除預先寫入記錄，以及相關聯的自動備份，通常會在達到 transactionLogRetentionDays 設定的值後執行這項操作。這是指 Cloud SQL 為 PITR 保留交易記錄的天數。如果是 Cloud SQL Enterprise Plus 版本，您可以將值設為 1 到 35；如果是 Cloud SQL Enterprise 版本，您可以將值設為 1 到 7。

如果您在啟用 PITR 前還原 Cloud SQL 執行個體的備份，將會遺失可讓 PITR 運作的預先寫入記錄檔。

如果是啟用客戶自行管理的加密金鑰 (CMEK) 的執行個體，系統會使用最新版本的 CMEK 加密預先寫入記錄。如要執行還原作業，您必須提供所有版本的金鑰，這些金鑰在您為 retained-transaction-log-days 參數設定的天數內，都是最新版本。

如果執行個體的預先寫入記錄儲存在 Cloud Storage 中，記錄會與主要執行個體儲存在相同區域。這項記錄儲存功能 (Cloud SQL Enterprise Plus 版本最多 35 天，Cloud SQL Enterprise 版本最多 7 天，時間點復原功能的最長期限) 不會為每個執行個體產生額外費用。

記錄和磁碟用量

如果執行個體已啟用 PITR，且磁碟上的預先寫入記錄大小導致執行個體發生問題，請按照下列步驟操作：

您可以使用 gcloud CLI 或 Cloud SQL Admin API，將用於 PITR 的記錄儲存位置從磁碟切換至 Cloud Storage，且不會發生停機情形。
您可以將執行個體升級為 Cloud SQL Enterprise Plus 版本。
您可以增加執行個體儲存空間大小，但磁碟用量增加的預先寫入記錄大小可能是暫時的。
建議啟用自動增加儲存空間，以免發生意料之外的儲存空間問題。只有在執行個體已啟用 PITR，且記錄檔儲存在磁碟上時，才適用這項建議。
如要刪除記錄檔並復原儲存空間，可以停用 PITR。減少使用的預寫記錄不會縮減為執行個體佈建的磁碟大小。
系統每天會清除記錄一次，而非持續清除。將記錄保留時間設為兩天，表示系統會保留至少兩天的記錄，最多保留三天的記錄。建議將備份數量設為比記錄保留天數多一天。

舉例來說，如果您為 transactionLogRetentionDays 參數的值指定 7，則對於 backupRetentionSettings 參數，請將 retainedBackups 的數量設為 8。

啟用 PITR

在 Trusted Cloud 控制台中建立新執行個體時，系統會自動啟用「自動備份」和「啟用時間點復原」。

以下程序會在現有主要執行個體上啟用 PITR。

控制台

前往 Trusted Cloud 控制台的「Cloud SQL Instances」頁面。

前往 Cloud SQL 執行個體
開啟要啟用 PITR 的執行個體更多動作選單，然後按一下「編輯」。
展開「自訂執行個體」下方的「資料保護」專區。
勾選「啟用時間點復原」核取方塊。
在「記錄天數」欄位中，輸入要保留記錄的天數。如果是 Cloud SQL Enterprise Plus 版本，天數範圍為 1 到 35 天；如果是 Cloud SQL Enterprise 版本，天數範圍為 1 到 7 天。
按一下 [儲存]。

gcloud

顯示執行個體總覽：

gcloud sql instances describe INSTANCE_NAME

如果「enabled: false」部分顯示在「backupConfiguration」部分，請啟用定期備份：
```
gcloud sql instances patch INSTANCE_NAME \
--backup-start-time=HH:MM
```
請以 24 小時制指定 UTC±00 時區的 backup-start-time 參數。

啟用 PITR：

gcloud sql instances patch INSTANCE_NAME \
--enable-point-in-time-recovery

如果您要在主要執行個體上啟用 PITR，也可以新增下列參數，設定要保留交易記錄的天數：

--retained-transaction-log-days=RETAINED_TRANSACTION_LOG_DAYS

確認變更：
```
gcloud sql instances describe INSTANCE_NAME
```
在「backupConfiguration」部分，您會看到 pointInTimeRecoveryEnabled: true ，瞭解變更是否成功。

Terraform

如要啟用 PITR，請使用 Terraform 資源。

resource "google_sql_database_instance" "postgres_instance_pitr" {
  name             = ""
  region           = "us-central1"
  database_version = "POSTGRES_14"
  settings {
    tier = "db-custom-2-7680"
    backup_configuration {
      enabled                        = true
      point_in_time_recovery_enabled = true
      start_time                     = "20:55"
      transaction_log_retention_days = "3"
    }
  }
  # 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
}

套用變更

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

準備 Cloud Shell

啟動 Cloud Shell。
設定要套用 Terraform 設定的預設 Trusted Cloud 專案。

每項專案只需要執行一次這個指令，且可以在任何目錄中執行。
```
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
```
如果您在 Terraform 設定檔中設定明確值，環境變數就會遭到覆寫。

準備目錄

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

在 Cloud Shell 中建立目錄，並在該目錄中建立新檔案。檔案名稱的副檔名必須是 .tf，例如 main.tf。在本教學課程中，這個檔案稱為 main.tf。
```
mkdir DIRECTORY && cd DIRECTORY && touch main.tf
```
如果您正在學習教學課程，可以複製每個章節或步驟中的範例程式碼。

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

視需要從 GitHub 複製程式碼。如果 Terraform 程式碼片段是端對端解決方案的一部分，建議您使用這個方法。
查看並修改範例參數，套用至您的環境。
儲存變更。
初始化 Terraform。每個目錄只需執行一次這項操作。
```
terraform init
```
如要使用最新版 Google 供應商，請加入 -upgrade 選項：
```
terraform init -upgrade
```

套用變更

檢查設定，確認 Terraform 即將建立或更新的資源符合您的預期：
```
terraform plan
```
視需要修正設定。
執行下列指令，並在提示中輸入 yes，即可套用 Terraform 設定：
```
terraform apply
```
等待 Terraform 顯示「Apply complete!」訊息。
開啟 Trusted Cloud 專案即可查看結果。在 Trusted Cloud 控制台中，前往 UI 中的資源，確認 Terraform 已建立或更新這些資源。

刪除變更

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

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

執行下列指令，並在提示中輸入 yes，移除先前透過 Terraform 設定套用的資源：
```
terraform destroy
```

REST v1

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：包含執行個體的專案 ID 或專案編號 Trusted Cloud
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,
      "pointInTimeRecoveryEnabled": true
    }
  }
}

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

curl (Linux、macOS 或 Cloud Shell)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或使用 Cloud Shell，自動登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

回應

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：包含執行個體的專案 ID 或專案編號 Trusted Cloud
INSTANCE_NAME：您要設定高可用性的主要或讀取備用資源執行個體名稱
START_TIME：時間 (以小時和分鐘為單位)

HTTP 方法和網址：

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

JSON 要求主體：

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

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

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

回應

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

對無法使用的執行個體執行 PITR

控制台

您可能想將無法使用的執行個體復原到其他可用區，原因如下：

無法存取執行個體設定的可用區。這個執行個體處於 FAILED 狀態。
執行個體正在維護中。這個執行個體處於 MAINTENANCE 狀態。

如要復原無法使用的執行個體，請完成下列步驟：

前往 Trusted Cloud 控制台的「Cloud SQL Instances」頁面。

前往 Cloud SQL 執行個體
找出要複製的執行個體列。
在「動作」欄中，按一下「更多動作」選單。
按一下 [建立本機複本]。
在「建立副本」頁面中，完成下列動作：
1. 在「Instance ID」(執行個體 ID) 欄位中，視需要更新執行個體 ID。
2. 按一下「從過去時間點複製資料」。
3. 在「時間點」欄位中，選取要複製資料的日期和時間。這項作業會將執行個體復原為目標時間當下的狀態。
4. 按一下 [建立本機複本]。

複製作業初始化時，系統會將您帶回執行個體清單頁面。

gcloud

您可能需要將無法使用的執行個體復原到其他區域，因為執行個體設定所在的區域無法存取。

gcloud sql instances clone SOURCE_INSTANCE_NAME TARGET_INSTANCE_NAME \
--point-in-time DATE_AND_TIME_STAMP \
--preferred-zone ZONE_NAME \
--preferred-secondary-zone SECONDARY_ZONE_NAME

執行 gcloud sql instances clone 指令的使用者或服務帳戶必須具備 cloudsql.instances.clone 權限。如要進一步瞭解執行 gcloud CLI 指令所需的權限，請參閱「Cloud SQL 權限」。

REST v1

如果執行個體設定所在的區域無法存取，您可能需要將無法使用的執行個體復原到其他區域。

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：專案 ID。
SOURCE_INSTANCE_NAME：來源執行個體的名稱。
TARGET_INSTANCE_NAME：目標 (複製) 執行個體的名稱。
DATE_AND_TIME_STAMP：來源執行個體的日期和時間戳記，採用 UTC 時區和 RFC 3339 格式 (例如
2012-11-15T16:19:00.094Z)。
ZONE_NAME：選用。目標執行個體的主要區域名稱，用於為要複製的 Cloud SQL 執行個體指定其他主要可用區。如果是區域執行個體，這個區域會取代主要區域，但次要區域與執行個體相同。
SECONDARY_ZONE_NAME：選用。目標執行個體的次要區域名稱。用於為要複製的區域 Cloud SQL 執行個體指定其他次要區域。

HTTP 方法和網址：

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone

JSON 要求主體：

{
  "cloneContext":
  {
    "destinationInstanceName": "TARGET_INSTANCE_NAME",
    "pointInTime": "DATE_AND_TIME_STAMP",
    "preferredZone": "ZONE_NAME",
    "preferredSecondaryZone": "SECONDARY_ZONE_NAME"
  }
}

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

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone" | Select-Object -Expand Content

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

回應

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "OPERATION_ID",
  "targetId": "TARGET_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID",
  "instanceUid": "INSTANCE_ID"
}

使用 instances.clone API 方法的使用者或服務帳戶必須具備 cloudsql.instances.clone 權限。如要進一步瞭解使用 API 方法所需的權限，請參閱 Cloud SQL 權限。

REST v1beta4

如果執行個體設定所在的區域無法存取，您可能需要將無法使用的執行個體復原到其他區域。

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：專案 ID。
SOURCE_INSTANCE_NAME：來源執行個體的名稱。
TARGET_INSTANCE_NAME：目標 (複製) 執行個體的名稱。
DATE_AND_TIME_STAMP：來源執行個體的日期和時間戳記，採用 UTC 時區和 RFC 3339 格式 (例如
2012-11-15T16:19:00.094Z)。
ZONE_NAME：選用。目標執行個體的主要區域名稱，這項設定可用於為要複製的 Cloud SQL 執行個體指定其他主要可用區。如果是區域執行個體，這個區域會取代主要區域，但次要區域與執行個體相同。
SECONDARY_ZONE_NAME：選用。目標執行個體的次要區域名稱。用於為要複製的區域 Cloud SQL 執行個體指定其他次要區域。

HTTP 方法和網址：

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone

JSON 要求主體：

{
  "cloneContext":
  {
    "destinationInstanceName": "TARGET_INSTANCE_NAME",
    "pointInTime": "DATE_AND_TIME_STAMP",
    "preferredZone": "ZONE_NAME",
    "preferredSecondaryZone": "SECONDARY_ZONE_NAME"
  }
}

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

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone" | Select-Object -Expand Content

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

回應

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "OPERATION_ID",
  "targetId": "TARGET_INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID",
  "instanceUid": "INSTANCE_ID"
}

使用 instances.clone API 方法的使用者或服務帳戶必須具備 cloudsql.instances.clone 權限。如要進一步瞭解使用 API 方法所需的權限，請參閱 Cloud SQL 權限。

如果您嘗試在最新可復原時間之後建立 PITR 副本，系統會顯示下列錯誤訊息：

The timestamp for point-in-time recovery is after the latest recovery time of
Timestamp of latest recovery time. Clone the instance with a time
that's earlier than this recovery time.

取得最新恢復時間

如果執行個體可用，您可以執行時間點復原，還原至最新時間。如果執行個體無法使用，且執行個體記錄檔儲存在 Cloud Storage，您可以擷取最新的復原時間，並執行該時間點的復原作業。在這兩種情況下，您都可以提供偏好的區域值，將執行個體還原至其他主要或次要區域。

gcloud

取得最新時間，您可將無法使用的 Cloud SQL 執行個體還原至該時間點。

將 INSTANCE_NAME 替換為您要查詢的執行個體名稱。

gcloud sql instances get-latest-recovery-time INSTANCE_NAME

REST v1

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：專案 ID
INSTANCE_NAME：您要查詢最新復原時間的執行個體名稱

HTTP 方法和網址：

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

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

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime" | Select-Object -Expand Content

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

{
  "kind": "sql#getLatestRecoveryTime",
  "latestRecoveryTime": "2023-06-20T17:23:59.648821586Z"
}

REST v1beta4

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：專案 ID
INSTANCE_NAME：您要查詢最新復原時間的執行個體名稱

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime

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

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime" | Select-Object -Expand Content

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

{
  "kind": "sql#getLatestRecoveryTime",
  "latestRecoveryTime": "2023-06-20T17:23:59.648821586Z"
}

執行 PITR

控制台

前往 Trusted Cloud 控制台的「Cloud SQL Instances」頁面。

前往 Cloud SQL 執行個體
開啟要復原執行個體的更多動作選單，然後按一下「建立副本」。
(選用) 在「建立副本」頁面中，更新新副本的 ID。
選取「從過去時間點複製資料」。
輸入 PITR 時間。
按一下 [建立本機複本]。

gcloud

使用 PITR 建立副本。

更改下列內容：

SOURCE_INSTANCE_NAME：要還原的執行個體名稱。
NEW_INSTANCE_NAME - 副本的名稱。
TIMESTAMP - 來源執行個體的世界標準時間時區，格式為 RFC 3339。例如：2012-11-15T16:19:00.094Z。

gcloud sql instances clone SOURCE_INSTANCE_NAME \
NEW_INSTANCE_NAME \
--point-in-time 'TIMESTAMP'

REST v1

使用任何要求資料之前，請先替換以下項目：

project-id：專案 ID
target-instance-id：目標執行個體 ID
source-instance-id：來源例項 ID
restore-timestamp 可復原的時間點

HTTP 方法和網址：

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

JSON 要求主體：

{
  "cloneContext":
  {
    "kind": "sql#cloneContext",
    "destinationInstanceName": "target-instance-id",
    "pointInTime": "restore-timestamp"
  }
}

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

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone" | Select-Object -Expand Content

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

回應

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE",
  "name": "operation-id",
  "targetId": "target-instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

使用任何要求資料之前，請先替換以下項目：

project-id：專案 ID
target-instance-id：目標執行個體 ID
source-instance-id：來源例項 ID
restore-timestamp 可復原的時間點

HTTP 方法和網址：

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

JSON 要求主體：

{
  "cloneContext":
  {
    "kind": "sql#cloneContext",
    "destinationInstanceName": "target-instance-id",
    "pointInTime": "restore-timestamp"
  }
}

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

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone" | Select-Object -Expand Content

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

回應

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE",
  "name": "operation-id",
  "targetId": "target-instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

停用 PITR

控制台

前往 Trusted Cloud 控制台的「Cloud SQL Instances」頁面。

前往 Cloud SQL 執行個體
找到要停用的執行個體，開啟更多動作選單，然後選取「編輯」。
展開「自訂執行個體」下方的「資料保護」專區。
清除「啟用時間點復原」。
按一下 [儲存]。

gcloud

停用時間點復原功能：

gcloud sql instances patch INSTANCE_NAME \
--no-enable-point-in-time-recovery

確認您的變更：
```
gcloud sql instances describe INSTANCE_NAME
```
在「backupConfiguration」部分，您會看到 pointInTimeRecoveryEnabled: false ，瞭解變更是否成功。

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,
      "pointInTimeRecoveryEnabled": false
    }
  }
}

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

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id" | Select-Object -Expand Content

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

回應

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

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,
      "pointInTimeRecoveryEnabled": false
    }
  }
}

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

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

您應該會收到如下的 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-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

檢查用於 PITR 的交易記錄儲存位置

您可以查看 Cloud SQL 執行個體儲存用於 PITR 的交易記錄位置。

gcloud

如要判斷執行個體是否將 PITR 的記錄檔儲存在磁碟或 Cloud Storage 上，請使用下列指令：

   gcloud sql instances describe INSTANCE_NAME

將 INSTANCE_NAME 替換為執行個體的名稱。

如果專案中有多個執行個體，您也可以查看交易記錄的儲存位置。如要判斷多個執行個體的位置，請使用下列指令：

   gcloud sql instances list --show-transactional-log-storage-state

回應範例：

NAME  DATABASE_VERSION LOCATION         TRANSACTIONAL_LOG_STORAGE_STATE
my_01 POSTGRES_12      us-central-1     DISK
my_02 POSTGRES_12      us-central-1     CLOUD_STORAGE
...

在指令輸出中，「transactionalLogStorageState」欄位或「TRANSACTIONAL_LOG_STORAGE_STATE」欄會提供例項的 PITR 交易記錄儲存位置資訊。交易記錄的可能儲存狀態如下：

DISK：執行個體會將用於時間點復原的交易記錄儲存在磁碟上。如果將 Cloud SQL Enterprise 版執行個體升級為 Cloud SQL Enterprise Plus 版，升級程序會自動將記錄儲存位置切換為 Cloud Storage。詳情請參閱使用就地升級功能，將執行個體升級為 Cloud SQL Enterprise Plus 版本。您也可以選擇使用 gcloud CLI 或 Cloud SQL Admin API 切換儲存空間位置，無需升級執行個體版本，也不會造成任何停機時間。詳情請參閱「將交易記錄儲存空間切換至 Cloud Storage」。
SWITCHING_TO_CLOUD_STORAGE：執行個體會將時間點復原 (PITR) 交易記錄的儲存位置切換至 Cloud Storage。
SWITCHED_TO_CLOUD_STORAGE：執行個體已完成將 PITR 交易記錄的儲存位置從磁碟切換至 Cloud Storage。
CLOUD_STORAGE：執行個體會將用於 PITR 的交易記錄儲存在 Cloud Storage 中。

將交易記錄儲存空間切換為 Cloud Storage

如果執行個體將用於 PITR 的交易記錄儲存在磁碟上，您可以將儲存位置切換至 Cloud Storage，不會造成任何停機時間。切換儲存位置的整體程序大約需要交易記錄保留期限 (天數) 才能完成。開始切換後，交易記錄就會開始在 Cloud Storage 中累積。作業期間，您可以使用「檢查用於 PITR 的交易記錄儲存位置」中的指令，查看整體程序的狀態。

切換至 Cloud Storage 的整體程序完成後，Cloud SQL 會使用 Cloud Storage 中的交易記錄進行 PITR。

gcloud

如要將儲存位置切換為 Cloud Storage，請使用下列指令：

   gcloud sql instances patch INSTANCE_NAME \
      --switch-transaction-logs-to-cloud-storage

將 INSTANCE_NAME 替換為執行個體的名稱。執行個體必須是主要執行個體，不得為副本執行個體。回應類似以下內容：

The following message is used for the patch API method.
{"name": "INSTANCE_NAME", "project": "PROJECT_NAME", "switchTransactionalLogsToCloudStorageEnabled": "true"}

Patching Cloud SQL instance...done.
Updated
[https://sqladmin.prod.googleapis.com/v1/projects/PROJECT_NAME/instances/INSTANCE_NAME].

如果指令傳回錯誤，請參閱「排解切換至 Cloud Storage 的問題」，瞭解可能的後續步驟。

REST v1

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：專案 ID。
INSTANCE_ID：執行個體 ID。執行個體必須是主要執行個體，不得為副本執行個體。

HTTP 方法和網址：

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

JSON 要求主體：

{
   "switchTransactionLogsToCloudStorageEnabled": true
}

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

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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

回應

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

如果要求傳回錯誤，請參閱「排解切換至 Cloud Storage 的問題」，瞭解可能的後續步驟。

REST v1beta4

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：專案 ID。
INSTANCE_ID：執行個體 ID。執行個體必須是主要執行個體，不得為副本執行個體。

HTTP 方法和網址：

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

JSON 要求主體：

{
   "switchTransactionLogsToCloudStorageEnabled": true
}

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

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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

回應

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

如果要求傳回錯誤，請參閱「排解切換至 Cloud Storage 的問題」，瞭解可能的後續步驟。

設定交易記錄保留期限

如要設定保留預先寫入記錄的天數，請按照下列步驟操作：

控制台

前往 Trusted Cloud 控制台的「Cloud SQL Instances」頁面。

前往 Cloud SQL 執行個體
找到要設定交易記錄的執行個體，開啟更多動作選單，然後選取「編輯」。
展開「自訂執行個體」下方的「資料保護」專區。
在「Enable point-in-time recovery」(啟用時間點復原) 區段中，展開「Advanced options」(進階選項)。
輸入記錄保留天數。如果是 Cloud SQL Enterprise Plus 版本，天數範圍為 1 到 35 天；如果是 Cloud SQL Enterprise 版本，天數範圍為 1 到 7 天。
按一下 [儲存]。

gcloud

編輯執行個體，設定要保留預先寫入記錄的天數。

更改下列內容：

INSTANCE_NAME：要設定交易記錄的執行個體名稱。
DAYS_TO_RETAIN：要保留的交易記錄天數。如果是 Cloud SQL Enterprise Plus 版本，有效範圍介於 1 到 35 天，預設為 14 天。如果是 Cloud SQL Enterprise 版，有效範圍介於 1 到 7 天，預設為 7 天。

如未指定值，Cloud SQL 會使用預設值。只有在啟用 PITR 時才有效。保留更多天數的交易記錄檔需要較大的儲存空間。

  gcloud sql instances patch INSTANCE_NAME 

    --retained-transaction-log-days=DAYS_TO_RETAIN

REST v1

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：專案 ID。
INSTANCE_ID：執行個體 ID。
DAYS_TO_RETAIN：交易記錄的保留天數。如果是 Cloud SQL Enterprise Plus 版本，有效範圍介於 1 到 35 天，預設為 14 天。如果是 Cloud SQL Enterprise 版，有效範圍介於 1 到 7 天，預設為 7 天。

如未指定任何值，則會使用預設值。只有在啟用 PITR 時才有效。保留更多天數的交易記錄需要較大的儲存空間。

HTTP 方法和網址：

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

JSON 要求主體：

{
  "settings":
  {
    "backupConfiguration":
    {
      "transactionLogRetentionDays": "DAYS_TO_RETAIN"
    }
  }
}

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

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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

回應

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

REST v1beta4

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：專案 ID。
INSTANCE_ID：執行個體 ID。
DAYS_TO_RETAIN：交易記錄的保留天數。如果是 Cloud SQL Enterprise Plus 版本，有效範圍介於 1 到 35 天，預設為 14 天。如果是 Cloud SQL Enterprise 版，有效範圍介於 1 到 7 天，預設為 7 天。

如未指定任何值，則會使用預設值。只有在啟用 PITR 時才有效。保留更多天數的交易記錄需要較大的儲存空間。

HTTP 方法和網址：

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

JSON 要求主體：

{
  "settings":
  {
    "backupConfiguration":
    {
      "transactionLogRetentionDays": "DAYS_TO_RETAIN"
    }
  }
}

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

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

您應該會收到如下的 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-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

疑難排解

問題疑難排解

問題	疑難排解
`argument --point-in-time: Failed to parse date/time: Unknown string format: 2021-0928T30:54:03.094; received: 2021-0928T30:54:03.094Z` 或 `Invalid value at 'body.clone_context.point_in_time' (type.googleapis.com/google.protobuf.Timestamp), Field 'pointInTime', Invalid time format: Failed to parse input,`	您提供的时间戳记无效。
`HTTP Error 400: Successful backup required for carrying out the operation was not found.` 或 `Successful backup required for carrying out the operation was not found. or Time where no backups can be found.`	您提供時間戳記的時間點無法找到備份或 binlog 座標。

argument --point-in-time: Failed to parse date/time: Unknown string format: 2021-0928T30:54:03.094; received: 2021-0928T30:54:03.094Z

或

Invalid value at 'body.clone_context.point_in_time' (type.googleapis.com/google.protobuf.Timestamp), Field 'pointInTime', Invalid time format: Failed to parse input,

您提供的时间戳记无效。

HTTP Error 400: Successful backup required for carrying out the operation was not found.

或

Successful backup required for carrying out the operation was not found. or Time where no backups can be found.

您提供時間戳記的時間點無法找到備份或 binlog 座標。

排解切換至 Cloud Storage 的相關問題

下表列出將交易記錄的儲存位置從磁碟切換至 Cloud Storage 時，可能會傳回的 INVALID REQUEST 程式碼錯誤。

問題	疑難排解
`Switching the storage location of the transaction logs used for PITR is not supported for instances with database type %s.`	請確認您是在 MySQL 適用的 Cloud SQL 或 PostgreSQL 適用的 Cloud SQL 執行個體上，執行 gcloud CLI 指令或發出 API 要求。Cloud SQL for SQL Server 不支援使用 gcloud CLI 或 Cloud SQL Admin API 切換交易記錄的儲存位置。
`PostgreSQL transactional logging is not enabled on this instance.`	PostgreSQL 會使用預先寫入記錄做為交易記錄，以執行時間點復原 (PITR)。如要支援 PITR，PostgreSQL 必須在執行個體上啟用預寫記錄。如要進一步瞭解如何啟用預先寫入記錄，請參閱「啟用 PITR」。
`This instance is already storing transaction logs used for PITR in Cloud Storage`	如要驗證交易記錄的儲存位置，請在「檢查用於 PITR 的交易記錄儲存位置」中執行指令。
`The instance is already switching transaction logs used for PITR from disk to Cloud Storage.`	等待切換作業完成。如要驗證作業狀態和交易記錄的儲存位置，請在「檢查用於 PITR 的交易記錄儲存位置」中執行指令。

後續步驟

在副本上設定旗標