Angebote

Azure Cosmos DB ist eine global verteilte Datenbank mit mehreren Modellen, die dokument-, graph- und schlüsselwertbasierte Datenmodelle unterstützt. Der Inhalt in diesem Abschnitt ist für das Erstellen, Abfragen und Verwalten von Angeboten mithilfe der SQL-API über REST.

Jede Azure Cosmos Db-Sammlung wird mit einer zugeordneten Leistungsstufe bereitgestellt, die als Angebotsressource im REST-Modell dargestellt wird. Azure Cosmos DB unterstützt Angebote, die sowohl benutzerdefinierte Als auch vordefinierte Leistungsebenen darstellen. Jedem Angebot ist ein Ru-Grenzwert (Request Unit) zugeordnet. Es handelt sich um den Durchsatz, der für eine Sammlung basierend auf der Leistungsstufe reserviert ist und ausschließlich von dieser Sammlung verwendet werden kann.

Die Angebotsressource wird durch Angebote im Cosmos Db-Ressourcenmodell dargestellt. Hier ist 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 – für V2-Angebote enthält dies den Durchsatz der Sammlung.
resource Erforderlich. Beim Erstellen einer neuen Sammlung wird diese Eigenschaft auf die Selbstverknüpfung der Sammlung festgelegt, z. B. dbs/pLJdAA==/colls/pLJdAOlEdgA=/.
offerResourceId Erforderlich. Während der Erstellung einer Sammlung wird diese Eigenschaft automatisch der Ressourcen-ID zugeordnet, d. _rid der Sammlung. Im obigen Beispiel ist 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. Sie hat den gleichen Wert wie die _rid für das Angebot.
_rid 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.
_self 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, gültig zwischen 400 und 10000.

Aufgaben

Folgendes können Sie mit Angeboten tun:

Weitere Informationen