Model zasobów dla funkcji przywracania do punktu w czasie w usłudze Azure Cosmos DB

  • Artykuł

DOTYCZY: Nosql Mongodb Gremlin Tabeli

W tym artykule przedstawiono model zasobów dla funkcji przywracania do punktu w czasie w usłudze Azure Cosmos DB. Wyjaśniono w nim parametry, które obsługują ciągłą kopię zapasową i zasoby, które można przywrócić. Ta funkcja jest obsługiwana w interfejsie API usługi Azure Cosmos DB dla języka SQL, interfejsu API usługi Azure Cosmos DB dla języka Gremlin, interfejsu API tabel i interfejsu API usługi Azure Cosmos DB dla bazy danych MongoDB.

Model zasobów konta bazy danych

Model zasobów konta bazy danych został zaktualizowany o kilka dodatkowych właściwości w celu obsługi nowych scenariuszy przywracania. Te właściwości to BackupPolicy, CreateModei RestoreParameters.

BackupPolicy

Nowa właściwość w zasadach tworzenia kopii zapasowych na poziomie konta o nazwie Type w parametrze backuppolicy umożliwia ciągłą kopię zapasową i przywracanie do punktu w czasie. Ten tryb jest określany jako ciągła kopia zapasowa. Ten tryb można ustawić podczas tworzenia konta lub podczas migrowania konta z trybu okresowego do trybu ciągłego. Po włączeniu trybu ciągłego wszystkie kontenery i bazy danych utworzone na tym koncie będą domyślnie miały włączoną funkcję przywracania do punktu w czasie i ciągłej kopii zapasowej. Warstwę ciągłej kopii zapasowej można ustawić na Continuous7Days lub Continuous30Days. Domyślnie, jeśli nie podano żadnej warstwy, Continuous30Days zostanie zastosowana na koncie.

Uwaga

Obecnie funkcja przywracania do punktu w czasie jest dostępna dla usług Azure Cosmos DB for NoSQL, API for MongoDB, Table i Gremlin. Po utworzeniu konta w trybie ciągłym nie można przełączyć go do trybu okresowego. Warstwa Continuous7Days jest dostępna w wersji zapoznawczej.

CreateMode

Ta właściwość wskazuje sposób tworzenia konta. Możliwe wartości to Default (Domyślne ) i Restore (Przywróć). Aby wykonać przywracanie, ustaw tę wartość na Przywróć i podaj odpowiednie wartości we RestoreParameters właściwości.

publicNetworkAccess

Tę właściwość należy ustawić na wartość "Wyłączone", aby przywrócić konto bez dostępu do sieci publicznej. Jeśli ta właściwość nie zostanie podana, przywrócenie konta spowoduje kontynuowanie funkcji publicNetworkAccess jako Enabled.

RestoreParameters

Zasób RestoreParameters zawiera szczegóły operacji przywracania, w tym identyfikator konta, czas przywracania i zasoby, które należy przywrócić.

Nazwa właściwości Opis
restoreMode Tryb przywracania powinien mieć wartość PointInTime.
restoreSource InstanceId konta źródłowego, z którego zostanie zainicjowane przywracanie.
restoreTimestampInUtc Punkt w czasie w formacie UTC w celu przywrócenia konta.
databasesToRestore DatabaseRestoreResource Lista obiektów do określenia, które bazy danych i kontenery mają zostać przywrócone. Każdy zasób reprezentuje pojedynczą bazę danych i wszystkie kolekcje w tej bazie danych. Aby uzyskać więcej informacji, zobacz przywracanie zasobów SQL. Jeśli ta wartość jest pusta, całe konto zostanie przywrócone.
gremlinDatabasesToRestore GremlinDatabaseRestoreResource Lista obiektów do określenia, które bazy danych i grafy mają zostać przywrócone. Każdy zasób reprezentuje pojedynczą bazę danych i wszystkie grafy w tej bazie danych. Aby uzyskać więcej informacji, zobacz przywracanie zasobów języka Gremlin. Jeśli ta wartość jest pusta, całe konto zostanie przywrócone.
restoreWithTtlDisabled Wartości flagi logicznej (prawda/fałsz) wyłączają czas wygaśnięcia na przywróconym koncie po zakończeniu przywracania. (wersja zapoznawcza)
tablesToRestore TableRestoreResource Lista obiektów do określenia, które tabele mają zostać przywrócone. Każdy zasób reprezentuje tabelę w tej bazie danych. Aby uzyskać więcej informacji, zobacz przywracanie zasobów tabeli. Jeśli ta wartość jest pusta, całe konto zostanie przywrócone.

