Azure Cosmos DB-Dienstkontingente und Standardgrenzwerte

In diesem Artikel werden die Standardkontingente und Grenzwerte für Azure Cosmos DB-Ressourcen erläutert. Es hilft Ihnen, Vorgänge, Speicher und Durchsatz effektiv zu verwalten.

Speicher und Datenbankvorgänge

Nach Erstellung eines Azure Cosmos DB-Kontos in Ihrem Abonnement können Sie Daten in Ihrem Konto verwalten, indem Sie Datenbanken, Container und Elemente erstellen.

Bereitgestellter Durchsatz

Sie weisen den Durchsatz auf Containerebene oder datenbankebene in Bezug auf Anforderungseinheiten (RUs) oder Anforderungseinheiten pro Sekunde (RU/s) zu. Die folgende Tabelle enthält die Grenzwerte für Speicher und Durchsatz pro Container/Datenbank. Storage bezieht sich auf die kombinierte Datenmenge und den Indexspeicher.

¹ Erhöhen Sie die maximalen RUs pro Container oder Datenbank, indem Sie ein Azure-Supportticket einreichen.

² Informationen zu bewährten Methoden für die Verwaltung von Workloads, bei denen Partitionsschlüssel höhere Grenzwerte für Speicher oder Durchsatz erfordern, finden Sie unter Erstellen eines synthetischen Partitionsschlüssels. Wenn Ihre Workload die logische Partitionsgrenze von 20 GB in der Produktion erreicht, wird die Neuerstellung Ihrer Anwendung mit einem anderen Partitionsschlüssel als langfristige Lösung empfohlen. Um Ihnen Zeit zu geben, Ihre Anwendung neu zu erstellen, fordern Sie eine temporäre Erhöhung des Grenzwerts für logische Partitionsschlüssel für Ihre vorhandene Anwendung an. Erreichen Sie ein Azure-Support-Ticket und wählen Sie den Kontingenttyp Vorübergehende Erhöhung der Schlüsselgröße der logischen Partition des Containers aus. Die Anforderung einer vorübergehenden Erhöhung ist als temporäre Entschärfung vorgesehen und wird nicht als langfristige Lösung empfohlen, da SLA-Garantien nicht berücksichtigt werden, wenn der Grenzwert erhöht wird. Um die Konfiguration zu entfernen, reichen Sie ein Support-Ticket ein und wählen Sie den Kontingenttyp Schlüsselgröße der logischen Partition des Containers auf Standardwert (20 GB) zurücksetzen aus. Sie können dieses Supportticket nach dem Löschen von Daten an den logischen Partitionsgrenzwert von 20 GB übermitteln oder Ihre Anwendung mit einem anderen Partitionsschlüssel neu erstellen.

Mindestdurchsatzwerte

Ein Azure Cosmos DB-Container (oder eine Datenbank mit gemeinsam genutztem Durchsatz) muss bei Verwendung des manuellen Durchsatzes einen Mindestdurchsatz von 400 RU/s haben. Mit zunehmendem Wachstum des Containers erfordert Azure Cosmos DB einen Mindestdurchsatz, um sicherzustellen, dass die Ressource (die Datenbank oder der Container) über genügend Ressourcen für die jeweiligen Vorgänge verfügt.

Rufen Sie den aktuellen und minimalen Durchsatz eines Containers oder einer Datenbank aus dem Azure-Portal oder den Software Development Kits (SDKs) ab. Weitere Informationen finden Sie unter Zuordnen von Durchsatz für Container und Datenbanken.

Der tatsächliche Mindestwert an RU/s kann je nach Kontokonfiguration variieren. Sie können Azure Monitor-Metriken verwenden, um den Verlauf des bereitgestellten Durchsatzes (RU/s) und des Speichers für eine Ressource anzuzeigen.

Mindestdurchsatz für Container

Schätzen Sie den minimalen Durchsatz für einen Container, der diesen Abschnitt verwendet.

Manueller Durchsatz

Ermitteln Sie die folgenden Maximalwerte, um die minimale Anzahl der RU/s zu schätzen, die für einen Container mit manuellem Durchsatz erforderlich ist:

• 400 RU/s
• Aktueller Speicher in GB · 1 RU/s
• Höchstwert bereitgestellter RU/s für den Container / 100

Beispielsweise wird ein Container mit 400 RU/s und 0 GB Speicher bereitgestellt. Sie erhöhen den Durchsatz auf 50.000 RU/s und importieren 20 GB an Daten. Die minimale Anzahl von RU/s beträgt jetzt MAX(400, 20 * 1 RU/s per GB, 50,000 RU/s / 100) = 500 RU/s. Im Laufe der Zeit wächst der Speicher auf 2.000 GB. Die minimale Anzahl von RU/s beträgt jetzt MAX(400, 2000 * 1 RU/s per GB, 50,000 / 100) = 2000 RU/s.

Automatisches Skalieren des Durchsatzes

Ermitteln Sie die folgenden Maximalwerte, um die maximale Anzahl der RU/s bei minimaler Autoskalierung zu schätzen, die für einen Container mit Autoskalierungsdurchsatz erforderlich ist:

• 1000 RU/s
• Aktueller Speicher in GB * 10 RU/s
• Höchstwert bereitgestellter RU/s für den Container / 10

Sie verfügen beispielsweise über einen Container, für den 1.000 RU/s und 0 GB Speicher bereitgestellt werden. Sie erhöhen den Durchsatz auf 50.000 RU/s und importieren 20 GB an Daten. Der Mindestwert der maximalen RU/s beträgt jetzt MAX(1000, 20 * 10 RU/s per GB, 50,000 RU/s / 10) = 5.000 RU/s. Im Laufe der Zeit wächst der Speicher auf 2.000 GB. Der Mindestwert der maximalen RU/s beträgt jetzt MAX(1000, 2000 * 10 RU/s per GB, 50,000 / 10) = 20.000 RU/s.

Mindestdurchsatz für eine Datenbank mit gemeinsam genutztem Durchsatz

Verwenden Sie diesen Abschnitt, um den minimalen Durchsatz für einen Datenbankfreigabedurchsatz über Container hinweg zu schätzen.

Manueller Durchsatz

Ermitteln Sie die folgenden Maximalwerte, um die minimale Anzahl der RU/s zu ermitteln, die für eine Datenbank mit gemeinsam genutztem Durchsatz erforderlich ist, für die der manuelle Durchsatz verwendet wird:

• 400 RU/s
• Aktueller Speicher in GB · 1 RU/s
• Höchstwert bereitgestellter RU/s für die Datenbank / 100
• 400 + MAX(Containeranzahl - 25, 0) * 100 RU/s

Sie verfügen beispielsweise über eine Datenbank, für die 400 RU/s, 15 GB Speicher und 10 Container bereitgestellt werden. Die minimale Anzahl von RU/s beträgt MAX(400, 15 * 1 RU/s per GB, 400 / 100, 400 + 0 ) = 400 RU/s. Wenn in der Datenbank 30 Container vorhanden sind, beträgt die minimale Anzahl von RU/s 400 + MAX(30 - 25, 0) * 100 RU/s = 900 RU/s.

Automatisches Skalieren des Durchsatzes

Ermitteln Sie die folgenden Maximalwerte, um die maximale Anzahl der RU/s bei minimaler Autoskalierung zu ermitteln, die für eine Datenbank mit gemeinsam genutztem Durchsatz erforderlich ist, für die der Autoskalierungsdurchsatz verwendet wird:

• 1000 RU/s
• Aktueller Speicher in GB * 10 RU/s
• Höchstwert bereitgestellter RU/s für die Datenbank / 10
• 1000 + MAX(Containeranzahl – 25, 0) * 1.000 RU/s

Sie verfügen beispielsweise über eine Datenbank, für die 1.000 RU/s, 15 GB Speicher und zehn Container bereitgestellt werden. Der Mindestwert für die maximale Anzahl von RU/s für die Autoskalierungsdatenbank beträgt MAX(1000, 15 * 10 RU/s per GB, 1000 / 10, 1000 + 0 ) = 1.000 RU/s. Wenn in der Datenbank 30 Container vorhanden sind, beträgt der Mindestwert für die maximale Anzahl von RU/s 1000 + MAX(30 - 25, 0) * 1000 RU/s = 5.000 RU/s.

