Ressourcenmodell für das Feature „Zeitpunktwiederherstellung“ von Azure Cosmos DB

  • Artikel

GILT FÜR: NoSQL MongoDB Gremlin Tabelle

Dieser Artikel enthält eine Beschreibung des Ressourcenmodells für das Feature „Zeitpunktwiederherstellung“ von Azure Cosmos DB. Beschrieben werden die Parameter zur Unterstützung der fortlaufenden Sicherung und der Ressourcen, die wiederhergestellt werden können. Dieses Feature wird in der Azure Cosmos DB-API für SQL, der Azure Cosmos DB-API für Gremlin, der Tabellen-API und der Azure Cosmos DB-API für MongoDB unterstützt.

Ressourcenmodell des Datenbankkontos

Das Ressourcenmodell des Datenbankkontos wird mit einigen zusätzlichen Eigenschaften zur Unterstützung der neuen Wiederherstellungsszenarien aktualisiert. Bei diesen Eigenschaften handelt es sich um BackupPolicy, CreateMode und RestoreParameters.

BackupPolicy

Eine neue Eigenschaft in der Sicherungsrichtlinie auf Kontoebene mit dem Namen Type unter dem backuppolicy-Parameter aktiviert die fortlaufende Sicherung und Zeitpunktwiederherstellung. Dieser Modus wird als fortlaufende Sicherung bezeichnet. Sie können diesen Modus beim Erstellen des Kontos oder beim Migrieren eines Kontos vom regelmäßigen zum fortlaufenden Modus festlegen. Nach dem Aktivieren des fortlaufenden Modus sind bei allen in diesem Konto erstellten Containern und Datenbanken die Zeitpunktwiederherstellung und fortlaufende Sicherung standardmäßig aktiviert. Die fortlaufende Sicherungsebene kann auf Continuous7Days oder Continuous30Days festgelegt werden. Wenn keine Ebene bereitgestellt wird, wird Continuous30Days standardmäßig auf das Konto angewendet.

Hinweis

Das Feature „Zeitpunktwiederherstellung“ steht derzeit für Konten von Azure Cosmos DB for NoSQL, der API für MongoDB, der Tabellen-API und Gremlin zur Verfügung. Nachdem Sie ein Konto mit fortlaufendem Modus erstellt haben, können Sie es nicht auf einen regelmäßigen Modus umstellen. Die Continuous7Days-Ebene befindet sich in der Vorschauversion.

CreateMode

Diese Eigenschaft gibt an, wie das Konto erstellt wurde. Die möglichen Werte sind Default (Standard) und Restore (Wiederherstellen). Legen Sie diesen Wert zum Ausführen einer Wiederherstellung auf Restore fest, und geben Sie die entsprechenden Werte in der RestoreParameters-Eigenschaft an.

publicNetworkAccess

Diese Eigenschaft muss auf "Deaktiviert" festgelegt werden, um das Konto ohne öffentlichen Netzwerkzugriff wiederherzustellen. Wenn diese Eigenschaft nicht bereitgestellt wird, wird die Wiederherstellung des Kontos mit publicNetworkAccess fortgesetzt als Enabled.

RestoreParameters

Die Ressource RestoreParameters enthält die Details zum Wiederherstellungsvorgang, darunter die Konto-ID, die Zeit zum Wiederherstellen und die Ressourcen, die wiederhergestellt werden müssen.

