Model prostředků pro funkci obnovení k určitému bodu v čase služby Azure Cosmos DB

  • Článek

PLATÍ PRO: NoSQL MongoDB Gremlin Tabulka

Tento článek vysvětluje model prostředků pro funkci obnovení k určitému bodu v čase služby Azure Cosmos DB. Vysvětluje parametry, které podporují průběžné zálohování, a prostředky, které je možné obnovit. Tato funkce se podporuje v rozhraní API služby Azure Cosmos DB pro SQL, rozhraní API služby Azure Cosmos DB pro Gremlin, rozhraní Table API a rozhraní API služby Azure Cosmos DB pro MongoDB.

Model prostředků databázového účtu

Model prostředků databázového účtu je aktualizovaný o několik dalších vlastností, které podporují nové scénáře obnovení. Tyto vlastnosti jsou BackupPolicy, CreateModea RestoreParameters.

Zásady zálohování

Nová vlastnost v zásadách zálohování na úrovni účtu s názvem Type pod parametrem backuppolicy umožňuje průběžné zálohování a obnovení k určitému bodu v čase. Tento režim se označuje jako průběžné zálohování. Tento režim můžete nastavit při vytváření účtu nebo při migraci účtu z pravidelného do průběžného režimu. Po povolení průběžného režimu budou mít všechny kontejnery a databáze vytvořené v rámci tohoto účtu ve výchozím nastavení povolené obnovení k určitému bodu v čase a průběžné zálohování. Úroveň průběžného zálohování je možné nastavit na Continuous7Days nebo Continuous30Days. Ve výchozím nastavení se na účet použije, pokud není k dispozici Continuous30Days žádná úroveň.

Poznámka

V současné době je funkce obnovení k určitému bodu v čase dostupná pro účty Azure Cosmos DB for NoSQL, ROZHRANÍ API pro MongoDB, Table a Gremlin. Jakmile vytvoříte účet v nepřetržitém režimu, nemůžete ho přepnout do pravidelného režimu. Úroveň Continuous7Days je ve verzi Preview.

CreateMode

Tato vlastnost označuje, jak byl účet vytvořen. Možné hodnoty jsou Default (Výchozí) a Restore (Obnovit). Chcete-li provést obnovení, nastavte tuto hodnotu na Obnovit a zadejte příslušné hodnoty ve RestoreParameters vlastnosti.

RestoreParameters

Prostředek RestoreParameters obsahuje podrobnosti o operaci obnovení, včetně ID účtu, času obnovení a prostředků, které je potřeba obnovit.

Název vlastnosti Description
restoreMode Režim obnovení by měl být PointInTime.
restoreSource Id instance zdrojového účtu, ze kterého se zahájí obnovení.
restoreTimestampInUtc Obnovení účtu k určitému bodu v čase (UTC).
databasesToRestore DatabaseRestoreResource Seznam objektů, které určují, které databáze a kontejnery se mají obnovit. Každý prostředek představuje jednu databázi a všechny kolekce v této databázi. Další informace najdete v tématu Obnovitelné prostředky SQL. Pokud je tato hodnota prázdná, obnoví se celý účet.
gremlinDatabasesToRestore GremlinDatabaseRestoreResource Seznam objektů, které určují, které databáze a grafy se mají obnovit. Každý prostředek představuje jednu databázi a všechny grafy v této databázi. Další informace najdete v tématu Obnovitelné prostředky Gremlin. Pokud je tato hodnota prázdná, obnoví se celý účet.
tablesToRestore TableRestoreResource Seznam objektů pro určení, které tabulky mají být obnoveny. Každý prostředek představuje tabulku v této databázi. Další informace najdete v tématu Obnovitelné prostředky tabulky. Pokud je tato hodnota prázdná, obnoví se celý účet.

Ukázkový prostředek

Následující json je ukázkový prostředek účtu databáze s povoleným průběžným zálohováním:

