Verwalten eines Azure Cosmos DB-Kontos im Azure-Portal

GILT FÜR: NoSQL MongoDB Cassandra Gremlin Tabelle

In diesem Artikel wird beschrieben, wie mit dem Azure-Portal verschiedene Aufgaben in einem Azure Cosmos DB-Konto verwaltet werden. Azure Cosmos DB kann auch mit anderen Azure-Verwaltungsclients verwaltet werden, einschließlich Azure PowerShell, Azure CLI, Azure Resource Manager-Vorlagen, Bicep und Terraform.

Tipp

Die Verwaltungs-API für Azure Cosmos DB oder die Steuerungsebene ist nicht für hohe Anforderungsvolumen wie der Rest des Diensts konzipiert. Weitere Informationen finden Sie unter Grenzwerte auf Steuerungsebene.

Voraussetzungen

Keine

Erstellen eines Kontos

Führen Sie diese Schritte aus:

  1. Wählen Sie im Menü des Azure-Portals oder auf der Startseite die Option Ressource erstellen aus.

  2. Suche Sie nach Azure Cosmos DB. Wählen Sie Erstellen>Azure Cosmos DB aus.

  3. Wählen Sie auf der Seite Erstellen eines Azure Cosmos DB-Kontos im Abschnitt Azure Cosmos DB for NoSQL die Option Erstellen aus.

    Azure Cosmos DB bietet mehrere APIs:

    • NoSQL, für Dokumentdaten
    • PostgreSQL
    • MongoDB, für Dokumentdaten
    • Apache Cassandra
    • Tabelle
    • Apache Gremlin, für Graphdaten

    Weitere Informationen zur API für NoSQL finden Sie unter Willkommen bei Azure Cosmos DB.

  4. Geben Sie auf der Seite Azure Cosmos DB-Konto erstellen die grundlegenden Einstellungen für das neue Azure Cosmos DB-Konto ein.

    Einstellung Wert BESCHREIBUNG
    Subscription Abonnementname Wählen Sie das Azure-Abonnement aus, das Sie für dieses Azure Cosmos DB-Konto verwenden möchten.
    Ressourcengruppe Ressourcengruppenname Wählen Sie eine Ressourcengruppe aus, oder wählen Sie Neu erstellen aus, und geben Sie einen eindeutigen Namen für die Ressourcengruppe ein.
    Kontoname Ein eindeutiger Name Geben Sie einen Namen zur Identifizierung Ihres Azure Cosmos DB-Kontos ein. Da documents.azure.com an den Namen angefügt wird, die Sie für die URI-Erstellung angeben, muss der Name eindeutig sein. Der Name darf nur Kleinbuchstaben, Zahlen und den Bindestrich (-) enthalten. Er muss 3–44 Zeichen umfassen.
    Standort Die Region, die Ihren Benutzern am nächsten liegt Wählen Sie einen geografischen Standort aus, an dem Ihr Azure Cosmos DB-Konto gehostet werden soll. Verwenden Sie den Standort, der Ihren Benutzern am nächsten ist, damit sie möglichst schnell auf die Daten zugreifen können.
    Kapazitätsmodus Bereitgestellter Durchsatz oder Serverlos Wählen Sie Bereitgestellter Durchsatz aus, um ein Konto im Modus Bereitgestellter Durchsatz zu erstellen. Wählen Sie Serverlos aus, um ein Konto im Modus Serverlos zu erstellen.
    Anwenden des Rabatts für den Free-Tarif von Azure Cosmos DB Anwenden oder Nicht anwenden Mit dem Azure Cosmos DB-Tarif „Free“ erhalten Sie die ersten 1.000 RUs/Sek. sowie 25 GB Speicher kostenlos in einem Konto. Weitere Informationen zum Tarif „Free“
    Beschränken des gesamten Kontodurchsatzes Ausgewählt sein oder nicht Begrenzen Sie den Gesamtdurchsatz, der für dieses Konto bereitgestellt werden kann. Dieser Grenzwert verhindert unerwartete Gebühren im Zusammenhang mit bereitgestelltem Durchsatz. Sie können diesen Grenzwert anpassen oder entfernen, nachdem Ihr Konto erstellt wurde.

    Sie können pro Azure-Abonnement maximal ein Azure Cosmos DB-Konto im Free-Tarif einrichten und müssen sich beim Erstellen des Kontos registrieren. Wird die Option zum Anwenden des tarifspezifischen Rabatts für den Free-Tarif nicht angezeigt, bedeutet dies, dass bereits ein anderes Konto im Abonnement mit dem Free-Tarif aktiviert wurde.

    Screenshot zeigt die Seite „Azure Cosmos DB-Konto erstellen“

    Hinweis

    Die folgenden Optionen sind nicht verfügbar, wenn Sie als Kapazitätsmodus die Option Serverlos auswählen:

    • Tarifspezifischen Rabatt für den Free-Tarif anwenden
    • Beschränken des gesamten Kontodurchsatzes
  5. Konfigurieren Sie auf der Registerkarte Globale Verteilung die folgenden Details. Für diesen Schnellstart können Sie die Standardwerte beibehalten:

    Einstellung Wert Beschreibung
    Georedundanz Deaktivieren Aktivieren oder deaktivieren Sie die globale Verteilung für Ihr Konto, indem Sie Ihre Region mit einer Region koppeln. Sie können später weitere Regionen zu Ihrem Konto hinzufügen.
    Schreibvorgänge in mehreren Regionen Deaktivieren Mit der Funktion zum Schreiben in mehreren Regionen können Sie den bereitgestellten Durchsatz für Ihre Datenbanken und Container in der ganzen Welt nutzen.
    Verfügbarkeitszonen Deaktivieren Verfügbarkeitszonen helfen Ihnen, die Verfügbarkeit und Resilienz Ihrer Anwendung weiter zu verbessern.

    Hinweis

    Die folgenden Optionen sind nicht verfügbar, wenn Sie als Kapazitätsmodus auf der vorigen Seite Grundlagen die Option Serverlos auswählen:

    • Georedundanz
    • Schreibvorgänge in mehreren Regionen
  6. Optional können Sie auf den folgenden Registerkarten weitere Details konfigurieren:

    • Netzwerke. Konfigurieren des Zugriffs über virtuelle Netzwerke.
    • Sicherungsrichtlinie. Konfigurieren Sie eine Richtlinie für regelmäßige oder fortlaufende Sicherungen.
    • Verschlüsselung. Verwenden Sie entweder einen vom Dienst verwalteten Schlüssel oder einen kundenseitig verwalteten Schlüssel.
    • Tags. Tags sind Name/Wert-Paare, die Ihnen das Kategorisieren von Ressourcen und die Anzeige einer konsolidierten Abrechnung ermöglichen, indem Sie dasselbe Tag auf mehrere Ressourcen und Ressourcengruppen anwenden.
  7. Klicken Sie auf Überprüfen + erstellen.

  8. Überprüfen Sie die Kontoeinstellungen, und wählen Sie anschließend Erstellen aus. Die Erstellung des Kontos dauert einige Minuten. Warten Sie, bis auf der Portalseite Ihre Bereitstellung wurde abgeschlossen. angezeigt wird.

    Screenshot zeigt, dass Ihre Bereitstellung abgeschlossen wurde.

  9. Wählen Sie Zu Ressource wechseln aus, um zur Seite des Azure Cosmos DB-Kontos zu wechseln.

    Screenshot zeigt die Seite „Azure Cosmos DB-Konto“.