Eigenschaftenname BESCHREIBUNG
restoreMode Der Wiederherstellungsmodus sollte PointInTime lauten.
restoreSource Die InstanceId des Quellkontos, aus dem die Wiederherstellung eingeleitet wird.
restoreTimestampInUtc Zeitpunkt (UTC) zum Wiederherstellen des Kontos
databasesToRestore Eine Liste von DatabaseRestoreResource-Objekten zur Angabe, welche Datenbanken und Container wiederhergestellt werden sollen. Jede Ressource stellt eine einzelne Datenbank und alle Sammlungen in dieser Datenbank dar. Weitere Informationen finden Sie unter Wiederherstellbare SQL-Ressourcen. Wenn dieser Wert leer ist, wird das gesamte Konto wiederhergestellt.
gremlinDatabasesToRestore Eine Liste von GremlinDatabaseRestoreResource-Objekten zur Angabe, welche Datenbanken und Graphen wiederhergestellt werden sollen. Jede Ressource stellt eine einzelne Datenbank und alle Graphen unter dieser Datenbank dar. Weitere Informationen finden Sie unter Wiederherstellbare Gremlin-Ressourcen. Wenn dieser Wert leer ist, wird das gesamte Konto wiederhergestellt.
restoreWithTtlDisabled Boolesche Flagwerte (true/false), um Time-To-Live im wiederhergestellten Konto nach Abschluss der Wiederherstellung zu deaktivieren. (Vorschauversion)
tablesToRestore Eine Liste von TableRestoreResource-Objekten zur Angabe, welche Tabellen wiederhergestellt werden sollen. Jede Ressource stellt eine Tabelle unter dieser Datenbank dar. Weitere Informationen finden Sie unter Wiederherstellbare Tabellen-Ressourcen. Wenn dieser Wert leer ist, wird das gesamte Konto wiederhergestellt.

Beispielressource

Der folgende JSON-Code ist ein Beispiel für eine Datenbankkontoressource mit aktivierter fortlaufender Sicherung:

{
  "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"
      ...
    }
  }
}

Wiederherstellbare Ressourcen

Eine Menge neuer Ressourcen und APIs ist verfügbar, um kritische Informationen über Ressourcen ermitteln zu können, unter anderem:

  • Wo die Ressourcen wiederhergestellt werden können
  • Speicherorte, an denen die Ressourcen wiederhergestellt werden können
  • Zeitstempel, wenn Schlüsselvorgänge für diese Ressourcen ausgeführt wurden.

Hinweis

Alle zum Auflisten dieser Ressourcen verwendeten APIs erfordern die folgenden Berechtigungen:

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

Wiederherstellbares Datenbankkonto

Diese Ressource enthält eine Instanz eines Datenbankkontos, die wiederhergestellt werden kann. Das Datenbankkonto kann entweder ein gelöschtes oder ein aktives Konto sein. Es enthält Informationen, mit denen Sie das Quelldatenbankkonto suchen können, das Sie wiederherstellen möchten.

Eigenschaftenname BESCHREIBUNG
ID Der eindeutige Bezeichner der Ressource.
accountName Der Name des globalen Datenbankkontos.
creationTime Die Zeit in UTC (koordinierte Weltzeit), zu der das Konto erstellt oder migriert wurde.
deletionTime Die Zeit in UTC, zu der das Konto gelöscht wurde. Dieser Wert ist leer, wenn das Konto aktiv ist.
apiType Der API-Typ des Azure Cosmos DB-Kontos.
restorableLocations Die Liste der Standorte, an denen das Konto vorhanden war.
restorableLocations: locationName Der Regionsname des regionalen Kontos.
restorableLocations: regionalDatabaseAccountInstanceId Der GUID des regionalen Kontos.
restorableLocations: creationTime Die Zeit in UTC, zu der das regionale Konto erstellt oder migriert wurde.
restorableLocations: deletionTime Die Zeit in UTC, zu der das regionale Konto gelöscht wurde. Dieser Wert ist leer, wenn das regionale Konto aktiv ist.
OldestRestorableTimeStamp Die früheste Zeit in UTC, in der die Wiederherstellung ausgeführt werden kann. Für die 30-Tage-Ebene kann diese Zeit maximal 30 Tage ab jetzt sein, für die 7-Tage-Ebene kann diese Zeit bis zu 7 Tage ab jetzt sein.

