Schnellstart: Erstellen eines Azure Cosmos-Kontos, einer Datenbank, eines Containers sowie von Elementen mit dem Azure-Portal

GILT FÜR: SQL-API

Azure Cosmos DB ist ein global verteilter Datenbankdienst von Microsoft mit mehreren Modellen. Sie können Azure Cosmos DB verwenden, um schnell Schlüssel/Wert-, Dokument- und Graph-Datenbanken zu erstellen und abzufragen, und dabei stets die Vorteile der globalen Verteilung und der horizontalen Skalierung nutzen, die Azure Cosmos DB zugrunde liegen.

In dieser Schnellstartanleitung wird veranschaulicht, wie Sie mithilfe des Azure-Portals ein SQL-API-Konto, eine Dokumentdatenbank und einen Container für Azure Cosmos DB erstellen und dem Container Daten hinzufügen. Sie können ein kostenloses Azure Cosmos DB-Testkonto einrichten, ohne eine Kreditkarte oder ein Azure-Abonnement zu benötigen.

Voraussetzungen

Azure-Abonnement oder kostenloses Azure Cosmos DB-Testkonto

Erstellen eines Azure Cosmos DB-Kontos

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

  2. Suchen Sie auf der Seite Neu nach Azure Cosmos DB, und wählen Sie die Option aus.

  3. Wählen Sie auf der Seite API-Option auswählen die Option Erstellen im Abschnitt Core( SQL) – Empfehlen aus. Azure Cosmos DB stellt fünf APIs bereit: Core (SQL) und MongoDB für Dokumentdaten, Gremlin für Diagrammdaten sowie Azure Table und Cassandra. Derzeit müssen Sie ein separates Konto für jede API erstellen. Weitere Informationen zur SQL-API

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

    Einstellung Wert BESCHREIBUNG
    Subscription Abonnementname Wählen Sie das Azure-Abonnement aus, das Sie für dieses Azure Cosmos-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 ein, der Ihr Azure Cosmos-Konto identifiziert. 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 bis 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 1000 RUs/Sek. sowie 25 GB Speicher kostenlos in einem Konto. Weitere Informationen zum Tarif „Free“

    Hinweis

    Sie können pro Azure-Abonnement maximal ein Azure Cosmos DB-Konto im Free-Tarif einrichten und müssen sich beim Erstellen des Kontos anmelden. 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.

    Die Seite „Neues Konto“ für Azure Cosmos DB

  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.

    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
    • Georedundanz
    • Schreibvorgänge in mehreren Regionen
  6. Optional können Sie auf den folgenden Registerkarten weitere Details konfigurieren:

    • Netzwerk: Konfigurieren Sie den Zugriff über ein virtuelles Netzwerk.
    • 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, mit denen Sie Ressourcen kategorisieren und eine konsolidierte Abrechnung anzeigen können, 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.

    Der Bereich „Benachrichtigungen“ im Azure-Portal

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

    Seite des Azure Cosmos DB-Kontos

Hinzufügen einer Datenbank und eines Containers

Sie können mit dem Daten-Explorer im Azure-Portal eine Datenbank und einen Container erstellen.

  1. Wählen Sie auf der Azure Cosmos DB-Kontoseite im linken Navigationsbereich die Option Daten-Explorer und dann Neuer Container aus.

    Unter Umständen müssen Sie nach rechts scrollen, um das Fenster Container hinzufügen anzuzeigen.

    Daten-Explorer im Azure-Portal, Bereich „Container hinzufügen“

  2. Geben Sie im Bereich Container hinzufügen die Einstellungen für den neuen Container ein.

    Einstellung Vorgeschlagener Wert BESCHREIBUNG
    Datenbank-ID ToDoList Geben Sie ToDoList als Namen für die neue Datenbank ein. Datenbanknamen müssen zwischen 1 und 255 Zeichen lang sein und dürfen weder /, \\, #, ? noch nachgestellte Leerzeichen enthalten. Aktivieren Sie die Option Durchsatz über Container hinweg teilen. Diese Option ermöglicht es Ihnen, den für die Datenbank bereitgestellten Durchsatz auf alle Container in der Datenbank zu verteilen. Darüber hinaus hilft sie Ihnen dabei, Kosten zu sparen.
    Datenbank-Durchsatz Sie können automatische Skalierung oder manuellen Durchsatz bereitstellen. Mit dem manuellen Durchsatz können Sie die Anforderungseinheiten pro Sekunde (RU/Sekunde) selbst skalieren, während der automatisch skalierte Durchsatz dem System ermöglicht, die RU/Sekunde basierend auf der Nutzung zu skalieren. Wählen Sie für dieses Beispiel Manuell aus.

    Belassen Sie den Durchsatz bei 400 Anforderungseinheiten pro Sekunde (RU/s). Wenn Sie die Latenz reduzieren möchten, können Sie den Durchsatz später hochskalieren, indem Sie die erforderlichen RU/s mit dem Kapazitätsrechner schätzen.

    Hinweis: Diese Einstellung ist nicht verfügbar, wenn ein neuer Container in einem serverlosen Konto erstellt wird.
    Container-ID Items Geben Sie Items als Namen für den neuen Container ein. Für Container-IDs gelten dieselben Zeichenanforderungen wie für Datenbanknamen.
    Partitionsschlüssel /category Das in diesem Artikel beschriebene Beispiel verwendet /category als Partitionsschlüssel.

    Fügen Sie für dieses Beispiel keine eindeutigen Schlüssel hinzu, oder aktivieren Sie den Analysespeicher nicht. Mit eindeutigen Schlüsseln können Sie die Datenbank mit einer Datenintegritätsebene versehen, indem Sie die Eindeutigkeit von Werten per Partitionsschlüssel sicherstellen. Weitere Informationen finden Sie unter Einmalige Schlüssel in Azure Cosmos DB.Analytischer Speicher wird verwendet, um umfangreiche Analysen von Betriebsdaten ohne Auswirkungen auf Ihre Transaktionsarbeitslasten zu ermöglichen.

  3. Klicken Sie auf OK. Im Daten-Explorer werden die neue Datenbank und der Container angezeigt, die Sie erstellt haben.