Hinzufügen/Entfernen von Regionen für Ihr Datenbankkonto

Tipp

Wenn eine neue Region hinzugefügt wird, müssen alle Daten vollständig repliziert und in die neue Region committet werden, bevor die Region als verfügbar markiert wird. Wie lange dieser Vorgang dauert, hängt davon ab, wie viele Daten in dem Konto gespeichert sind. Wird ein asynchroner Durchsatzskalierungsvorgang ausgeführt, wird der Vorgang zum horizontalen Hochskalieren des Durchsatzes angehalten und automatisch fortgesetzt, sobald der Vorgang zum Hinzufügen/Entfernen von Regionen abgeschlossen ist.

  1. Melden Sie sich beim Azure-Portalan.

  2. Wechseln Sie zu Ihrem Azure Cosmos DB-Konto, und wählen Sie im Ressourcenmenü Daten global replizieren aus.

  3. Wenn Sie Regionen hinzufügen möchten, wählen Sie auf der Karte die Sechsecke mit der Beschriftung + aus, die den gewünschten Regionen entsprechen. Alternativ können Sie zum Hinzufügen einer Region die Option + Region hinzufügen und anschließend eine Region aus dem Dropdownmenü auswählen.

  4. Wenn Sie Regionen entfernen möchten, entfernen Sie sie von der Karte, indem Sie die blauen, mit einem Häkchen versehenen Sechsecke auswählen. Alternativ können Sie auch neben der Region auf der rechten Seite das Papierkorbsymbol (🗑) auswählen.

  5. Wählen Sie zum Speichern der Änderungen OK aus.

    Screenshot: Menü „Daten global replizieren“ mit hervorgehobener Region.

    Im Schreibmodus mit nur einer Region können Sie die Schreibregion nicht entfernen. In diesem Fall muss erst ein Failover auf eine andere Region durchgeführt werden, um die aktuelle Schreibregion löschen zu können.

    Im Schreibmodus mit mehreren Regionen können Sie beliebige Regionen hinzufügen oder entfernen, solange noch mindestens eine Region vorhanden ist.

    Konfigurieren mehrerer Schreibregionen

    Öffnen Sie die Registerkarte Daten global replizieren, und wählen Sie Aktivieren aus, um Schreibvorgänge für mehrere Regionen zu aktivieren. Nachdem Sie Schreibvorgänge für mehrere Regionen aktiviert haben, werden alle Leseregionen, die aktuell in Ihrem Konto konfiguriert sind, zu Lese- und Schreibregionen.

    Screenshot: Menü „Daten global replizieren“ mit den hervorgehobenen Optionen „Regionen konfigurieren“ und „Speichern“.