Przykładowy zasób

Poniższy kod JSON to przykładowy zasób konta bazy danych z włączoną ciągłą kopią zapasową:

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

Zasoby możliwe do przywrócenia

Dostępny jest zestaw nowych zasobów i interfejsów API, które ułatwiają odnajdywanie krytycznych informacji o zasobach, w tym:

  • Gdzie można przywrócić zasoby
  • Lokalizacje, w których można przywrócić zasoby z
  • Znaczniki czasu wykonywania kluczowych operacji na tych zasobach.

Uwaga

Wszystkie interfejsy API używane do wyliczania tych zasobów wymagają następujących uprawnień:

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

Konto bazy danych z możliwością przywracania

Ten zasób zawiera wystąpienie konta bazy danych, które można przywrócić. Konto bazy danych może być usunięte lub na żywo. Zawiera informacje umożliwiające znalezienie źródłowego konta bazy danych, które chcesz przywrócić.

Nazwa właściwości Opis
ID Unikatowy identyfikator zasobu.
accountName Nazwa konta globalnej bazy danych.
creationTime Godzina w formacie UTC utworzenia lub zmigrowania konta.
deletionTime Czas w formacie UTC, kiedy konto zostało usunięte. Ta wartość jest pusta, jeśli konto jest aktywne.
apiType Typ interfejsu API konta usługi Azure Cosmos DB.
restorableLocations Lista lokalizacji, w których istniało konto.
restorableLocations: locationName Nazwa regionu konta regionalnego.
restorableLocations: regionalDatabaseAccountInstanceId Identyfikator GUID konta regionalnego.
restorableLocations: creationTime Godzina w formacie UTC utworzenia konta regionalnego r została zmigrowana.
restorableLocations: deletionTime Godzina w formacie UTC usunięcia konta regionalnego. Ta wartość jest pusta, jeśli konto regionalne jest aktywne.
OldestRestorableTimeStamp Najwcześniejsza godzina w formacie UTC, do której można wykonać przywracanie. W przypadku warstwy 30-dniowej ten czas może wynosić maksymalnie 30 dni od tej pory, przez siedem dni, tym razem może to być do siedmiu dni od teraz.

Aby uzyskać listę wszystkich kont możliwych do przywrócenia, zobacz Artykuły Przywracanie kont bazy danych — lista lub Lista przywracalnych kont bazy danych według lokalizacji .

Przywracanie bazy danych SQL

Każdy zasób zawiera informacje o zdarzeniu mutacji, takim jak tworzenie i usuwanie, które wystąpiło w usłudze SQL Database. Te informacje mogą pomóc w scenariuszach, w których baza danych została przypadkowo usunięta, a jeśli chcesz dowiedzieć się, kiedy to zdarzenie miało miejsce.

Nazwa właściwości Opis
eventTimestamp Godzina w formacie UTC utworzenia lub usunięcia bazy danych.
ownerId Nazwa bazy danych SQL.
ownerResourceId Identyfikator zasobu bazy danych SQL,
operationType Typ operacji tego zdarzenia bazy danych.
database Właściwości bazy danych SQL w momencie zdarzenia,

Uwaga

Możliwe wartości dla operationType następujących elementów:

  • Create: zdarzenie tworzenia bazy danych
  • Delete: zdarzenie usuwania bazy danych
  • Replace: zdarzenie modyfikacji bazy danych
  • SystemOperation: zdarzenie modyfikacji bazy danych wyzwalane przez system. To zdarzenie nie jest inicjowane przez użytkownika

Aby uzyskać listę wszystkich mutacji bazy danych, zobacz Artykuł Restoreable NoSQL Databases - List (Przywracanie baz danych NoSQL — lista).

Przywracalny kontener SQL

Każdy zasób zawiera informacje o zdarzeniu mutacji, takim jak tworzenie i usuwanie, które wystąpiło w kontenerze SQL. Te informacje mogą pomóc w scenariuszach, w których kontener został zmodyfikowany lub usunięty, a jeśli chcesz dowiedzieć się, kiedy to zdarzenie miało miejsce.

Nazwa właściwości Opis
eventTimestamp Godzina w formacie UTC wystąpienia tego zdarzenia kontenera.
ownerId Nazwa kontenera SQL.
ownerResourceId Identyfikator zasobu kontenera SQL.
operationType Typ operacji tego zdarzenia kontenera.
container Właściwości kontenera SQL w momencie zdarzenia.

