Schnellstart: Erstellen Sie über das Azure-Portal ein Azure Cosmos DB for NoSQL-Konto

  • Artikel

GILT FÜR: NoSQL

In diesem Schnellstart erstellen Sie ein neues Azure Cosmos DB for NoSQL-Konto im Azure-Portal. Sie verwenden dann die Daten-Explorer-Erfahrung im Azure-Portal, um eine Datenbank und einen Container zu erstellen und alle erforderlichen Einstellungen zu konfigurieren. Schließlich fügen Sie dem Container Beispieldaten hinzu und führen eine einfache Abfrage durch.

Voraussetzungen

Erstellen eines Kontos

Beginnen Sie mit der Erstellung eines neuen Kontos für Azure Cosmos DB for NoSQL

  1. Melden Sie sich beim Azure-Portal (https://portal.azure.com) an.

  2. Geben Sie Azure Cosmos DB in die globale Suchleiste ein.

    Screenshot der globalen Suchleiste im Azure-Portal.

  3. Wählen Sie in Diensten Azure Cosmos DB aus.

    Screenshot der im Suchmenü ausgewählten Option Azure Cosmos DB.

  4. Wählen Sie im Bereich Azure Cosmos DB die Option Create und dann Azure Cosmos DB for NoSQL.

    Screenshot der Option Create im Fenster für einen Azure-Dienst.

    Screenshot des Azure Cosmos DB API-Auswahlbereich mit hervorgehobener API für NoSQL.

  5. Konfigurieren Sie im Bereich Allgemeine Informationen die folgenden Optionen, und wählen Sie dann Bewertung + Create:

    Wert
    Abonnement Wählen Sie Ihr Azure-Abonnement aus.
    Ressourcengruppe Erstellen Sie eine neue Ressourcengruppe, oder wählen Sie eine vorhandene Ressourcengruppe aus
    Account Name Geben Sie einen global eindeutigen Namen an.
    Verfügbarkeitszonen Deaktivieren
    Location Wählen Sie eine unterstützte Azure-Region für Ihre Subscription

    Screenshot des Azure Cosmos DB for NoSQL-Ressourcenerstellungsfensters „Allgemeine Informationen“.

    Tipp

    Sie können alle nicht spezifizierten Optionen auf ihren Standardwerten belassen. Sie können das Konto auch so konfigurieren, dass der Gesamtdurchsatz des Kontos auf 1.000 Abfrageeinheiten pro Sekunde (RU/s) begrenzt wird, und die kostenlose Stufe aktivieren, um Ihre Kosten zu minimieren.

  6. Warten Sie im Bereich Bewertung + Create, bis die Validierung Ihres Kontos erfolgreich abgeschlossen ist, und wählen Sie dann Create.

    Screenshot des Schrittes der Ressourcenvalidierung während der Erstellung.

  7. Das Portal navigiert automatisch zum Bereitstellungsbereich. Warten Sie, bis die Bereitstellung abgeschlossen ist.

    Screenshot des Verteilungsfensters mit einer aktuell anstehenden Verteilung.

  8. Sobald die Bereitstellung abgeschlossen ist, wählen Sie Gehe zu Ressource, um zum neuen Azure Cosmos DB for NoSQL-Konto zu navigieren.

    Screenshot einer vollständig bereitgestellten Ressource mit hervorgehobener Option „Gehe zu Ressource“.

Erstellen einer Datenbank und eines Containers

Verwenden Sie anschließend den Daten-Explorer, um eine Datenbank und einen Container im Portal zu erstellen.

  1. Wählen Sie im Kontoressourcenbereich im Dienstmenü die Option Daten-Explorer.

    Screenshot der Option Daten-Explorer im Servicemenü für das Konto.

  2. Wählen Sie im Bereich Daten-Explorer die Option Neuer Container.

    Screenshot der Option „Neuer Container“ im Datenexplorer.

  3. Konfigurieren Sie im Dialogfeld Neuer Container die folgenden Werte und wählen Sie dann OK:

    Wert
    Datenbank Neu erstellen
    Datenbank-ID cosmicworks
    Share throughput across containers (Durchsatz zwischen Containern freigeben) Aktivieren Sie dieses Kontrollkästchen nicht.
    Container-ID employees
    Partitionsschlüssel department/name
    Containerdurchsatz (Autoskalierung) Automatische Skalierung
    Container Max RU/s 1000

    Screenshot des Dialogs zum Erstellen einer neuen Datenbank und eines Containers mit den angegebenen Optionen.

  4. Erstellen Sie eine neue Datei mit dem Namen demo.bicepparam oder (demo.bicepparam).

  5. Beobachten Sie die neu erstellte Datenbank und den Container in der Hierarchie des Daten-Explorer.

    Screenshot der Daten-Explorer-Hierarchie mit vorhandenem Datenbankcontainer.

    Tipp

    Optional können Sie den Containerknoten erweitern, um weitere Eigenschaften und Konfigurationseinstellungen zu sehen.

Hinzufügen und Abfragen von Beispieldaten

Verwenden Sie schließlich den Daten-Explorer, um ein Musterartikel zu erstellen und dann eine einfache Abfrage an den Container zu stellen.

  1. Erweitern Sie den Knoten für den Container Mitarbeiter im Baum des Data Explorer. Wählen Sie dann die Option Artikel.

    Screenshot der Option „Elemente“ innerhalb eines Containers in der Hierarchie des Daten-Explorer.

  2. Wählen Sie im Menü des Daten-Explorer die Option Neues Element.

    Screenshot der Option „Neues Element“ im Menü des Datenexplorers.

  3. Fügen Sie nun das folgende JSON für ein neues Element in den Mitarbeiter-Container ein und wählen Sie dann Speichern:

    {
  "id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
  "name": {
    "first": "Kai",
    "last": "Carter"
  },
  "email": "<kai@adventure-works.com>",
  "department": {
    "name": "Logistics"
  }
}

    Screenshot des JSON-Inhalts für ein neues Element im Daten-Explorer.

  4. Wählen Sie im Menü des Daten-Explorer die Option Neue SQL-Abfrage.

    Screenshot der Option „Neue SQL-Abfrage“ im Menü Data Explorer.

  5. Fügen Sie nun die folgende NoSQL-Abfrage ein, um alle Elemente für die Abteilung logistics mit einer Groß-/Kleinschreibung-unabhängigen Suche zu erhalten. Die Abfrage formatiert dann die Ausgabe als strukturiertes JSON-Objekt. Führen Sie die Abfrage aus, indem Sie Abfrage ausführen wählen:

    SELECT VALUE {
    "name": CONCAT(e.name.last, " ", e.name.first),
    "department": e.department.name,
    "emailAddresses": [
        e.email
    ]
}
FROM
    employees e
WHERE
    STRINGEQUALS(e.department.name, "logistics", true)

    Screenshot von NoSQL-Abfragetext im Data Explorer.

  6. Beobachten Sie die JSON-Array-Ausgabe der Abfrage.

    [
  {
    "name": "Carter Kai",
    "department": "Logistics",
    "emailAddresses": [
      "kai@adventure-works.com"
    ]
  }
]

    Screenshot der Ergebnisse der Ausführung der vorherigen NoSQL-Abfrage im Data Explorer.

Zugehöriger Inhalt