Obter o carimbo de data/hora restaurável mais recente para contas do Azure Cosmos DB com o modo de backup contínuo
APLICA-SE AO: 
NoSQL MongoDB Gremlin Table
O Azure Cosmos DB oferece uma API para obter o carimbo de data/hora restaurável mais recente de um contêiner. Essa API está disponível para contas que têm o modo de backup contínuo habilitado. O carimbo de data/hora restaurável mais recente representa o carimbo de data/hora mais recente no formato UTC até o qual os dados foram copiados com êxito. Usando essa API, você pode obter o carimbo de data/hora restaurável para acionar a restauração da conta ativa ou monitorar se o backup dos dados está sendo feito a tempo.
Essa API também assume o local da conta como um parâmetro de entrada e retorna o carimbo de data/hora restaurável mais recente para o contêiner neste local. Se uma conta existir em vários locais, o prazo de restauração mais recente de um contêiner em locais diferentes poderá não ser igual, porque os backups em cada local são feitos de forma independente.
Por padrão, esta API só funciona no nível do contêiner, mas pode ser facilmente estendida para funcionar no nível do banco de dados ou da conta. Este artigo ajuda você a entender a semântica da API, como ela é calculada e os casos de uso para ela. Para saber mais, confira Obter o carimbo de data/hora restaurável mais recente para API das contas NoSQL, MongoDB, Table e Gremlin.
Casos de uso
Você pode usar o carimbo de data/hora restaurável mais recente nos seguintes casos de uso:
Você pode obter o carimbo de data/hora restaurável mais recente para um contêiner, banco de dados ou uma conta e usá-lo para disparar a restauração. Este carimbo de data/hora representa que o backup dos dados do recurso especificado ou de todos os seus recursos subjacentes foi realizado com êxito.
Você pode usar esta API para identificar que seus dados foram armazenados em backup com êxito antes de excluir a conta. Se o carimbo de data/hora retornado por esta API for menor que o último carimbo de data/hora de gravação, isso significará que ainda não houve backup de alguns dados. Nesse caso, você deve chamar essa API até que o carimbo de data/hora se torne igual ou maior que o último carimbo de data/hora de gravação. Se houver uma conta em vários locais, você deverá obter o carimbo de data/hora restaurável mais recente em todos os locais para verificar se os dados foram armazenados em backup em todas as regiões antes de excluir a conta.
Você pode usar essa API para monitorar se há backup dos seus dados a tempo. Esse carimbo de data/hora geralmente está dentro de algumas centenas de segundos do carimbo de data/hora atual, embora às vezes possa ter uma diferença para mais.
Semântica
O carimbo de data/hora restaurável mais recente para um contêiner é o carimbo de data/hora mínimo até o qual o backup de todas as suas partições em um local foi feito. Esta API calcula o carimbo de data/hora restaurável mais recente recuperando o carimbo de data/hora de backup mais recente para cada partição do contêiner em um local e retorna o carimbo de data/hora mínimo de todos esses carimbos de data/hora. Se os dados de todas as partições forem armazenados em backup e não houver novos dados gravados nessas partições, ela retornará o máximo de carimbo de data/hora atual e o último carimbo de data/hora de backup de dados.
Se uma partição ainda não tiver feito backup, mas tiver alguns dados para backup, ela retornará o carimbo de data/hora mínimo de Unix (época), ou seja, 1º de janeiro de 1970, meia-noite UTC (Hora Universal Coordenada). Nesses casos, o usuário deve tentar novamente até que haja um carimbo de data/hora maior do que o de época.
Cálculo de carimbo de data/hora restaurável mais recente
O exemplo a seguir descreve o resultado esperado da API de carimbo de data/hora restaurável mais recente em cenários diferentes. Em cada cenário, discutimos sobre o estado atual de backup de log da partição, bem como os dados pendentes a serem armazenados em backup e como isso afeta o cálculo geral do carimbo de data/hora restaurável mais recente para um contêiner.
Digamos que temos uma conta que existe em duas regiões (Leste dos EUA, Oeste dos EUA). Temos um contêiner "cont1", que tem duas partições (Partição1,Partição2). Se enviarmos uma solicitação para obter carimbo de data/hora restaurável mais recente para esse contêiner no carimbo de data/hora 't3', o mais recente para este contêiner será calculado da seguinte maneira:
Caso1: ainda não foi feito backup dos dados de nenhuma das partições
Região Leste dos EUA:
- Partição 1: última hora de backup = t2, mas tem mais dados para backup após t2.
- Partição 2: última hora de backup = t3 e todos os seus dados têm backup.
- Carimbo de data/hora restaurável mais recente = mín. (t2, t3) = t2
Região Oeste dos EUA:
- Partição 1: última hora de backup = t1, mas tem mais dados para backup após t1.
- Partição 2: última hora de backup = t2, mas tem mais dados para backup após t2.
- Carimbo de data/hora restaurável mais recente = mín. (t1, t2) = t1
Caso2: foi feito backup dos dados de todas as partições
Região Leste dos EUA:
- Partição 1: última hora de backup = t2 e todos os seus dados têm backup.
- Partição 2: última hora de backup = t3 e todos os seus dados têm backup.
- Data/hora restaurável mais recente = máx. (carimbo de data/hora atual, t2, t3)
Região Oeste dos EUA:
- Partição 1: última hora de backup = t3 e todos os seus dados têm backup.
- Partição 2: última hora de backup = t3 e todos os seus dados têm backup.
- Carimbo de data/hora restaurável mais recente = máx. (carimbo de data/hora atual, t3, t3)
Caso3: quando uma ou mais partições ainda não fizeram nenhum backup
Região Leste dos EUA:
- Partição 1: nenhum backup de log foi feito para essa partição ainda.
- Partição 2: última hora de backup = t3
- Carimbo de data/hora restaurável mais recente = 1/1/1970 12:00:00 AM
Perguntas frequentes
Posso usar essa API para contas com backup periódico?
Não. Essa API só pode ser usada para contas com o modo de backup contínuo.
Posso usar essa API para contas migradas para o modo contínuo?
Sim. Essa API pode ser usada para contas provisionadas com o modo de backup contínuo ou migradas com êxito para o modo de backup contínuo.
Qual é o atraso típico entre o carimbo de data/hora de gravação mais recente e o restaurável mais recente?
Os dados de backup de log são backup a cada 100 segundos. No entanto, em alguns casos excepcionais, os backups podem ser adiados por mais de 100 segundos.
O carimbo de data/hora restaurável funcionará para recursos excluídos?
Não. Aplica-se somente a recursos dinâmicos (bancos de dados, coleções ou conta). Você pode obter o carimbo de data/hora restaurável para acionar a restauração da conta ativa ou monitorar se o backup dos dados está sendo feito a tempo.