Hinzufügen von Daten zu Ihrer Datenbank

Verwenden Sie den Daten-Explorer, um Ihrer neuen Datenbank Daten hinzuzufügen.

  1. Erweitern Sie im Daten-Explorer die Datenbank ToDoList und dann den Container Elemente. Wählen Sie als Nächstes Elemente und dann Neues Element aus.

    Erstellen neuer Dokumente im Daten-Explorer im Azure-Portal

  2. Fügen Sie dem Dokument rechts im Bereich Dokumente die folgende Struktur hinzu:

    {
        "id": "1",
        "category": "personal",
        "name": "groceries",
        "description": "Pick up apples and strawberries.",
        "isComplete": false
    }
    
  3. Wählen Sie Speichern aus.

    Einfügen von JSON-Daten und Auswählen von „Speichern“ im Daten-Explorer im Azure-Portal

  4. Wählen Sie erneut Neues Element aus, und erstellen und speichern Sie ein weiteres Dokument mit einer eindeutigen id und weiteren gewünschten Eigenschaften und Werten. Ihre Dokumente können eine beliebige Struktur aufweisen, da Azure Cosmos DB kein Schema für Ihre Daten vorgibt.

Abfragen Ihrer Daten

Sie können zum Abrufen und Filtern Ihrer Daten Abfragen im Daten-Explorer verwenden.

  1. Sehen Sie sich im Daten-Explorer oben auf der Registerkarte Elemente die Standardabfrage SELECT * FROM c an. Diese Abfrage ruft alle Dokumente aus dem Container ab und zeigt sie nach ID sortiert an.

    Die Standardabfrage im Daten-Explorer ist „SELECT * FROM c“.

  2. Wählen Sie zum Ändern der Abfrage Filter bearbeiten aus, ersetzen Sie die Standardabfrage durchORDER BY c._ts DESC, und wählen Sie dann Filter anwenden aus.

    Ändern Sie die Standardabfrage, indem Sie „ORDER BY c._ts DESC“ hinzufügen und auf „Filter anwenden“ klicken.

    Mithilfe der geänderten Abfrage werden die Dokumente auf Basis ihrer Zeitstempel in absteigender Reihenfolge angezeigt, sodass Ihr zweites Dokument nun zuerst aufgeführt wird.

    Abfrage in „ORDER BY c._ts DESC“ geändert und Klicken auf „Filter anwenden“

Wenn Sie mit der SQL-Syntax vertraut sind, können Sie eine der unterstützten SQL-Abfragen in das Feld für das Abfrageprädikat eingeben. Der Daten-Explorer kann auch zum Erstellen von gespeicherten Prozeduren, UDFs und Triggern für serverseitige Geschäftslogik verwendet werden.

Der Daten-Explorer ermöglicht über das Azure-Portal einfachen Zugriff auf die gesamten integrierten programmgesteuerten Datenzugriffsfunktionen in den APIs. Sie verwenden das Portal außerdem zum Skalieren des Durchsatzes, zum Abrufen von Schlüsseln und Verbindungszeichenfolgen sowie zum Überprüfen von Metriken und SLAs für Ihr Azure Cosmos DB-Konto.

Bereinigen von Ressourcen

Wenn Sie Ihre App und das Azure Cosmos DB-Konto fertiggestellt haben, können Sie die erstellten Azure-Ressourcen löschen, damit keine weiteren Gebühren anfallen. So löschen Sie die Ressourcen:

  1. Suchen Sie über die Suchleiste des Azure-Portals nach Ressourcengruppen, und wählen Sie die entsprechende Option aus.

  2. Wählen Sie in der Liste die Ressourcengruppe aus, die Sie für diesen Schnellstart erstellt haben.

    Auswählen der zu löschenden Ressourcengruppe

  3. Wählen Sie auf der Seite Übersicht der Ressourcengruppe die Option Ressourcengruppe löschen aus.

    Löschen der Ressourcengruppe

  4. Geben Sie in dem nächsten Fenster den Namen der zu löschenden Ressourcengruppe ein, und wählen Sie dann Löschen aus.

Wenn Sie nur die Datenbank löschen und in Zukunft das Azure Cosmos-Konto verwenden möchten, können Sie zum Löschen der Datenbank die folgenden Schritte ausführen:

  • Navigieren Sie zu Ihrem Azure Cosmos-Konto.
  • Öffnen Sie Daten-Explorer, klicken Sie mit der rechten Maustaste auf die zu löschende Datenbank, und wählen Sie Datenbank löschen aus.
  • Geben Sie die ID bzw. den Namen der Datenbank ein, um den Löschvorgang zu bestätigen.

Nächste Schritte

In diesem Schnellstart haben Sie gelernt, wie Sie ein Azure Cosmos DB-Konto, eine Datenbank und einen Container mit dem Daten-Explorer erstellen. Jetzt können Sie zusätzliche Daten in Ihr Azure Cosmos DB-Konto importieren.

Versuchen Sie, die Kapazitätsplanung für eine Migration zu Azure Cosmos DB durchzuführen? Sie können Informationen zu Ihrem vorhandenen Datenbankcluster für die Kapazitätsplanung verwenden.