Dokumente

  • Artikel

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 Dokumentressourcen mithilfe der SQL-API über REST.

Die Dokumentressource wird im Azure Cosmos DB-Ressourcenmodell dargestellt docs . Ein Dokument besteht aus benutzerdefiniertem Inhalt im JSON-Format. Abgesehen von der erforderlichen ID-Eigenschaft können Benutzer beliebige Elemente, Strukturen und Hierarchien für den Inhalt definieren. Das ID-Element ist eine eindeutige Zeichenfolge, die vom Benutzer festgelegt werden kann und 255 Zeichen nicht überschreiten darf. Sie können beliebige JSON-Dokumente zu einer Sammlung hinzufügen, sie dort ersetzen, löschen, lesen, aufzählen und abfragen.

Azure Cosmos DB erfordert keine Schema- oder sekundären Indizes, um abfragen von Dokumenten in einer Sammlung zu unterstützen. Dokumente werden standardmäßig automatisch und konsistent indiziert, sodass ein Dokument sofort nach seiner Erstellung befragt werden kann.

  • Dokumente werden in Sammlungen gespeichert. Weitere Informationen zu Sammlungen finden Sie unter Sammlungen.
  • Ein Dokument kann mindestens eine Anlage enthalten. Weitere Informationen zu Anlagen finden Sie unter Anlagen.
  • Der Benutzerzugriff auf Dokumente kann über Berechtigungen verwaltet werden. Weitere Informationen zu Berechtigungen finden Sie unter Berechtigungen.

Dieses JSON-Beispieldokument zeigt den Eintrag für einen Vulkan in einer Sammlung. Der Eintrag enthält den Vulkannamen, Standortinformationen einschließlich Geodaten und systemdefinierte Elemente wie _rid, _ts, _self, _etag und _attachments.

{  
  "Volcano Name": "Agua de Pau",  
  "Country": "Portugal",  
  "Region": "Azores",  
  "Location": {  
    "type": "Point",  
    "coordinates": [  
      -25.47,  
      37.77  
    ]  
  },  
  "Elevation": 947,  
  "Type": "Stratovolcano",  
  "Status": "Historical",  
  "Last Known Eruption": "Last known eruption from 1500-1699, inclusive",  
  "id": "d44c94b6-81f8-4b27-4970-f79b149529d3",  
  "_rid": "Sl8fALN4sw4BAAAAAAAAAA==",  
  "_ts": 1448049512,  
  "_self": "dbs/Sl8fAA==/colls/Sl8fALN4sw4=/docs/Sl8fALN4sw4BAAAAAAAAAA==/",  
  "_etag": "\"0000443f-0000-0000-0000-564f7b680000\"",  
  "_attachments": "attachments/"  
}
Eigenschaft BESCHREIBUNG
id Erforderlich. Es handelt sich um eine vom Benutzer festgelegte Eigenschaft. Es ist der eindeutige Name, der das Dokument identifiziert. Das heißt, keine zwei Dokumente teilen dieselbe ID innerhalb einer logischen Partition. Partition und ID identifizieren ein Element in der Datenbank eindeutig. Das Id-Feld darf nicht länger als 255 Zeichen sein.
_los Es handelt sich um eine vom System generierte Eigenschaft. Die Ressourcen-ID (_rid) ist ein eindeutiger Bezeichner, der auch je nach Ressourcenstapel im Ressourcenmodell hierarchisch ist. Sie wird intern für die Platzierung und Navigation der Dokumentressource 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.
_Anlagen Es handelt sich um eine vom System generierte Eigenschaft, die den adressierbaren Pfad für die Anlageressource angibt.

Aufgaben

Sie können die folgenden Aufgaben mit Dokumenten ausführen:

Weitere Informationen