具有連續備份模式的 Azure Cosmos DB 帳戶的最新可還原時間戳記

適用於：NoSQL MongoDB Gremlin 桌子

Azure Cosmos DB 提供 API 以取得容器的最新可還原時間戳記。 此 API 適用於已啟用連續備份模式的帳戶。 最新的可還原時間戳代表 UTC 格式的最新時間戳，您的數據已成功備份。 您可以使用此 API 取得可還原時間戳記來觸發即時帳戶還原，或監視是否準時備份您的資料。

此 API 也接受帳戶位置作為輸入參數，並傳回這個位置中指定容器的最新可還原時間戳記。 如果帳戶存在於多個位置，則不同位置中的容器可能會有不同的最新可還原時間戳記，因為每個位置中的備份都會獨立進行。

根據預設，此 API 只能在容器層級運作，但可以輕鬆地擴充以在資料庫或帳戶層級工作。 本文可協助您瞭解 api 的語意、其計算方式和使用案例。 若要深入了解，請針對適用於 NoSQL、MongoDB、Table 和 Gremlin 帳戶的 API，參閱如何取得最新還原時間戳記。

使用案例

您可以在下列使用案例中使用最新可還原時間戳記：

• 您可以取得容器、資料庫或帳戶的最新可還原時間戳記，並使用它來觸發還原。 此時間戳代表指定資源的數據或其所有基礎資源已成功備份。

• 您可以使用此 API 來識別您的資料在刪除帳戶之前已成功備份。 如果此 API 傳回的時間戳小於上次寫入時間戳，則表示有一些尚未備份的數據。 在此情況下，您必須在時間戳記變成等於或大於上次寫入時間戳記之前，呼叫此 API。 如果帳戶存在於多個位置，您必須取得所有位置中最新的可還原時間戳，以確保在刪除帳戶之前，已在所有區域中備份數據。

• 您可以使用此 API 來監視是否準時備份您的資料。 此時間戳記通常會在目前時間戳記的幾百秒內，但有時可能會相差更多。

語意

容器的最新可還原時間戳是最多時間戳，會備份其位置中的所有分割區。 此 API 會擷取位置中容器每個分割區的最新備份時間戳，並傳回所有這些時間戳的最小時間戳，以計算最新的可還原時間戳。 如果備份其所有數據分割的數據，而且沒有新數據寫入這些數據分割，則會傳回目前時間戳和最後一個數據備份時間戳的最大值。

如果分割區尚未進行任何備份，但有一些要備份的資料，則會傳回最小 Unix (Epoch) 時間戳記，也就是 1970 年 1 月 1 日午夜 UTC (國際標準時間)。 在此情況下，使用者必須重試，直到提供的時間戳記大於 Epoch 時間戳記為止。

最新可還原時間戳記計算

下列範例說明不同案例中最新可還原時間戳 API 的預期結果。 在每個案例中，我們會討論分割區目前的記錄備份狀態、要備份的暫止數據，以及它如何影響容器的整體最新可還原時間戳計算。

假設我們有一個帳戶，存在於兩個區域（美國東部，美國西部）。 我們有一個容器 「cont1」 ，它有兩個分割區 （Partition1，Partition2）。 如果我們傳送要求以取得此容器在時間戳記 't3' 的最新可還原時間戳記，則此容器的整體最新可還原時間戳記計算如下：

案例 1：尚未備份所有分割區的資料

美國東部區域：

• 分割區 1：上次備份時間 = t2，但在 t2 之後有一些要備份的資料。
• 分割區 2：上次備份時間 = t3，並會備份其所有資料。
• 最新可還原時間戳記 = min (t2, t3) = t2

美國西部區域：

• 分割區 1：上次備份時間 = t1，但在 t1 之後有一些要備份的資料。
• 分割區 2：上次備份時間 = t2，但在 t2 之後有一些要備份的資料。
• 最新可還原時間戳記 = min (t1, t2) = t1

案例 2：備份所有分割區的資料

美國東部區域：

• 分割區 1：上次備份時間 = t2，並會備份其所有資料。
• 分割區 2：上次備份時間 = t3，並會備份其所有資料。
• 最新可還原時間戳記 = max (目前時間戳記, t2, t3)

美國西部區域：

• 分割區 1：上次備份時間 = t3，並會備份其所有資料。
• 分割區 2：上次備份時間 = t3，並會備份其所有資料。
• 最新可還原時間戳記 = max (目前時間戳記, t3, t3)

案例 3：一或多個分割區尚未進行任何備份

美國東部區域：

• 分割區 1：尚未針對此分割區進行任何記錄備份。
• 分割區 2：上次備份時間 = t3
• 最新可還原時間戳記 = 1/1/1970 12:00:00 AM

常見問題集

我可以針對具有定期備份的帳戶使用此 API 嗎？

否。 此 API 只能用於具有連續備份模式的帳戶。

我可以針對移轉到連續模式的帳戶使用此 API 嗎？

是。 此 API 可用於已佈建連續備份模式的帳戶，或成功移轉到連續備份模式的帳戶。

最新寫入時間戳記與最新可還原時間戳記之間的一般延遲為何？

記錄備份資料會每隔 100 秒備份一次。 不過，在某些例外情況下，備份可能會延遲超過 100 秒。

可還原的時間戳是否適用於已刪除的資源？

否。 它只適用於即時資源（資料庫、集合或帳戶）。 您可以取得可還原時間戳記來觸發即時帳戶還原，或監視是否準時備份您的資料。

下一步

• 具有時間點還原的連續備份模式簡介

• 連續備份模式資源模型

• 使用 Azure 入口網站設定和管理連續備份模式。