Eine Liste aller wiederherstellbaren Konten finden Sie in den Artikeln Wiederherstellbare Datenbankkonten – Auflisten oder Wiederherstellbare Datenbankkonten – Auflisten nach Standort.

Wiederherstellbare SQL-Datenbank

Jede Ressource enthält Informationen zu einem Mutationsereignis, z. B. Erstellung und Löschung, das in der SQL-Datenbank eingetreten ist. Diese Informationen können in Szenarien hilfreich sein, in denen die Datenbank versehentlich gelöscht wurde und Sie herausfinden müssen, wann dieses Ereignis eingetreten ist.

Eigenschaftenname BESCHREIBUNG
eventTimestamp Die Zeit in UTC, zu der die Datenbank erstellt oder gelöscht wird.
ownerId Der Name der SQL-Datenbank
ownerResourceId Die Ressourcen-ID der SQL-Datenbank
operationType Der Vorgangstyp dieses Datenbankereignisses.
database Die Eigenschaften der SQL-Datenbank zum Zeitpunkt des Ereignisses

Hinweis

Zu den möglichen Werten für operationType zählen:

  • Create: Datenbankerstellungsereignis
  • Delete: Datenbanklöschungsereignis
  • Replace: Datenbankänderungsereignis
  • SystemOperation: Ein vom System ausgelöstes Datenbankänderungsereignis. Dieses Ereignis wird nicht durch den Benutzer initiiert.

Eine Liste aller Datenbankmutationen finden Sie im Artikel Wiederherstellbare NoSQL-Datenbanken – Liste.

Wiederherstellbare SQL-Container

Jede Ressource enthält Informationen zu einem Mutationsereignis, z. B. Erstellung und Löschung, das im SQL-Container eingetreten ist. Diese Informationen können in Szenarien hilfreich sein, in denen der Container geändert oder gelöscht wurde und Sie herausfinden müssen, wann dieses Ereignis eingetreten ist.

Eigenschaftenname BESCHREIBUNG
eventTimestamp Die Zeit in UTC, zu der dieses Containerereignis eingetreten ist.
ownerId Der Name des SQL-Containers.
ownerResourceId Die Ressourcen-ID des SQL-Containers.
operationType Der Vorgangstyp dieses Containerereignisses.
container Die Eigenschaften des SQL-Containers zum Zeitpunkt des Ereignisses.

Hinweis

Zu den möglichen Werten für operationType zählen:

  • Create: Containererstellungsereignis
  • Delete: Containerlöschungsereignis
  • Replace: Containeränderungsereignis
  • SystemOperation: Ein vom System ausgelöstes Containeränderungsereignis. Dieses Ereignis wird nicht durch den Benutzer initiiert.

Eine Liste aller Containermutationen in derselben Datenbank finden Sie im Artikel Wiederherstellbare NoSQL-Container – Liste.

Wiederherstellbare SQL-Ressourcen

Jede Ressource stellt eine einzelne Datenbank und alle Container in dieser Datenbank dar.

Eigenschaftenname BESCHREIBUNG
databaseName Der Name der SQL-Datenbank
collectionNames Die Liste von SQL-Containern in dieser Datenbank.

Eine Liste von Kombinationen aus SQL-Datenbank und -Containern, die für das Konto zum angegebenen Zeitstempel und am angegebenen Standort vorhanden sind, finden Sie im Artikel Wiederherstellbare NoSQL-Ressourcen – Liste.

Wiederherstellbare MongoDB-Datenbank

Jede Ressource enthält Informationen zu einem Mutationsereignis, z. B. Erstellung und Löschung, das in der MongoDB-Datenbank eingetreten ist. Diese Informationen können in dem Szenario hilfreich sein, in dem die Datenbank versehentlich gelöscht wurde und der Benutzer herausfinden muss, wann dieses Ereignis eingetreten ist.

