Sdílet prostřednictvím

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

  • Článek

PLATÍ PRO: NoSQL MongoDB Skřítek Stůl

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 je podporovaná 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 se aktualizuje 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 pojmenovaná Type v parametru 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 periodické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 hodnotu nebo Continuous30Days. Ve výchozím nastavení platí, že pokud není k dispozici žádná úroveň, Continuous30Days použije se pro účet.

Poznámka:

V současné době je funkce obnovení k určitému bodu v čase dostupná pro účty Azure Cosmos DB for NoSQL, API pro MongoDB, Table a Gremlin. Po vytvoření účtu s průběžným režimem ho nemůžete 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 Výchozí a Obnovit. Chcete-li provést obnovení, nastavte tuto hodnotu na Restore a zadejte příslušné hodnoty ve RestoreParameters vlastnosti.

publicNetworkAccess

Tato vlastnost musí být nastavená na Zakázáno, aby bylo možné obnovit účet bez přístupu k veřejné síti. Pokud tato vlastnost není k dispozici, obnovení účtu bude pokračovat s publicNetworkAccess jako Enabled.

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 Popis
restoreMode Režim obnovení by měl být PointInTime.
restoreSource InstanceId 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ů k určení databází a grafů, které mají být obnoveny. 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.
restoreWithTtlDisabled Boolean flag values (true/false) to disable Time-To-Live in the restored account upon completion of the restore. (Preview)
tablesToRestore TableRestoreResource Seznam objektů, které určují, které tabulky se mají obnovit. Každý prostředek představuje tabulku pod danou databází. 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",
    "publicNetworkAccess":"Disabled",
    "restoreParameters": {
      "restoreMode": "PointInTime",
      "restoreWithTtlDisabled" : "true",
      "restoreSource": "/subscriptions/subid/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
      "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 zjistit důležité informace o prostředcích, mezi které patří:

  • Kde je možné obnovit prostředky
  • Umístění, ze kterých lze prostředky obnovit
  • Časová razítka, kdy byly s těmito prostředky provedeny operace klíče.

Poznámka:

Všechna rozhraní API použitá k vytvoření 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 databázového účtu, kterou je možné obnovit. Účet databáze může být buď odstraněný, nebo živý účet. Obsahuje informace, které vám umožní najít zdrojový účet databáze, který chcete obnovit.

Název vlastnosti Popis
ID Jedinečný identifikátor prostředku.
accountName Název globálního databázového účtu.
creationTime Čas vytvoření nebo migrace účtu ve standardu UTC
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í, kde účet existoval.
restorableLocations: locationName Název oblasti regionálního účtu.
restorableLocations: regionalDatabaseAccountInstanceId Identifikátor GUID místního účtu.
restorableLocations: creationTime Čas v UTC, kdy se migroval místní účet.
restorableLocations: deletionTime Čas v UTC, kdy byl regionální účet odstraněn. Tato hodnota je prázdná, pokud je místní účet aktivní.
OldestRestorableTimeStamp Nejstarší čas ve standardu UTC, ke kterému je možné provést obnovení. Pro 30denní úroveň může být tento čas maximálně 30 dní od této chvíle, pro sedmidenní úroveň může být tento čas až sedm dní od této chvíle.

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

Obnovitelná databáze SQL

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

Název vlastnosti Popis
eventTimestamp Čas ve standardu UTC při vytvoření nebo odstranění databáze.
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:

Možné hodnoty pro operationType zahrnutí:

  • Create: Událost vytvoření databáze
  • Delete: událost odstranění databáze
  • Replace: událost změny databáze
  • SystemOperation: událost změny 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 o obnovitelných databázích NoSQL – seznam .

Obnovitelný kontejner SQL

Každý prostředek obsahuje informace o událostech změtování, jako je vytvoření a odstranění, ke kterým došlo v kontejneru SQL. Tyto informace vám 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 Popis
eventTimestamp Čas ve standardu UTC, kdy k této události kontejneru došlo.
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:

Možné hodnoty pro operationType zahrnutí:

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

Pokud chcete získat seznam všech kontejnerových mutací 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 Popis
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ého kontejneru, které existují v účtu v daném časovém razítku a umístění, přečtěte si článek o obnovovatelných prostředcích NoSQL – seznam .

Obnovitelná databáze MongoDB

Každý prostředek obsahuje informace o událostech 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 musí zjistit, kdy k této události došlo.

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

Poznámka:

Možné hodnoty pro operationType zahrnutí:

  • Create: Událost vytvoření databáze
  • Delete: událost odstranění databáze
  • Replace: událost změny databáze
  • SystemOperation: událost změny 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 o obnovitelných databázích Mongodb – seznam .

Obnovitelná kolekce MongoDB

Každý prostředek obsahuje informace o událostech 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 musí zjistit, kdy k této události došlo.

Název vlastnosti Popis
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:

Možné hodnoty pro operationType zahrnutí:

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

Pokud chcete získat seznam všech kontejnerových mutací ve stejné databázi, podívejte se na seznam obnovitelných prostředků MongoDB.

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 Popis
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í, podívejte se na seznam obnovitelných prostředků MongoDB.

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 Popis
gremlinDatabaseName Název databáze Graph.
graphNames Seznam grafů v této databázi.

Pokud chcete získat seznam všech kombinací databáze 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 o obnovitelných prostředcích grafu – seznam .

Obnovitelná databáze Graphu

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

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

Poznámka:

Možné hodnoty pro operationType zahrnutí:

  • Create: Událost vytvoření databáze
  • Delete: událost odstranění databáze
  • Replace: událost změny databáze
  • SystemOperation: událost změny 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, podívejte se na seznam obnovitelných grafových databází.

Obnovitelné grafy

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

Název vlastnosti Popis
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:

Možné hodnoty pro operationType zahrnutí:

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

Pokud chcete získat seznam všech kontejnerových mutací pod stejnou databází, přečtěte si článek o grafech obnovitelných grafů – 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 nezadává explicitní databázi.

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

Pokud chcete získat seznam tabulek, 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 tabulky – seznam .

Obnovitelná tabulka

Každý prostředek obsahuje informace o událostech mutací, jako je vytvoření a odstranění, ke kterým došlo v tabulce. Tyto informace 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 Popis
eventTimestamp Čas ve standardu UTC, kdy k této události databáze došlo.
ownerId Název databáze tabulky.
ownerResourceId ID prostředku prostředku tabulky.
operationType Typ operace této události tabulky.

Poznámka:

Možné hodnoty pro operationType zahrnutí:

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

Pokud chcete získat seznam všech tabulkových mutací pod stejnou databází, přečtěte si článek Obnovitelná tabulka – seznam .

Další kroky