Hier sehen Sie eine Zusammenfassung der RU-Mindestgrenzwerte bei Verwendung des bereitgestellten Durchsatzes.

Azure Cosmos DB unterstützt die programmgesteuerte Skalierung des Durchsatzes (RU/s) pro Container oder Datenbank über die SDKs oder das Portal.

Jede Ressource skaliert synchron und sofort zwischen den minimalen RU/s und bis zu 100x dem minimalen RU/s, je nach den aktuellen RU/s-Bereitstellungs- und Ressourceneinstellungen. Wenn der angeforderte Durchsatzwert außerhalb des Bereichs liegt, wird die Skalierung asynchron durchgeführt. Die asynchrone Skalierung kann bis zu Stunden dauern, je nach angeforderter Durchsatz- und Datenspeichergröße im Container. Weitere Informationen.

Serverlos

Mit der Option Serverlos können Sie Ihre Azure Cosmos DB-Ressourcen nutzungsbasiert verwenden. Die folgende Tabelle enthält die Grenzwerte für Speicher und Durchsatzburstfähigkeit pro Container/Datenbank. Diese Grenzwerte können nicht erhöht werden. Weisen Sie zusätzliche serverlose Konten für mehr Speicheranforderungen zu.

*Die maximale RU/s-Verfügbarkeit ist abhängig von den im Container gespeicherten Daten. Lesen Sie dazu Serverlose Leistung

Steuerungsebene

Azure Cosmos DB verfügt über einen Ressourcenanbieter, mit dem Sie Ressourcen in Ihrem Azure Cosmos DB-Konto erstellen, aktualisieren und löschen können. Der Ressourcenanbieter dient als Schnittstelle zur gesamten Azure-Ressourcenverwaltungsebene, die den Bereitstellungs- und Verwaltungsdienst für Azure darstellt.

Erstellen und Verwalten von Azure Cosmos DB-Ressourcen mithilfe von:

• Azure-Portal
• Azure PowerShell
• Azure-Befehlszeilenschnittstelle (Azure CLI)
• JSON-/Bicep-Vorlagen für Azure Resource Manager
• Azure REST-API
• Azure Management SDKs
• Terraform
• Pulumi

Auf diese Verwaltungsebene kann auch über die Azure Cosmos DB-Datenebenen-SDKs zugegriffen werden, die in Ihren Anwendungen zum Erstellen und Verwalten von Ressourcen in einem Konto verwendet werden. Datenebenen-SDKs stellen auch Steuerebenenanforderungen während der ersten Verbindung mit dem Dienst vor, um Dinge wie das Aufzählen von Datenbanken und Containern und das Anfordern von Kontoschlüsseln für die Authentifizierung auszuführen.

Jedes Azure Cosmos DB-Konto verfügt über eine primäre Partition , die alle Metadaten für das Konto enthält. Es verfügt außerdem über eine kleine Durchsatzmenge, um Vorgänge auf Steuerungsebene zu unterstützen. Steuerungsebenenanforderungen, die diese Metadaten erstellen, lesen, aktualisieren oder löschen, verbrauchen diesen Durchsatz. Wenn der von Vorgängen auf Steuerungsebene verbrauchte Durchsatz diese Menge überschreitet, werden Vorgänge begrenzt, genauso wie Vorgänge auf Datenebene in Azure Cosmos DB. Im Gegensatz zum Durchsatz für Datenvorgänge kann der Durchsatz für die primäre Partition jedoch nicht erhöht werden.

Einige Steuerungsebenenvorgänge verbrauchen keinen primären Partitionsdurchsatz, z. B. "Abrufen" oder "Listenschlüssel". Im Gegensatz zu Datenanforderungen innerhalb Ihres Azure Cosmos DB-Kontos sind Ressourcenanbieter in Azure jedoch nicht für hohe Anforderungsvolumes ausgelegt. Bei Vorgängen auf Steuerungsebene, die die dokumentierten Grenzwerte kontinuierlich in aufeinanderfolgenden fünfminütigen Zeiträumen überschreiten, kann es zu einer Anforderungsdrosselung sowie zu fehlerhaften oder unvollständigen Vorgängen für Azure Cosmos DB-Ressourcen kommen.