Eigenschaftenname BESCHREIBUNG
eventTimestamp Die Zeit in UTC, zu dem dieses Datenbankereignis eingetreten ist.
ownerId Der Name der MongoDB-Datenbank.
ownerResourceId Die Ressourcen-ID der MongoDB-Datenbank.
operationType Der Vorgangstyp dieses Datenbankereignisses.

Hinweis

Zu den möglichen Werten für operationType zählen:

  • Create: Datenbankerstellungsereignis
  • Delete: Datenbanklöschungsereignis
  • Replace: Datenbankänderungsereignis
  • SystemOperation: Ein vom System ausgelöstes Datenbankänderungsereignis. Dieses Ereignis wird nicht durch den Benutzer initiiert.

Eine Liste aller Datenbankmutationen finden Sie im Artikel Wiederherstellbare MongoDB-Datenbanken – Auflisten.

Wiederherstellbare MongoDB-Sammlung

Jede Ressource enthält Informationen zu einem Mutationsereignis, z. B. Erstellung und Löschung, das in der MongoDB-Sammlung eingetreten ist. Diese Informationen können in Szenarien hilfreich sein, in denen die Sammlung geändert oder gelöscht wurde und der Benutzer herausfinden muss, wann dieses Ereignis eingetreten ist.

Eigenschaftenname BESCHREIBUNG
eventTimestamp Die Zeit in UTC, zu der dieses Sammlungsereignis eingetreten ist.
ownerId Der Name der MongoDB-Sammlung.
ownerResourceId Die Ressourcen-ID der MongoDB-Sammlung.
operationType Der Vorgangstyp dieses Sammlungsereignisses.

Hinweis

Zu den möglichen Werten für operationType zählen:

  • Create: Sammlungserstellungsereignis
  • Delete: Sammlungslöschungsereignis
  • Replace: Sammlungsänderungsereignis
  • SystemOperation: Ein vom System ausgelöstes Sammlungsänderungsereignis. Dieses Ereignis wird nicht durch den Benutzer initiiert.

Eine Liste aller Containermutationen in derselben Datenbank finden Sie unter Wiederherstellbare MongoDB-Ressourcen – Liste.

Wiederherstellbare MongoDB-Ressourcen

Jede Ressource stellt eine einzelne Datenbank und alle Sammlungen in dieser Datenbank dar.

Eigenschaftenname BESCHREIBUNG
databaseName Der Name der MongoDB-Datenbank.
collectionNames Die Liste der MongoDB-Sammlungen in dieser Datenbank.

Eine Liste aller Kombinationen aus MongoDB-Datenbank und -Sammlung, die für das Konto zum angegebenen Zeitstempel und am angegebenen Standort vorhanden sind, finden Sie unter Wiederherstellbare MongoDB-Ressourcen – Liste.

Wiederherstellbare Graphressourcen

Jede Ressource stellt eine einzelne Datenbank und alle Graphen unter dieser Datenbank dar.

Eigenschaftenname BESCHREIBUNG
gremlinDatabaseName Der Name der Graphdatenbank.
graphNames Die Liste der Graphen in dieser Datenbank.

Um eine Liste aller Gremlin-Datenbank- und Graphkombinationen abzurufen, die zum gegebenen Zeitstempel und Speicherort für das Konto vorhanden sind, lesen Sie den Artikel Wiederherstellbare Graphressourcen: Liste.

Wiederherstellbare Graphdatenbank

Jede Ressource enthält Informationen zu einem Mutationsereignis, z. B. ein Erstellungs- und Löschungsvorgang, das in der Graphdatenbank aufgetreten ist. Diese Informationen können in dem Szenario hilfreich sein, in dem die Datenbank versehentlich gelöscht wurde und der Benutzer herausfinden muss, wann dieses Ereignis eingetreten ist.

