無論主要 Cloud SQL 執行個體是否已刪除,您都可以使用時間點復原 (PITR) 功能還原。PITR 可讓您將執行個體還原至特定時間點。時間點復原一律會建立新的執行個體,您無法對現有的執行個體執行 PITR。
Cloud SQL 提供下列選項,可使用 PITR 還原執行個體:
如要對無法使用或已刪除的執行個體執行 PITR,您必須找出最早和最晚的復原時間。
使用時間戳記執行 PITR
建議使用時間戳記執行 PITR。Cloud SQL 會使用 mysqlbinlog 公用程式,將執行個體還原至特定時間點。如要進一步瞭解 mysqlbinlog 公用程式,請參閱 MySQL 參考文件。
如要完成下列工作,您必須具備以下條件:
- 執行個體已啟用二進位記錄和備份功能,且自上次備份以來,在您要復原的事件發生前,持續產生二進位記錄。詳情請參閱「啟用二進位記錄」。
- 定義復原點的時間戳記。在這個時間戳記或之後發生的事件,不會反映在新的執行個體中。
控制台
-
前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。
- 開啟要復原的執行個體的「更多動作」選單
,然後按一下「建立複製版本」。 - (選用) 在「Create a clone」(建立複製版本) 頁面中,更新新複製版本的 ID。
- 選取「Clone from an earlier point in time」(從過去時間點複製資料)。
- 輸入 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"
}
}
請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
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"
}
}
請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
使用 backup vault 執行 PITR
如果 Cloud SQL 執行個體已啟用進階備份功能,您可以使用 backup vault 對執行個體執行時間點復原。如果 backup vault 與執行個體位於不同區域,則只能將 PITR 復原至與來源執行個體位於相同區域的新執行個體。詳情請參閱「跨區域備份」。
控制台
前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。
開啟要復原的執行個體的「更多動作」選單
,然後按一下「建立複製版本」。選取「Clone from an earlier point in time」(從過去時間點複製資料)。
輸入 PITR 時間。
按一下 [建立本機複本]。
gcloud
如要從備份保管箱對執行個體執行 PITR,您必須找出最接近目標 PITR 時間的備份 data-source。如果您不確定確切的資料來源,或有多個資料來源,請參閱「尋找並驗證 PITR 的資料來源」。找出資料來源後,請執行 gcloud sql instances point-in-time-restore 指令:
gcloud sql instances point-in-time-restore DATA_SOURCE \
TARGET_INSTANCE_NAME \
'PITR_TIMESTAMP' \
--project=TARGET_PROJECT \
--region=REGION
更改下列內容:
DATA_SOURCE:來源執行個體的data-source路徑,最接近您要復原的時間點復原時間戳記。TARGET_INSTANCE_NAME:PITR 作業建立的新執行個體名稱。PITR_TIMESTAMP:要還原執行個體的來源執行個體 PITR 記錄世界標準時間戳記,格式為 RFC 3339。例如 2025-11-15T16:19:00.094Z。TARGET_PROJECT:新執行個體的專案 ID。REGION:目標執行個體的區域。如果來源執行個體的資料來源位於多區域,或與來源執行個體位於不同區域,則必須填寫這個欄位。目標執行個體區域必須與來源執行個體區域相同。
REST v1
如要使用備份保管庫中的資料來源執行時間點復原,請透過 POST 要求使用 instances.pointInTimeRestore 方法。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID:要建立新執行個體的專案 ID。
- DATASOURCE:要用於時間點還原作業的備份和災難復原資料來源。
- PITR_TIMESTAMP:要還原執行個體的來源執行個體 PITR 記錄世界標準時間戳記,格式為 RFC 3339。例如 2012-11-15T16:19:00.094Z。
- TARGET_INSTANCE_NAME:PITR 作業建立的執行個體名稱。
- REGION:目標執行個體的區域。如果來源執行個體的資料來源位於多區域,則必須填寫這個欄位。目標執行個體區域必須與來源執行個體區域相同。
HTTP 方法和網址:
POST https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID:pointInTimeRestore
JSON 要求主體:
{
"datasource": "DATASOURCE",
"pointInTime": "PITR_TIMESTAMP",
"targetInstanceName": "TARGET_INSTANCE_NAME",
"region": "REGION"
}
請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
REST v1beta4
如要使用備份保管庫中的資料來源執行時間點復原,請透過 POST 要求使用 instances.pointInTimeRestore 方法。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID:要建立新執行個體的專案 ID。
- DATASOURCE:要用於時間點還原作業的備份和災難復原資料來源。
- PITR_TIMESTAMP:要還原執行個體的來源執行個體 PITR 記錄世界標準時間戳記,格式為 RFC 3339。例如 2012-11-15T16:19:00.094Z。
- TARGET_INSTANCE_NAME:PITR 作業建立的執行個體名稱。
- REGION:目標執行個體的區域。如果來源執行個體的資料來源位於多區域,則必須填寫這個欄位。目標執行個體區域必須與來源執行個體區域相同。
HTTP 方法和網址:
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID:pointInTimeRestore
JSON 要求主體:
{
"datasource": "DATASOURCE",
"pointInTime": "PITR_TIMESTAMP",
"targetInstanceName": "TARGET_INSTANCE_NAME",
"region": "REGION"
}
請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
執行跨專案 PITR
使用進階備份功能,您可以將 Cloud SQL 執行個體還原至來源執行個體或 backup vault 所在專案以外的專案。
跨專案 PITR 僅支援透過 gcloud CLI 和 REST API 執行。
如要執行跨專案 PITR,請執行下列任一操作:
如果您使用 gcloud CLI,請將
--project旗標設為要建立目標執行個體的專案。如果使用 REST API,請將
PROJECT_ID欄位設為要建立目標執行個體的專案。
對無法使用的執行個體執行 PITR
控制台
基於下列原因,您可能需要將無法使用的執行個體復原至其他可用區:
- 無法存取執行個體設定的可用區。這個執行個體處於
FAILED狀態。 - 執行個體維護中。這個執行個體處於
MAINTENANCE狀態。
如要復原無法使用的執行個體,請完成下列步驟:
-
前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。
- 找出要複製的執行個體資料列。
- 在「Actions」(動作) 欄中,按一下 「More Actions」(更多動作) 選單。
- 按一下 [建立本機複本]。
- 在「Create a clone」(建立複製版本) 頁面中,完成下列操作:
- 在「Instance ID」(執行個體 ID) 欄位中,視需要更新執行個體 ID。
- 按一下「Clone from an earlier point in time」(從過去時間點複製資料)。
- 在「Point in time」(時間點) 欄位中,選取要複製資料的日期和時間。這項作業會將執行個體復原為目標時間當下的狀態。
- 按一下 [建立本機複本]。
複製作業初始化期間,系統會將您導回執行個體清單頁面。
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 和 cloudsql.instances.create 權限。如要進一步瞭解執行 gcloud CLI 指令所需的權限,請參閱「Cloud SQL 權限」。
REST v1
如果執行個體設定的可用區無法存取,您可能需要將無法使用的執行個體復原至其他可用區。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID:專案 ID
- SOURCE_INSTANCE_ID:來源執行個體 ID
- TARGET_INSTANCE_ID:目標執行個體 ID
HTTP 方法和網址:
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone
JSON 要求主體:
{
"cloneContext":
{
"destinationInstanceName": "TARGET_INSTANCE_ID"
}
}請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
使用 instances.clone API 方法的使用者或服務帳戶,必須具備 cloudsql.instances.clone 和 cloudsql.instances.create 權限。如要進一步瞭解使用 API 方法所需的權限,請參閱「Cloud SQL 權限」。
REST v1beta4
如果執行個體設定的可用區無法存取,您可能需要將無法使用的執行個體復原至其他可用區。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID:專案 ID
- SOURCE_INSTANCE_ID:來源執行個體 ID
- TARGET_INSTANCE_ID:目標執行個體 ID
HTTP 方法和網址:
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone
JSON 要求主體:
{
"cloneContext":
{
"destinationInstanceName": "TARGET_INSTANCE_ID"
}
}請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
使用 instances.clone API 方法的使用者或服務帳戶,必須具備 cloudsql.instances.clone 和 cloudsql.instances.create 權限。如要進一步瞭解使用 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.
對已刪除的執行個體執行時間點復原
如要使用 PITR 還原已刪除的執行個體,您需要:
- 要將執行個體還原至的時間點復原時間戳記 (
timestamp) - 目標執行個體名稱
- 來源執行個體刪除時間 (
source-instance-deletion-time)
您只能使用 gcloud CLI 或 Cloud SQL API,在已刪除的執行個體上使用 PITR。詳情請參閱「使用 PITR 還原已刪除的執行個體」。
gcloud
標準級備份
找出 PITR 時間範圍
如要找出已刪除執行個體的時間點復原 (PITR) 視窗,請取得執行個體的最早和最晚復原時間。您可以在這個視窗中選取任何時間戳記,執行時間點復原作業。
尋找來源執行個體刪除作業
刪除執行個體後,系統會將刪除執行個體的 source-instance-deletion-time 和 log-retention-days 與執行個體的保留備份一併儲存。如要查看已刪除執行個體的所有可用備份清單,請參閱「列出保留的備份」。
找出要使用的備份後,請執行 gcloud sql backups describe 指令,取得 source-instance-deletion-time。
使用 PITR 還原
如要使用 PITR 還原已刪除的執行個體,請執行下列指令:
gcloud sql instances clone SOURCE_INSTANCE_NAME \
NEW_INSTANCE_NAME \
--point-in-time='PITR_TIMESTAMP' \
--source-instance-deletion-time=SOURCE_INSTANCE_DELETION_TIMESTAMP
更改下列內容:
SOURCE_INSTANCE_NAME:要還原的來源執行個體名稱。NEW_INSTANCE_NAME:新執行個體的名稱。PITR_TIMESTAMP:要還原執行個體的來源執行個體 PITR 記錄世界標準時間戳記,格式為 RFC 3339。例如 2012-11-15T16:19:00.094Z。SOURCE_INSTANCE_DELETION_TIMESTAMP:來源執行個體刪除時間的世界標準時間戳記,格式為 RFC 3339。例如 2012-11-15T16:19:00.094Z。
進階級備份
找出 PITR 時間範圍
如要找出已刪除執行個體的時間點復原 (PITR) 視窗,請取得執行個體的最早和最晚復原時間。您可以在這個視窗中選取任何時間戳記,執行時間點復原作業。
找出資料來源
刪除執行個體後,系統會將刪除執行個體的資料來源與保留的備份一併儲存。如要找出已刪除執行個體的這些值,請參閱「列出執行個體備份保存庫中的所有備份」或「尋找並驗證 PITR 的資料來源」。
使用 PITR 還原
如要使用 PITR 還原已刪除的執行個體,請執行下列指令:
gcloud sql instances point-in-time-restore DATA_SOURCE \
TARGET_INSTANCE_NAME \
'PITR_TIMESTAMP' \
--project=TARGET_PROJECT \
--region=REGION
更改下列內容:
DATA_SOURCE:備份的data-source路徑,最接近您要復原的時間點復原時間戳記。TARGET_INSTANCE_NAME:PITR 作業建立的新執行個體名稱。PITR_TIMESTAMP:要還原執行個體的來源執行個體 PITR 記錄世界標準時間戳記,格式為 RFC 3339。例如 2025-11-15T16:19:00.094Z。TARGET_PROJECT:新執行個體的專案 ID。REGION:目標執行個體的區域。如果來源執行個體的資料來源位於多區域,或與來源執行個體位於不同區域,則必須填寫這個欄位。目標執行個體區域必須與來源執行個體區域相同。
REST v1
找出 PITR 時間範圍
如要找出已刪除執行個體的時間點復原 (PITR) 視窗,請取得執行個體的最早和最晚復原時間。您可以在這個視窗中選取任何時間戳記,執行時間點復原作業。
查看來源執行個體刪除時間和記錄檔保留天數
刪除執行個體後,系統會將刪除執行個體的 source-instance-deletion-time 和 log-retention-days 與執行個體的保留備份一併儲存。如要查看已刪除執行個體的這些值,請參閱「列出保留的備份」。
使用 PITR 還原
使用任何要求資料之前,請先修改下列項目的值:
- project-id:專案 ID
- target-instance-id:目標執行個體 ID
- source-instance-id:來源執行個體 ID
- source-instance-deletion-time:來源執行個體的刪除時間
- 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",
"sourceInstanceDeletionTime: "source-instance-deletion-time",
"pointInTime": "restore-timestamp"
}
}
請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
REST v1beta4
找出 PITR 時間範圍
如要找出已刪除執行個體的時間點復原 (PITR) 視窗,請取得執行個體的最早和最晚復原時間。您可以在這個視窗中選取任何時間戳記,執行時間點復原作業。
查看來源執行個體刪除時間和記錄檔保留天數
刪除執行個體後,系統會將刪除執行個體的 source-instance-deletion-time 和 log-retention-days 與執行個體的保留備份一併儲存。如要查看已刪除執行個體的這些值,請參閱「列出保留的備份」。
使用 PITR 還原
使用任何要求資料之前,請先修改下列項目的值:
- project-id:專案 ID
- target-instance-id:目標執行個體 ID
- source-instance-id:來源執行個體 ID
- source-instance-deletion-time:來源執行個體的刪除時間
- 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",
"sourceInstanceDeletionTime: "source-instance-deletion-time",
"pointInTime": "restore-timestamp"
}
}
請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
使用二進位記錄位置執行 PITR
建議您按照「使用時間戳記執行 PITR」一節所述,使用時間戳記執行 PITR,但您也可以在二進位記錄檔中提供特定二進位記錄位置或事件位置,藉此執行 PITR。
如要進一步瞭解如何使用二進位記錄位置進行 PITR,請參閱「使用二進位記錄進行 PITR」。
事前準備
完成此工作之前,您必須已完成下列作業:
執行個體已啟用二進位記錄和備份功能,且自上次備份以來,持續產生二進位記錄,直到您要復原的事件發生為止。詳情請參閱「啟用二進位記錄」。
二進位記錄必須位於磁碟上,您才能瀏覽事件。如要查看磁碟上二進位記錄的保留長度,請參閱「設定交易記錄保留」。詳情請參閱「記錄檔保留期限」。您無法使用
mysqlbinlog公用程式瀏覽儲存在 Cloud Storage 中的二進位記錄。二進位記錄檔名稱,以及要復原的事件位置 (該事件和之後的所有事件都不會反映在新執行個體中)。詳 ion 請參閱「找出二進位記錄位置」。
找出二進位記錄檔名稱和位置後,請使用二進位記錄事件位置執行 PITR。
確認復甦姿勢
使用 MySQL 用戶端連線至要還原的執行個體。
請使用 Cloud Shell 或本機用戶端機器。詳情請參閱「外部應用程式的連線選項」。
顯示執行個體的二進位記錄檔:
SHOW BINARY LOGS;顯示最新二進位記錄檔中的前 100 個事件:
SHOW BINLOG EVENTS IN '<BINARY_LOG_FILE>' LIMIT 100;您可以調整要顯示的列數,但請先確認檔案大小,再決定是否要顯示檔案中的所有事件。顯示大量事件可能會影響系統效能。
如果找不到所需事件,請以最後顯示的位置為起點,搜尋下一組事件:
SHOW BINLOG EVENTS IN '<BINARY_LOG_FILE>' FROM <POSITION> LIMIT 100;找到要還原的時間點事件後,請記下位置 (顯示為
Pos) 和二進位記錄檔名稱。二進位記錄檔名稱和位置是您用於 PITR 的值。
以下是 SHOW BINLOG EVENTS 指令的輸出範例:
+------------------+-----+-------------+-----------+-------------+-----------------------------------------------------+ | Log_name | Pos | Event_type | Server_id | End_log_pos | Info | +------------------+-----+-------------+-----------+-------------+-----------------------------------------------------+ | mysql-bin.000011 | 4 | Format_desc | 88955285 | 120 | Server ver: 5.6.30-log, Binlog ver: 4 | | mysql-bin.000011 | 120 | Query | 88955285 | 211 | create database db1 | | mysql-bin.000011 | 211 | Query | 88955285 | 310 | use `db1`; CREATE TABLE t (c CHAR(20)) | | mysql-bin.000011 | 310 | Query | 88955285 | 381 | BEGIN | | mysql-bin.000011 | 381 | Table_map | 88955285 | 426 | table_id: 18 (db1.t) | | mysql-bin.000011 | 310 | Query | 88955285 | 381 | BEGIN | | mysql-bin.000011 | 426 | Write_rows | 88955285 | 464 | table_id: 18 flags: STMT_END_F | | mysql-bin.000011 | 464 | Xid | 88955285 | 495 | COMMIT /* xid=56 */ | | mysql-bin.000011 | 495 | Query | 88955285 | 566 | BEGIN | | mysql-bin.000011 | 566 | Table_map | 88955285 | 611 | table_id: 18 (db1.t) | | mysql-bin.000011 | 611 | Write_rows | 88955285 | 649 | table_id: 18 flags: STMT_END_F | | mysql-bin.000011 | 649 | Xid | 88955285 | 680 | COMMIT /* xid=57 */ | | mysql-bin.000011 | 680 | Query | 88955285 | 751 | BEGIN | | mysql-bin.000011 | 751 | Table_map | 88955285 | 796 | table_id: 18 (db1.t) | | mysql-bin.000011 | 796 | Write_rows | 88955285 | 834 | table_id: 18 flags: STMT_END_F | | mysql-bin.000011 | 834 | Xid | 88955285 | 865 | COMMIT /* xid=58 */ | | mysql-bin.000011 | 865 | Query | 88955285 | 977 | use `db1`; DROP TABLE `t` /* generated by server */ | +------------------+-----+-------------+-----------+-------------+-----------------------------------------------------+ 16 rows in set (0.04 sec)
如要還原至 DROP TABLE 陳述式 (在上述範例中以粗體顯示),請使用 mysql-bin.000011 中的 865 做為復原位置。DROP TABLE 陳述式和其後的所有作業都不會反映在新執行個體中。
使用二進位記錄事件位置執行 PITR
gcloud
使用 gcloud sql instances clone 指令,並加上 --bin-log-file-name 和 --bin-log-position 旗標。
-
使用二進位記錄檔名稱和復原位置建立新執行個體。
更改下列內容:
- SOURCE_INSTANCE_NAME:要還原的執行個體名稱。
- NEW_INSTANCE_NAME:複製項目的名稱。
- BINLOG_FILE_NAME:二進位記錄檔的名稱,例如
mysql-bin.187288。 - POSITION:二進位記錄中要還原到的位置,例如
50001356。
gcloud sql instances clone SOURCE_INSTANCE_NAME \ NEW_INSTANCE_NAME \ --bin-log-file-name="BINLOG_FILE_NAME" \ --bin-log-position=POSITION
例如,
gcloud sql instances clone指令可能如下所示:gcloud sql instances clone instance1 \ instance1-clone \ --bin-log-file-name=mysql-bin.0000031 \ --bin-log-position=107
- 使用
clone指令傳回的作業 ID,檢查還原作業的狀態。gcloud sql operations describe OPERATION_ID
作業進行中時,系統會傳回
RUNNING狀態。作業完成後,系統會傳回DONE狀態。
REST v1
使用您找到的二進位記錄檔名稱和復原位置,建立新的執行個體:
使用任何要求資料之前,請先修改下列項目的值:
- project-id:專案 ID
- target-instance-id:目標執行個體 ID
- source-instance-id:來源執行個體 ID
- binary-log-file-name:二進位記錄檔的名稱
- binary-log-position 二進位記錄檔中的位置
HTTP 方法和網址:
POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone
JSON 要求主體:
{
"cloneContext":
{
"kind": "sql#cloneContext",
"destinationInstanceName": "target-instance-id",
"binLogCoordinates":
{
"kind": "sql#binLogCoordinates",
"binLogFileName": "binary-log-file-name",
"binLogPosition": "binary-log-position"
}
}
}
請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
REST v1beta4
使用您找到的二進位記錄檔名稱和復原位置,建立新的執行個體:
使用任何要求資料之前,請先修改下列項目的值:
- project-id:專案 ID
- target-instance-id:目標執行個體 ID
- source-instance-id:來源執行個體 ID
- binary-log-file-name:二進位記錄檔的名稱
- binary-log-position 二進位記錄檔中的位置
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",
"binLogCoordinates":
{
"kind": "sql#binLogCoordinates",
"binLogFileName": "binary-log-file-name",
"binLogPosition": "binary-log-position"
}
}
}
請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
取得最早和最晚的復原時間
對於可用的執行個體,您可以在執行個體的 PITR 視窗中,對任何時間戳記執行 PITR。PITR 期間從最早復原時間開始,到最晚復原時間結束。如果執行個體無法使用,且執行個體記錄儲存在 Cloud Storage 中,或是執行個體已刪除且啟用 PITR 保留功能,您就能擷取最早和最晚的復原時間,並將 PITR 執行至該時間範圍內的任何時間戳記。在所有情況下,您都可以提供偏好可用區的值,將執行個體還原至不同的主要或次要可用區。
gcloud
無法使用的執行個體
如要取得無法使用的 Cloud SQL 執行個體可復原的最早和最晚時間,請執行下列指令:
gcloud sql instances get-latest-recovery-time INSTANCE_NAME
更改下列內容:
INSTANCE_NAME:要查詢最新復原時間的執行個體名稱。
已刪除執行個體
如要取得可復原 Cloud SQL 已刪除執行個體的最早和最晚時間,請執行下列指令:
gcloud sql instances get-latest-recovery-time INSTANCE_NAME \
--source-instance-deletion-time='SOURCE_INSTANCE_DELETION_TIMESTAMP'
更改下列內容:
INSTANCE_NAME:要查詢最新復原時間的執行個體名稱。SOURCE_INSTANCE_DELETION_TIMESTAMP:來源執行個體刪除時間的世界標準時間戳記,格式為 RFC 3339。例如 2012-11-15T16:19:00.094Z。
REST v1
無法使用的執行個體
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID:專案 ID
- INSTANCE_NAME::要查詢最新復原時間的執行個體名稱
HTTP 方法和網址:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime
請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
{
"kind": "sql#getLatestRecoveryTime",
"earliestRecoveryTime": "2023-06-10T17:23:59.648821586Z",
"latestRecoveryTime": "2023-06-20T17:23:59.648821586Z"
}
已刪除執行個體
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID:專案 ID
- INSTANCE_NAME:要查詢最新復原時間的來源執行個體名稱
- SOURCE_INSTANCE_DELETION_TIME:刪除來源執行個體的時間
HTTP 方法和網址:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime
請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
{
"kind": "sql#getLatestRecoveryTime",
"earliestRecoveryTime": "2023-06-10T17:23:59.648821586Z",
"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
請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
{
"kind": "sql#getLatestRecoveryTime",
"earliestRecoveryTime": "2023-06-10T17:23:59.648821586Z",
"latestRecoveryTime": "2023-06-20T17:23:59.648821586Z"
}
已刪除執行個體
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID:專案 ID
- INSTANCE_NAME:要查詢最新復原時間的來源執行個體名稱
- SOURCE_INSTANCE_DELETION_TIME:刪除來源執行個體的時間
HTTP 方法和網址:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/getLatestRecoveryTime
請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
{
"kind": "sql#getLatestRecoveryTime",
"earliestRecoveryTime": "2023-06-10T17:23:59.648821586Z",
"latestRecoveryTime": "2023-06-20T17:23:59.648821586Z"
}
疑難排解
| 問題 | 疑難排解 |
|---|---|
|
或
|
您提供的時間戳記無效。 |
|
或
|
您提供的時間戳記是備份或找不到二進位記錄檔座標的時間。 |
後續步驟
- 在複製版本上設定旗標