Grundlegende Vorgänge

  • 5 Minuten

Es gibt einige grundlegende Vorgänge, die Sie jedes Mal ausführen müssen, wenn Sie eine Azure Cosmos DB for NoSQL-Kontoressource in Azure erstellen.

Erstellen eines neuen Kontos

Der erste Schritt mit Azure Cosmos DB besteht darin, ein neues Konto zu erstellen.

Beim Erstellen eines neuen Kontos im Portal müssen Sie zunächst eine API für Ihre Workload auswählen. Die API-Auswahl kann nach dem Erstellen des Kontos nicht mehr geändert werden. Im weiteren Verlauf dieses Abschnitts wird davon ausgegangen, dass die NoSQL-API ausgewählt wurde.

Screenshot showing the select API option in the portal with a list of all current APIs including SQL, MongoDB, Graph, Table, and Cassandra.

Als Nächstes wird im Azure-Portal ein Assistent mit schrittweisen Anleitungen und Registerkarten für verschiedene Konfigurationsoptionen verwendet. Hier können Sie z. B. folgende Optionen konfigurieren:

  • Den global eindeutigen Namen Ihres Kontos
  • Den Standort (Azure-Region) für das Konto
  • Den Kapazitätsmodus (bereitgestellter Durchsatz oder serverlos)

Screenshot showing the wizard with various tabs and options for creating a new Azure Cosmos DB for NoSQL account.

Hinweis

Nur die Optionen auf der Registerkarte Grundlagen sind erforderlich, um ein Azure Cosmos DB-Konto zu erstellen.

Erstellen einer neuen Datenbank

Datenbanken sind logische Verwaltungseinheiten in Azure Cosmos DB for NoSQL und erfordern nicht viel zur Erstellung. Es ist lediglich ein eindeutiger Datenbankname innerhalb des Kontos erforderlich, um eine neue Datenbank zu erstellen.

Hinweis

Wenn Sie sich jedoch für die Bereitstellung von Durchsatz auf Datenbankebene entscheiden, sind möglicherweise zusätzliche Schritte zum Konfigurieren der Datenbank erforderlich. Dies wird unter anderen Themen zu Azure Cosmos DB for NoSQL genauer erläutert.

Erstellen eines neuen Containers

Container sind die primäre Einheit für die Skalierbarkeit in Azure Cosmos DB for NoSQL. Beim Erstellen eines Containers sollten Sie Folgendes angeben:

  • Die übergeordnete Datenbank
  • Einen eindeutigen Namen für den Container mit der Datenbank
  • Den Pfad für den Partitionsschlüsselwert
  • Optional: Bereitgestellter Durchsatz, wenn dieser nicht aus der Datenbankbereitstellung abgeleitet wird

Der Azure Cosmos DB-Dienst partitioniert Ihre Daten automatisch und transparent basierend auf dem Wert des Partitionsschlüssels für jedes einzelne Element.

Erstellen einfacher Elemente

Sobald die Datenbank- und Containerressourcen vorhanden sind, können Sie Ihr erstes Element erstellen. In Azure Cosmos DB for NoSQL ist ein Element ein JSON-Dokument.

Hinweis

JavaScript Object Notation (JSON) ist ein Dateiformat mit offenem Standard und ein Datenaustauschformat, das von Menschen lesbaren Text zum Speichern und Übertragen von Datenobjekten verwendet, die aus Attribut-Wert-Paaren und Arraydatentypen (oder einem anderen serialisierbaren Wert) bestehen.

JSON ist ein sprachunabhängiges Datenformat mit klar definierten Datentypen und nahezu universeller Unterstützung für eine Vielzahl von Diensten und Programmiersprachen. Hier sehen Sie ein Beispiel für ein JSON-Dokument, bei dem es sich um ein Element in einem Azure Cosmos DB-Konto handeln könnte:

{
  "id": "0012D555-C7DE",
  "type": "customer",
  "fullName": "Franklin Ye",
  "title": null,
  "emailAddress": "fye@cosmic.works",
  "creationDate": "2014-02-05",
  "addresses": [
    {
      "addressLine": "1796 Westbury Drive",
      "cityStateZip": "Melton, VIC 3337 AU"
    },
    {
      "addressLine": "9505 Hargate Court",
      "cityStateZip": "Bellflower, CA 90706 US"
    }
  ],
  "password": {
    "hash": "GQF7qjEgMk=",
    "salt": "12C0F5A5"
  },
  "salesOrderCount": 2
}