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

Článek
04/25/2024

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 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/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 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

Zřiďte průběžné zálohování pomocí webu Azure Portal, PowerShellu, rozhraní příkazového řádku nebo Azure Resource Manageru.
Obnovte účet pomocí webu Azure Portal, PowerShellu, rozhraní příkazového řádku nebo Azure Resource Manageru.
Migrace na účet z pravidelného zálohování na průběžné zálohování
Správa oprávnění potřebných k obnovení dat pomocí režimu průběžného zálohování

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

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

Zásady zálohování

CreateMode

publicNetworkAccess

RestoreParameters

Ukázkový prostředek

Obnovitelné prostředky

Obnovitelný databázový účet

Obnovitelná databáze SQL

Obnovitelný kontejner SQL

Obnovitelné prostředky SQL

Obnovitelná databáze MongoDB

Obnovitelná kolekce MongoDB

Obnovitelné prostředky MongoDB

Obnovitelné prostředky Graphu

Obnovitelná databáze Graphu

Obnovitelné grafy

Obnovitelné prostředky tabulky

Obnovitelná tabulka

Další kroky

Další materiály