Uwaga

Możliwe wartości dla operationType następujących elementów:

  • Create: zdarzenie tworzenia kontenera
  • Delete: zdarzenie usuwania kontenera
  • Replace: zdarzenie modyfikacji kontenera
  • SystemOperation: zdarzenie modyfikacji kontenera wyzwalane przez system. To zdarzenie nie jest inicjowane przez użytkownika

Aby uzyskać listę wszystkich mutacji kontenera w tej samej bazie danych, zobacz Artykuł Przywracanie kontenerów NoSQL — lista .

Możliwe do przywrócenia zasoby SQL

Każdy zasób reprezentuje pojedynczą bazę danych i wszystkie kontenery w tej bazie danych.

Nazwa właściwości Opis
databaseName Nazwa bazy danych SQL.
collectionNames Lista kontenerów SQL w tej bazie danych.

Aby uzyskać listę baz danych SQL i kombi kontenera, które istnieją na koncie w danej sygnaturze czasowej i lokalizacji, zobacz Artykuł Przywracanie zasobów NoSQL — lista .

Przywracalna baza danych MongoDB

Każdy zasób zawiera informacje o zdarzeniu mutacji, takim jak tworzenie i usuwanie, które wystąpiło w bazie danych MongoDB. Te informacje mogą pomóc w scenariuszu, w którym baza danych została przypadkowo usunięta, a użytkownik musi dowiedzieć się, kiedy wystąpiło to zdarzenie.

Nazwa właściwości Opis
eventTimestamp Czas w formacie UTC, kiedy miało miejsce to zdarzenie bazy danych.
ownerId Nazwa bazy danych MongoDB.
ownerResourceId Identyfikator zasobu bazy danych MongoDB.
operationType Typ operacji tego zdarzenia bazy danych.

Uwaga

Możliwe wartości dla operationType następujących elementów:

  • Create: zdarzenie tworzenia bazy danych
  • Delete: zdarzenie usuwania bazy danych
  • Replace: zdarzenie modyfikacji bazy danych
  • SystemOperation: zdarzenie modyfikacji bazy danych wyzwalane przez system. To zdarzenie nie jest inicjowane przez użytkownika

Aby uzyskać listę wszystkich mutacji bazy danych, zobacz Artykuł Przywracanie baz danych Mongodb — lista .

Przywracanie kolekcji bazy danych MongoDB

Każdy zasób zawiera informacje o zdarzeniu mutacji, takim jak tworzenie i usuwanie, które wystąpiło w kolekcji MongoDB. Te informacje mogą pomóc w scenariuszach, w których kolekcja została zmodyfikowana lub usunięta, a użytkownik musi dowiedzieć się, kiedy wystąpiło to zdarzenie.

Nazwa właściwości Opis
eventTimestamp Godzina w formacie UTC wystąpienia tego zdarzenia kolekcji.
ownerId Nazwa kolekcji MongoDB.
ownerResourceId Identyfikator zasobu kolekcji MongoDB.
operationType Typ operacji tego zdarzenia kolekcji.

Uwaga

Możliwe wartości dla operationType następujących elementów:

  • Create: zdarzenie tworzenia kolekcji
  • Delete: zdarzenie usuwania kolekcji
  • Replace: zdarzenie modyfikacji kolekcji
  • SystemOperation: zdarzenie modyfikacji kolekcji wyzwalane przez system. To zdarzenie nie jest inicjowane przez użytkownika

Aby uzyskać listę wszystkich mutacji kontenera w tej samej bazie danych, zobacz temat Przywracanie zasobów bazy danych MongoDB — lista.

Możliwe do przywrócenia zasoby bazy danych MongoDB

Każdy zasób reprezentuje pojedynczą bazę danych i wszystkie kolekcje w tej bazie danych.

Nazwa właściwości Opis
databaseName Nazwa bazy danych MongoDB.
collectionNames Lista kolekcji bazy danych MongoDB w tej bazie danych.

Aby uzyskać listę wszystkich kombinacji bazy danych i kolekcji bazy danych MongoDB, które istnieją na koncie w danym sygnaturze czasowej i lokalizacji, zobacz przywracanie zasobów bazy danych MongoDB — lista.

Przywracanie zasobów programu Graph

Każdy zasób reprezentuje pojedynczą bazę danych i wszystkie grafy w tej bazie danych.

Nazwa właściwości Opis
gremlinDatabaseName Nazwa bazy danych programu Graph.
graphNames Lista wykresów w tej bazie danych.