Aktivieren des dienstseitig verwalteten Failovers für Ihr Azure Cosmos DB-Konto

Die Option für dienstseitig verwaltetes Failover ermöglicht Azure Cosmos DB das Failover auf die Region mit der höchsten Failoverpriorität ohne Benutzereingriff, sollte bei einer Region die Nichtverfügbarkeit eintreten. Wenn dienstseitig verwaltetes Failover aktiviert ist, kann die Regionspriorität geändert werden. Ihr Konto muss über zwei oder mehr Regionen verfügen, um dienstseitig verwaltetes Failover zu aktivieren.

  1. Öffnen Sie in Ihrem Azure Cosmos DB-Konto den Bereich Daten global replizieren.

  2. Wählen Sie im oberen Bereich die Option Dienstseitig verwaltetes Failover aus.

    Screenshot: Menü „Daten global replizieren“.

  3. Stellen Sie sicher, dass im Bereich Dienstseitig verwaltetes Failover die Option Dienstseitig verwaltetes Failover aktivieren auf EIN festgelegt ist.

  4. Wählen Sie Speichern aus.

    Screenshot Menü „Dienstseitig verwaltetes Failover“ im Portal.

Festlegen von Failoverprioritäten für Ihr Azure Cosmos DB-Konto

Nachdem ein Azure Cosmos DB-Konto für dienstseitig verwaltetes Failover konfiguriert wurde, kann die Failoverpriorität für Regionen geändert werden.

Wichtig

Die Schreibregion (Failoverpriorität null) kann nicht geändert werden, wenn das Konto für dienstseitig verwaltetes Failover konfiguriert ist. Um die Schreibregion zu ändern, müssen Sie das dienstseitig verwaltete Failover deaktivieren und ein manuelles Failover ausführen.

  1. Öffnen Sie in Ihrem Azure Cosmos DB-Konto den Bereich Daten global replizieren.

  2. Wählen Sie im oberen Bereich die Option Dienstseitig verwaltetes Failover aus.

    Screenshot: Menü „Daten global replizieren“.

  3. Stellen Sie sicher, dass im Bereich Dienstseitig verwaltetes Failover die Option Dienstseitig verwaltetes Failover aktivieren auf EIN festgelegt ist.

  4. Ziehen Sie zum Ändern der Failoverpriorität die Leseregionen mithilfe der drei Punkte, die auf der linken Seite der Zeile angezeigt werden, wenn Sie darauf zeigen.

  5. Wählen Sie Speichern aus.

    Screenshot Menü „Dienstseitig verwaltetes Failover“ im Portal.

Ausführen eines manuellen Failovers für ein Azure Cosmos DB-Konto

Wichtig

Damit dieser Vorgang erfolgreich ausgeführt wird, muss das Azure Cosmos DB-Konto für manuelles Failover konfiguriert sein.

Hinweis

Wenn Sie einen manuellen Failovervorgang ausführen, während ein asynchroner Durchsatzskalierungsvorgang aktiv ist, wird der Vorgang zum horizontalen Hochskalieren des Durchsatzes angehalten. Er wird automatisch fortgesetzt, sobald der Failovervorgang abgeschlossen ist. Weitere Informationen finden Sie unter Bewährte Methoden für das Skalieren des bereitgestellten Durchsatzes (RU/s).

Warnung

Während eines Ausfalls der Schreibregion stuft das Azure Cosmos DB-Konto automatisch eine sekundäre Region über die Option dienstseitig verwaltetes Failover zur neuen primären Schreibregion hoch. Nach der Wiederherstellung wird die ursprüngliche Region aber nicht automatisch wieder als Schreibregion festgelegt. Es ist Ihre Aufgabe, die wiederhergestellte Region mithilfe von PowerShell, Azure-Befehlszeilenschnittstelle oder Azure-Portal wieder als Schreibregion festzulegen (wenn dies wie oben beschrieben als sicher gelten kann).

  1. Navigieren Sie zu Ihrem Azure Cosmos DB-Konto, und öffnen Sie das Menü Daten global replizieren.

  2. Wählen Sie im oberen Bereich des Menüs die Option Manuelles Failover aus.

    Screenshot: Menü „Daten global replizieren“.

  3. Wählen Sie im Menü Manuelles Failover Ihre neue Schreibregion aus. Aktivieren Sie das Kontrollkästchen, um anzugeben, dass Sie wissen, dass diese Option Ihre Schreibregion ändert.

  4. Wählen Sie OK aus, um das Failover zu starten.

    Screenshot: Menü „Manuelles Failover“ im Portal.