Freigeben über

Attachments

  • Artikel

Azure Cosmos DB ist eine global verteilte Datenbank mit mehreren Modellen, die die Dokument-, Graph-, Cassandra- und Tabellendatenmodelle unterstützt. Der Inhalt in diesem Abschnitt dient zum Verwalten von Anlagenressourcen mithilfe der SQL-API über REST.

Anlagen sind besondere Dokumente, die Verweise auf und zugehörige Metadaten für ein externes Blob oder eine Mediendatei enthalten.

Entwickler können Folgendes auswählen:

  • Die von Azure Cosmos DB verwalteten Anlagemedien/Blobs oder
  • Speichern Sie es bei einem externen Blob-Dienstanbieter wie OneDrive, Dropbox usw. und speichern Sie die Referenzmetadaten für anlagen in Azure Cosmos DB.

Die Anlageressource wird durch Anlagen im Azure Cosmos DB-REST-Ressourcenmodell dargestellt. Die attachment-Ressource verfügt über ein festes Schema. Unabhängig davon, wo die unformatierten Medien gespeichert werden, sind die folgenden Eigenschaften erforderlich.

Das folgende Beispiel zeigt das JSON-Konstrukt einer Dokumentanlage:

{    
   "id":"image13d65101-90c4-4c2a-a423-fbf221c73233",  
   "contentType":"image/jpg",  
   "media":"www.bing.com",  
   "_rid":"rnYYAMVFUAUBAAAAAAAAAEC+LNM=",  
   "_ts":1408056025,  
   "_self":"dbs\/rnYYAA==\/colls\/rnYYAMVFUAU=\/docs\/rnYYAMVFUAUBAAAAAAAAAA==\/attachments\/rnYYAMVFUAUBAAAAAAAAAEC+LNM=",  
   "_etag":"00002a00-0000-0000-0000-53ed3ad90000"  
}
Eigenschaft BESCHREIBUNG
id Erforderlich. Es handelt sich um eine vom Benutzer festgelegte Eigenschaft. Es ist der eindeutige Name, der die Anlage identifiziert. Das heißt, keine zwei Anlagen teilen dieselbe ID für dasselbe Dokument. Die ID darf nicht länger als 255 Zeichen sein.
contentType Erforderlich. Es handelt sich um eine vom Benutzer festgelegte Eigenschaft. Sie gibt den Inhaltstyp der Anlage an. Beim Übermitteln der Anlagebits als Textkörper legt Cosmos DB den contentType auf den im Content-Type Header festgelegten Typ fest.
Media Erforderlich. Dies ist der URL-Link oder Dateipfad, in dem sich die Anlage befindet.
_rid Es handelt sich um eine vom System generierte Eigenschaft. Die Ressourcen-ID (_rid) ist ein eindeutiger Bezeichner, der pro Ressourcenstapel im Ressourcenmodell ebenfalls hierarchisch ist. Sie wird intern für die Platzierung und Navigation der Anlagenressource 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.

Allgemeine Antwortheader

Die folgenden Informationen sind allen Antworten im Zusammenhang mit Anlagen gemeinsam:

Header BESCHREIBUNG
x-ms-max-media-storage-usage-mb Wenn Sie Cosmos DB-Anlagenspeicher zum Speichern von Rohdatenmedien verwenden, zeigt dieser Header das gesamt zugewiesene Anlagenspeicherkontingent für das Konto an.
x-ms-media-storage-usage-mb Bei Verwendung des Cosmos DB-Anlagenspeichers zum Speichern von Rohmedien zeigt dieser Header den aktuell verbrauchten Anlagenspeicher an.

Aufgaben

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

Der Inhalt der Anlage ist nicht indiziert oder durchsuchbar. Die Anlagenressourceneigenschaften sind indiziert und durchsuchbar.

Diese Vorgänge ähneln denen für Dokumente. Anstatt die Vorgänge für die Dokumentation auszuführen, werden sie für den Ressourcenpfad der Anlagen unter einem bestimmten Dokument ausgeführt. Daher werden die einzelnen Vorgänge nicht weiter erläutert. Stattdessen wird im nächsten Abschnitt erläutert, wie eine Anlage mit unformatierten Medien bzw. ausschließlich mit Metadaten erstellt wird.

Weitere Informationen