{
  "location": "westus",
  "properties": {
    "databaseAccountOfferType": "Standard",
    "locations": [
      {
        "failoverPriority": "0",
        "locationName": "southcentralus",
        "isZoneRedundant": "false"
      }
    ],
    "createMode": "Restore",
    "restoreParameters": {
      "restoreMode": "PointInTime",
      "restoreSource": "/subscriptions/subid/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/1a97b4bb-f6a0-430e-ade1-638d781830cc",
      "restoreTimestampInUtc": "2020-06-11T22:05:09Z",
      "databasesToRestore": [
        {
          "databaseName": "db1",
          "collectionNames": [
            "collection1",
            "collection2"
          ]
        },
        {
          "databaseName": "db2",
          "collectionNames": [
            "collection3",
            "collection4"
          ]
        }
      ]
    },
    "backupPolicy": {
      "type": "Continuous"
      ....
    }
  }
}

Obnovitelné prostředky

K dispozici je sada nových prostředků a rozhraní API, které vám pomůžou zjišťovat důležité informace o prostředcích, mezi které patří:

  • Kde je možné obnovit prostředky
  • Umístění, ze kterých je možné obnovit prostředky
  • Časová razítka, kdy se s těmito prostředky prováděly klíčové operace.

Poznámka

Všechna rozhraní API použitá k výčtu těchto prostředků vyžadují následující oprávnění:

  • Microsoft.DocumentDB/locations/restorableDatabaseAccounts/*/read
  • Microsoft.DocumentDB/locations/restorableDatabaseAccounts/read

Obnovitelný databázový účet

Tento prostředek obsahuje instanci účtu databáze, kterou je možné obnovit. Databázový účet může být buď odstraněný, nebo živý účet. Obsahuje informace, které umožňují najít účet zdrojové databáze, který chcete obnovit.

Název vlastnosti Description
ID Jedinečný identifikátor prostředku.
accountName Název globálního databázového účtu.
creationTime Čas ve standardu UTC, kdy byl účet vytvořen nebo migrován.
deletionTime Čas ve standardu UTC, kdy byl účet odstraněn. Tato hodnota je prázdná, pokud je účet aktivní.
apiType Typ rozhraní API účtu služby Azure Cosmos DB.
restorableLocations Seznam umístění, ve kterých účet existoval.
restorableLocations: locationName Název oblasti místního účtu.
restorableLocations: regionalDatabaseAccountInstanceId Identifikátor GUID místního účtu.
restorableLocations: creationTime Čas ve standardu UTC, kdy byl místní účet vytvořen, r migroval.
restorableLocations: deletionTime Čas ve standardu UTC, kdy byl místní účet odstraněn. Tato hodnota je prázdná, pokud je místní účet aktivní.
OldestRestorableTimeStamp Nejstarší čas ve standardu UTC, do kterého je možné provést obnovení. Pro 30denní vrstvu to může být maximálně 30 dnů od této chvíle, u sedmidenní vrstvy to může být až sedm dnů od této chvíle.

Pokud chcete získat seznam všech obnovitelných účtů, přečtěte si články o obnovitelných databázových účtech – seznam nebo Obnovitelné databázové účty – seznam podle umístění .

Obnovitelná databáze SQL

Každý prostředek obsahuje informace o události mutací, jako je vytvoření a odstranění, ke kterým došlo na SQL Database. Tyto informace můžou pomoct ve scénářích, kdy byla databáze omylem odstraněna, a pokud potřebujete zjistit, kdy k této události došlo.

Název vlastnosti Description
eventTimestamp Čas ve standardu UTC, kdy je databáze vytvořena nebo odstraněna.
ownerId Název databáze SQL.
ownerResourceId ID prostředku databáze SQL,
operationType Typ operace této databázové události.
database Vlastnosti databáze SQL v době události,

Poznámka

Mezi možné hodnoty patří operationType :

  • Create: událost vytvoření databáze
  • Delete: událost odstranění databáze
  • Replace: událost úpravy databáze
  • SystemOperation: událost úpravy databáze aktivovaná systémem. Tato událost není inicializována uživatelem.

Pokud chcete získat seznam všech databázových mutací, přečtěte si článek Obnovitelné databáze NoSQL – seznam .

Obnovitelný kontejner SQL

Každý prostředek obsahuje informace o události mutací, jako je vytvoření a odstranění, ke kterým došlo v kontejneru SQL. Tyto informace můžou pomoct ve scénářích, kdy byl kontejner změněn nebo odstraněn, a pokud potřebujete zjistit, kdy k této události došlo.

Název vlastnosti Description
eventTimestamp Čas ve standardu UTC, kdy došlo k této události kontejneru.
ownerId Název kontejneru SQL.
ownerResourceId ID prostředku kontejneru SQL.
operationType Typ operace této události kontejneru.
container Vlastnosti kontejneru SQL v době události.

Poznámka

Mezi možné hodnoty patří operationType :

  • Create: událost vytvoření kontejneru
  • Delete: událost odstranění kontejneru
  • Replace: Událost úpravy kontejneru
  • SystemOperation: Událost úpravy kontejneru aktivovaná systémem. Tato událost není inicializována uživatelem.

Pokud chcete získat seznam všech mutací kontejnerů ve stejné databázi, přečtěte si článek Obnovitelné kontejnery NoSQL – seznam .

Obnovitelné prostředky SQL

Každý prostředek představuje jednu databázi a všechny kontejnery v této databázi.

Název vlastnosti Description
databaseName Název databáze SQL.
collectionNames Seznam kontejnerů SQL v této databázi

Pokud chcete získat seznam databází SQL a kombinovaných kontejnerů, které existují v účtu v daném časovém razítku a umístění, přečtěte si článek Obnovitelné prostředky NoSQL – seznam .

Obnovitelná databáze MongoDB

Každý prostředek obsahuje informace o události mutací, jako je vytvoření a odstranění, ke kterým došlo v databázi MongoDB. Tyto informace můžou pomoct ve scénáři, kdy byla databáze omylem odstraněna a uživatel potřebuje zjistit, kdy k této události došlo.

Název vlastnosti Description
eventTimestamp Čas ve standardu UTC, kdy došlo k této události databáze.
ownerId Název databáze MongoDB.
ownerResourceId ID prostředku databáze MongoDB.
operationType Typ operace této databázové události.

Poznámka

Mezi možné hodnoty patří operationType :

  • Create: událost vytvoření databáze
  • Delete: událost odstranění databáze
  • Replace: událost úpravy databáze
  • SystemOperation: událost úpravy databáze aktivovaná systémem. Tato událost není inicializována uživatelem.

Pokud chcete získat seznam všech databázových mutací, přečtěte si článek Obnovitelné databáze Mongodb – seznam .

Obnovitelná kolekce MongoDB

Každý prostředek obsahuje informace o události mutací, jako je vytvoření a odstranění, ke kterým došlo v kolekci MongoDB. Tyto informace můžou pomoct ve scénářích, kdy se kolekce změnila nebo odstranila a uživatel potřebuje zjistit, kdy k této události došlo.

Název vlastnosti Description
eventTimestamp Čas ve standardu UTC, kdy k této události kolekce došlo.
ownerId Název kolekce MongoDB.
ownerResourceId ID prostředku kolekce MongoDB.
operationType Typ operace této události kolekce.

Poznámka

Mezi možné hodnoty patří operationType :

  • Create: událost vytvoření kolekce
  • Delete: událost odstranění kolekce
  • Replace: událost úpravy kolekce
  • SystemOperation: událost úpravy kolekce aktivovaná systémem. Tato událost není inicializována uživatelem.

Pokud chcete získat seznam všech mutací kontejnerů ve stejné databázi, projděte si téma Obnovitelné prostředky MongoDB – seznam.

Obnovitelné prostředky MongoDB

Každý prostředek představuje jednu databázi a všechny kolekce v této databázi.

Název vlastnosti Description
databaseName Název databáze MongoDB.
collectionNames Seznam kolekcí MongoDB v této databázi.

Pokud chcete získat seznam všech kombinací databází a kolekcí MongoDB, které existují v účtu v daném časovém razítku a umístění, přečtěte si téma Obnovitelné prostředky MongoDB – seznam.

Obnovitelné prostředky graphu

Každý prostředek představuje jednu databázi a všechny grafy v této databázi.

Název vlastnosti Description
gremlinDatabaseName Název databáze Graph.
graphNames Seznam grafů v této databázi.

Pokud chcete získat seznam všech kombinací databází a grafů Gremlin, které existují v účtu v daném časovém razítku a umístění, přečtěte si článek Obnovitelné prostředky grafu – seznam .

Obnovitelná databáze graphu

Každý prostředek obsahuje informace o události mutací, jako je vytvoření a odstranění, ke kterým došlo v databázi Graph. Tyto informace můžou pomoct ve scénáři, kdy byla databáze omylem odstraněna a uživatel potřebuje zjistit, kdy k této události došlo.

Název vlastnosti Description
eventTimestamp Čas ve standardu UTC, kdy došlo k této události databáze.
ownerId Název databáze Graph.
ownerResourceId ID prostředku databáze Graph.
operationType Typ operace této databázové události.

Poznámka

Mezi možné hodnoty patří operationType :

  • Create: událost vytvoření databáze
  • Delete: událost odstranění databáze
  • Replace: událost úpravy databáze
  • SystemOperation: událost úpravy databáze aktivovaná systémem. Tato událost není inicializována uživatelem.

Pokud chcete získat informační kanál událostí všech mutací v databázi Gremlin, projděte si téma Obnovitelné grafové databáze – seznam.

Obnovitelné grafy

Každý prostředek obsahuje informace o události mutací, jako je vytvoření a odstranění, ke kterým došlo v grafu. Tyto informace můžou pomoct ve scénářích, kdy byl graf změněn nebo odstraněn, a pokud potřebujete zjistit, kdy k této události došlo.

Název vlastnosti Description
eventTimestamp Čas ve standardu UTC, kdy k této události kolekce došlo.
ownerId Název kolekce Graph.
ownerResourceId ID prostředku kolekce Graph.
operationType Typ operace této události kolekce.

Poznámka

Mezi možné hodnoty patří operationType :

  • Create: Událost vytvoření grafu
  • Delete: Událost odstranění grafu
  • Replace: Událost úpravy grafu
  • SystemOperation: událost úpravy kolekce aktivovaná systémem. Tuto událost neiniciuje uživatel.

Pokud chcete získat seznam všech mutací kontejnerů ve stejné databázi, přečtěte si článek o grafech Obnovitelné grafy – seznam .

Obnovitelné prostředky tabulky

Zobrazí seznam všech obnovitelných tabulek Azure Cosmos DB dostupných pro konkrétní databázový účet v daném čase a umístění. Všimněte si, že rozhraní API pro tabulku neurčí explicitní databázi.

Název vlastnosti Description
TableNames Seznam kontejnerů tabulky v rámci tohoto účtu.

Pokud chcete získat seznam tabulek, které na účtu existují v daném časovém razítku a umístění, přečtěte si článek Obnovitelné prostředky tabulky – seznam .

Obnovitelná tabulka

Každý prostředek obsahuje informace o události mutace, jako je vytvoření a odstranění, ke kterým došlo v tabulce. Tyto informace vám můžou pomoct ve scénářích, kdy byla tabulka změněna nebo odstraněna, a pokud potřebujete zjistit, kdy k této události došlo.

Název vlastnosti Description
eventTimestamp Čas ve standardu UTC, kdy došlo k této události databáze.
ownerId Název databáze Tabulky.
ownerResourceId ID prostředku tabulky.
operationType Typ operace této události tabulky.

Poznámka

Možné hodnoty pro operationType zahrnují:

  • Create: Událost vytvoření tabulky
  • Delete: Událost odstranění tabulky
  • Replace: Událost úpravy tabulky
  • SystemOperation: událost úpravy databáze aktivovaná systémem. Tuto událost neinicioval uživatel.

Pokud chcete získat seznam všech tabulkových mutací ve stejné databázi, přečtěte si článek Obnovitelné tabulky – seznam .

Další kroky