Aby uzyskać listę wszystkich kombinacji bazy danych i grafu Gremlin, które istnieją na koncie w danej sygnaturze czasowej i lokalizacji, zobacz Artykuł Przywracanie zasobów programu Graph — lista .

Baza danych programu Graph z możliwością przywracania

Każdy zasób zawiera informacje o zdarzeniu mutacji, takie jak utworzenie i usunięcie, które wystąpiło w bazie danych programu Graph. Te informacje mogą pomóc w scenariuszu, w którym baza danych została przypadkowo usunięta, a użytkownik musi dowiedzieć się, kiedy wystąpiło to zdarzenie.

Nazwa właściwości Opis
eventTimestamp Czas w formacie UTC, kiedy miało miejsce to zdarzenie bazy danych.
ownerId Nazwa bazy danych programu Graph.
ownerResourceId Identyfikator zasobu bazy danych programu Graph.
operationType Typ operacji tego zdarzenia bazy danych.

Uwaga

Możliwe wartości dla operationType następujących elementów:

  • Create: zdarzenie tworzenia bazy danych
  • Delete: zdarzenie usuwania bazy danych
  • Replace: zdarzenie modyfikacji bazy danych
  • SystemOperation: zdarzenie modyfikacji bazy danych wyzwalane przez system. To zdarzenie nie jest inicjowane przez użytkownika.

Aby uzyskać źródło zdarzeń wszystkich mutacji w bazie danych Gremlin, zobacz przywracanie grafowych baz danych — lista.

Wykresy możliwe do przywrócenia

Każdy zasób zawiera informacje o zdarzeniu mutacji, takim jak tworzenie i usuwanie, które wystąpiło na grafie. Te informacje mogą pomóc w scenariuszach, w których graf został zmodyfikowany lub usunięty, a jeśli chcesz dowiedzieć się, kiedy to zdarzenie się stało.

Nazwa właściwości Opis
eventTimestamp Godzina w formacie UTC wystąpienia tego zdarzenia kolekcji.
ownerId Nazwa kolekcji programu Graph.
ownerResourceId Identyfikator zasobu kolekcji programu Graph.
operationType Typ operacji tego zdarzenia kolekcji.

Uwaga

Możliwe wartości dla operationType następujących elementów:

  • Create: Zdarzenie tworzenia grafu
  • Delete: Zdarzenie usuwania grafu
  • Replace: Zdarzenie modyfikacji grafu
  • SystemOperation: zdarzenie modyfikacji kolekcji wyzwalane przez system. To zdarzenie nie jest inicjowane przez użytkownika.

Aby uzyskać listę wszystkich mutacji kontenera w tej samej bazie danych, zobacz graf Przywracanie grafów — lista .

Możliwe do przywrócenia zasoby tabeli

Wyświetla listę wszystkich tabel usługi Azure Cosmos DB, które można przywrócić dla określonego konta bazy danych w danym czasie i lokalizacji. Zwróć uwagę, że interfejs API dla tabeli nie określa jawnej bazy danych.

Nazwa właściwości Opis
TableNames Lista kontenerów tabel w ramach tego konta.

Aby uzyskać listę tabel, które istnieją na koncie w danym znaczniku czasu i lokalizacji, zobacz Artykuł Przywracanie zasobów tabeli — lista .

Tabela z możliwością przywracania

Każdy zasób zawiera informacje o zdarzeniu mutacji, takim jak tworzenie i usuwanie, które wystąpiło w tabeli. Te informacje mogą pomóc w scenariuszach, w których tabela została zmodyfikowana lub usunięta, a jeśli chcesz dowiedzieć się, kiedy to zdarzenie się stało.

Nazwa właściwości Opis
eventTimestamp Czas w formacie UTC, kiedy miało miejsce to zdarzenie bazy danych.
ownerId Nazwa bazy danych tabel.
ownerResourceId Identyfikator zasobu Tabela.
operationType Typ operacji tego zdarzenia tabeli.

Uwaga

Możliwe wartości dla operationType następujących elementów:

  • Create: Zdarzenie tworzenia tabeli
  • Delete: Zdarzenie usuwania tabeli
  • Replace: Zdarzenie modyfikacji tabeli
  • SystemOperation: zdarzenie modyfikacji bazy danych wyzwalane przez system. To zdarzenie nie jest inicjowane przez użytkownika

Aby uzyskać listę wszystkich mutacji tabeli w tej samej bazie danych, zobacz Artykuł Przywracanie tabeli — lista .

Następne kroki