Angebote

Azure Cosmos DB ist eine global verteilte Datenbank mit mehreren Modellen, die die Dokument-, Graph- und Schlüssel-Wert-Datenmodelle unterstützt. Der Inhalt in diesem Abschnitt dient zum Erstellen, Abfragen und Verwalten von Angeboten mithilfe der SQL-API über REST.

Jede Azure Cosmos DB-Sammlung wird mit einer zugeordneten Leistungsstufe bereitgestellt, die im REST-Modell als Angebotsressource dargestellt wird. Azure Cosmos DB unterstützt Angebote, die sowohl benutzerdefinierte Leistungsstufen als auch vordefinierte Leistungsebenen darstellen. Jedes Angebot verfügt über ein zugeordnetes Ratelimit für Anforderungseinheiten (Request Unit, RU). Es ist der Durchsatz, der basierend auf ihrer Leistungsstufe für eine Sammlung reserviert ist und ausschließlich von dieser Sammlung verwendet werden kann.

Die Angebotsressource wird durch Angebote im Cosmos DB-Ressourcenmodell dargestellt. Hier sehen Sie ein Beispiel für den URI: https://mydbaccount.documents.azure.com/offers.

Das folgende Beispiel veranschaulicht das JSON-Konstrukt eines Angebots mit benutzerdefiniertem Durchsatz (V2):

{  
  "offerVersion": "V2",  
  "offerType": "Invalid",  
  "_rid": "Hu+t",  
  "content": {  
    "offerThroughput": 500  
  },  
  "resource": "dbs/yEcCAA==/colls/yEcCAPX6aAw=/",  
  "offerResourceId": "yEcCAPX6aAw=",  
  "id": "Hu+t",  
  "_self": "offers/Hu+t/",  
  "_etag": "\"00009100-0000-0000-0000-56fa9a1f0000\"",  
  "_ts": 1459264031  
}  
  
Eigenschaft Beschreibung
offerVersion Erforderlich. V2 ist die aktuelle Version für den anforderungseinheitsbasierten Durchsatz.
content Erforderlich. Enthält Informationen zum Angebot – bei V2-Angeboten enthält dies den Durchsatz der Sammlung.
resource Erforderlich. Beim Erstellen einer neuen Auflistung wird diese Eigenschaft auf die Selbstverknüpfung der Auflistung festgelegt, z. B. dbs/pLJdAA==/colls/pLJdAOlEdgA=/.
offerResourceId Erforderlich. Während der Erstellung einer Sammlung wird diese Eigenschaft automatisch der Ressourcen-ID zugeordnet, d. h. _rid der Auflistung. Im obigen Beispiel lautet die _rid für die Auflistung pLJdAOlEdgA=.
ID Es handelt sich um eine vom System generierte Eigenschaft. Die ID für die Angebotsressource wird automatisch generiert, wenn sie erstellt wird. Es hat den gleichen Wert wie die _rid für das Angebot.
_los Es handelt sich um eine vom System generierte Eigenschaft. Die Ressourcen-ID (_rid) ist ein eindeutiger Bezeichner, der auch für den Ressourcenstapel im Ressourcenmodell hierarchisch ist. Sie wird intern für die Platzierung und Navigation des Angebots verwendet.
_Ts Es handelt sich um eine vom System generierte Eigenschaft. Sie gibt den zuletzt aktualisierten Zeitstempel der Ressource an. Der Wert ist ein Zeitstempel.
_Selbst Es handelt sich um eine vom System generierte Eigenschaft. Es handelt sich um den eindeutigen, adressierbaren URI für die Ressource.
_Etag Es handelt sich um eine vom System generierte Eigenschaft, die das Ressourcen-etag angibt, das für die Steuerung der optimistischen Parallelität erforderlich ist.

Eigenschaften des Inhalts

Eigenschaft Beschreibung
offerThroughput Erforderlich. Der bereitgestellte Durchsatz in Anforderungseinheiten pro Sekunde als Zahl.
Muss ein Vielfaches von 100 sein, beginnend bei 2500.
Für Sammlungen ohne Partitionsschlüssel gilt zwischen 400 und 10000.

Aufgaben

Mit Angeboten können Sie folgende Aktionen ausführen:

Weitere Informationen