Eigenschaftenname BESCHREIBUNG
eventTimestamp Die Zeit in UTC, zu dem dieses Datenbankereignis eingetreten ist.
ownerId Der Name der Graphdatenbank.
ownerResourceId Die Ressourcen-ID der Graph-Datenbank.
operationType Der Vorgangstyp dieses Datenbankereignisses.

Hinweis

Zu den möglichen Werten für operationType zählen:

  • Create: Datenbankerstellungsereignis
  • Delete: Datenbanklöschungsereignis
  • Replace: Datenbankänderungsereignis
  • SystemOperation: Ein vom System ausgelöstes Datenbankänderungsereignis. Dieses Ereignis wird nicht durch den Benutzer initiiert.

Informationen zum Abrufen eines Ereignisfeeds aller Mutationen in der Gremlin-Datenbank finden Sie unter Wiederherstellbare Graphdatenbanken – Liste.

Wiederherstellbare Graphen

Jede Ressource enthält Informationen zu einem Mutationsereignis, z. B. Erstellung und Löschung, das für den Graphen aufgetreten ist. Diese Informationen können in Szenarien hilfreich sein, in denen der Graph geändert oder gelöscht wurde und Sie herausfinden müssen, wann dieses Ereignis aufgetreten ist.

Eigenschaftenname BESCHREIBUNG
eventTimestamp Die Zeit in UTC, zu der dieses Sammlungsereignis eingetreten ist.
ownerId Der Name der Graphsammlung.
ownerResourceId Die Ressourcen-ID der Graphsammlung.
operationType Der Vorgangstyp dieses Sammlungsereignisses.

Hinweis

Zu den möglichen Werten für operationType zählen:

  • Create: Grapherstellungsereignis
  • Delete: Graphlöschungsereignis
  • Replace: Graphänderungsereignis
  • SystemOperation: Ein vom System ausgelöstes Sammlungsänderungsereignis. Dieses Ereignis wird nicht durch den Benutzer initiiert.

Eine Liste aller Containermutationen in derselben Datenbank finden Sie im Artikel Wiederherstellbare Graphen: Liste.

Wiederherstellbare Tabellenressourcen

Listet alle wiederherstellbaren Azure Cosmos DB-Tabellen auf, die für ein bestimmtes Datenbankkonto zu einem bestimmten Zeitpunkt und an einem bestimmten Speicherort verfügbar sind. Beachten Sie, dass die API für Table keine explizite Datenbank angibt.

Eigenschaftenname BESCHREIBUNG
TableNames Die Liste der Tabellencontainer in diesem Konto.

Eine Liste der Tabellen, die für das Konto zum angegebenen Zeitstempel und am angegebenen Standort vorhanden sind, finden Sie im Artikel Wiederherstellbare Tabellenressourcen: Auflisten.

Wiederherstellbare Tabelle

Jede Ressource enthält Informationen zu einem Mutationsereignis, z. B. Erstellung und Löschung, das für die Tabelle aufgetreten ist. Diese Informationen können in Szenarien hilfreich sein, in denen die Tabelle geändert oder gelöscht wurde und Sie herausfinden müssen, wann dieses Ereignis aufgetreten ist.

Eigenschaftenname BESCHREIBUNG
eventTimestamp Die Zeit in UTC, zu dem dieses Datenbankereignis eingetreten ist.
ownerId Der Name der Tabellendatenbank.
ownerResourceId Die Ressourcen-ID der Tabellenressource.
operationType Der Vorgangstyp dieses Tabellenereignisses.

Hinweis

Zu den möglichen Werten für operationType zählen:

  • Create: Tabellenerstellungsereignis
  • Delete: Tabellenlöschungsereignis
  • Replace: Tabellenänderungsereignis
  • SystemOperation: Ein vom System ausgelöstes Datenbankänderungsereignis. Dieses Ereignis wird nicht durch den Benutzer initiiert.

Eine Liste aller Tabellenmutationen in derselben Datenbank finden Sie im Artikel Wiederherstellbare Tabelle: Liste.

Nächste Schritte