Vorgänge auf Steuerungsebene können überwacht werden, indem Sie auf der Registerkarte „Erkenntnisse“ für ein Azure Cosmos DB-Konto navigieren. Weitere Informationen finden Sie unter Überwachen von Steuerungsebenenanforderungen. Sie können diese Erkenntnisse anpassen, Azure Monitor verwenden und eine Arbeitsmappe erstellen, um Metadatenanforderungen zu überwachen und Warnungen festzulegen.

Ressourceneinschränkungen

In der folgenden Tabelle sind Ressourcengrenzwerte pro Abonnement oder Konto aufgeführt.

¹ Die Standardgrenzwerte unterscheiden sich für interne Microsoft-Kunden. Erhöhen Sie diese Grenzwerte, indem Sie eine Azure-Supportanfrage bis zu maximal 1.000 erstellen. Cosmos DB behält sich das Recht vor, leere Datenbankkonten, d. h. keine Datenbanken/Sammlungen, zu löschen. ² Dieser Grenzwert kann nicht erhöht werden. Die Gesamtzahl umfasst sowohl Datenbanken als auch Container innerhalb eines Kontos (z. B. 1 Datenbank und 499 Container oder 250 Datenbanken und 250 Container).

Anforderungsgrenzwerte

In der folgenden Tabelle sind Anforderungsbeschränkungen pro 5-Minuten-Intervall pro Konto aufgeführt, sofern nicht anders angegeben.

¹ Verwenden Sie einen Singleton-Client für SDK-Instanzen sowie Cacheschlüssel, Datenbank- und Containerverweise zwischen Anforderungen für die Lebensdauer dieser Instanz. ² Regionale Failover gelten nur für Konten für Schreibvorgänge in einer einzelnen Region. Bei Konten für Schreibvorgänge in mehreren Regionen ist es nicht erforderlich oder möglich, die Schreibregion zu ändern.

Azure Cosmos DB sichert Ihre Daten automatisch in regelmäßigen Abständen. Weitere Informationen zu Intervallen der Sicherungsaufbewahrung und Windows finden Sie unter Onlinesicherung und bedarfsgesteuerte Wiederherstellung in Azure Cosmos DB.

Grenzwerte pro Konto

Hier sind die Grenzwerte pro Konto.

Bereitgestellter Durchsatz

Serverlos

Grenzwerte pro Container

Abhängig von der verwendeten API kann ein Azure Cosmos DB-Container eine Auflistung, eine Tabelle oder ein Diagramm darstellen. Container unterstützen Konfigurationen für eindeutige Schlüsseleinschränkungen, gespeicherte Prozeduren, Trigger und benutzerdefinierte Funktionen (UDFs) und Indizierungsrichtlinien. Die folgende Tabelle enthält die spezifischen Grenzwerte für Konfigurationen innerhalb eines Containers.

¹ Erhöhen Sie diese Grenzwerte pro Container, indem Sie eine Azure-Supportanfrage erstellen.

Grenzwerte pro Element

Ein Azure Cosmos DB-Element kann ein Dokument in einer Auflistung, eine Zeile in einer Tabelle oder einen Knoten oder Rand in einem Diagramm darstellen, je nachdem, welche API Sie verwenden. Die folgende Tabelle zeigt die Grenzwerte pro Element in Azure Cosmos DB.

¹ Große Dokumente mit einer Größe von bis zu 16 MB werden nur mit Azure Cosmos DB for MongoDB unterstützt. Weitere Informationen finden Sie in der Featuredokumentation zu MongoDB 4.2.

Mit Ausnahme von Längeneinschränkungen bei Partitionsschlüssel- und ID-Werten sowie der Einschränkung der Gesamtgröße auf 2 MB gibt es bei den Elementnutzlasten keine Einschränkungen (also etwa für die Anzahl von Eigenschaften und die Schachtelungstiefe). Möglicherweise müssen Sie die Indizierungsrichtlinie für Container mit großen oder komplexen Elementstrukturen konfigurieren, um den RU-Verbrauch zu reduzieren. Unter Modellieren und Partitionieren von Daten in Azure Cosmos DB anhand eines praktischen Beispiels finden Sie ein praktisches Beispiel und Muster zum Verwalten großer Elemente.

Grenzwerte pro Anforderung

Azure Cosmos DB unterstützt CRUD- und Abfragevorgänge für Ressourcen wie Container, Elemente und Datenbanken. Es unterstützt auch Transaktionsbatchanforderungen für Elemente mit demselben Partitionsschlüssel in einem Container.

Azure Cosmos DB unterstützt Trigger während Schreibvorgängen. Der Dienst ermöglicht einen Vorabtrigger und einen Nachtrigger pro Schreibvorgang.

Wenn ein Abfragevorgang das Zeitlimit für die Ausführung oder die Antwortgröße erreicht, wird eine Seite mit Ergebnissen und ein Fortsetzungstoken an den Client zurückgegeben, um die Ausführung fortzusetzen. Es gibt praktisch keine Begrenzung der Dauer der Ausführung einer einzelnen Abfrage hinsichtlich Seiten/Fortsetzungen.

Azure Cosmos DB verwendet Hash-basierte Nachrichtenauthentifizierungscodes (HMAC) für die Autorisierung. Verwenden Sie einen Primärschlüssel für die feinkörnige Zugriffssteuerung für Ressourcen. Diese Ressourcen können Container, Partitionsschlüssel oder Elemente enthalten. Die folgende Tabelle enthält die Grenzwerte für Autorisierungstoken in Azure Cosmos DB.

¹ Erhöhen Sie sie, indem Sie ein Azure-Supportticket einreichen.

Grenzwerte für den per Autoskalierung bereitgestellten Durchsatz

Eine ausführliche Erläuterung der Durchsatz- und Speichergrenzwerte mit Autoskalen finden Sie im Artikel zu Autoscale und häufig gestellten Fragen .

Grenzwerte für SQL-Abfragen

Azure Cosmos DB unterstützt das Abfragen von Elementen mithilfe von SQL. In der folgenden Tabelle werden Einschränkungen in Abfrageanweisungen beschrieben, z. B. die Anzahl der Klauseln oder die Abfragelänge.

¹ Sie können diese SQL-Abfragegrenzwerte erhöhen, indem Sie eine Azure-Supportanfrage erstellen.

Für die API für MongoDB geltende Grenzwerte

Azure Cosmos DB unterstützt das MongoDB-Drahtprotokoll für Anwendungen, die mit MongoDB geschrieben wurden. Suchen Sie die unterstützten Befehle und Protokollversionen unter unterstützten MongoDB-Features und -Syntax.

Die folgende Tabelle enthält die spezifischen Grenzwerte für die Unterstützung von MongoDB-Features. Andere für die API für NoSQL erwähnte Dienstgrenzwerte gelten auch für die API für MongoDB.

¹ Für große Dokumente mit bis zu 16 MB muss das Feature im Azure-Portal aktiviert werden. Weitere Informationen finden Sie in der Featuredokumentation.

² Legen Sie das Leerlauf-Verbindungstimeout in den Treibereinstellungen auf 2-3 Minuten fest, da das Standardtimeout für Azure LoadBalancer 4 Minuten beträgt. Dieses Zeitlimit stellt sicher, dass ein zwischengeschalteter Lastenausgleich im Leerlauf keine Verbindungen zwischen dem Clientcomputer und Azure Cosmos DB schließt.

Grenzwerte für Azure Cosmos DB-Konten mit Free-Tarif

In der folgenden Tabelle sind die Grenzwerte für Kostenlose Azure Cosmos DB-Konten aufgeführt.

Zusätzlich zur vorherigen Tabelle gelten die Grenzwerte pro Konto auch für kontenfreie Konten. Weitere Informationen finden Sie unter Erstellen eines kostenlosen Kontos.

Zugehöriger Inhalt

• Globale Verteilung
• Partitionierung und bereitgestellter Durchsatz