Share via

Bijlagen

  • Artikel

Azure Cosmos DB is een wereldwijd gedistribueerde database met meerdere modellen die ondersteuning biedt voor document-, grafiek-, cassandra- en tabelgegevensmodellen. De inhoud in deze sectie is bedoeld voor het beheren van bijlageresources met behulp van de SQL-API via REST.

Bijlagen zijn speciale documenten die verwijzingen en gekoppelde metagegevens bevatten aan een externe blob- of mediabestand.

Ontwikkelaars kunnen kiezen voor het volgende:

  • De bijlagemedia/blob die worden beheerd door Azure Cosmos DB of
  • Sla het op bij een externe blobserviceprovider, zoals OneDrive, Dropbox, enzovoort. en sla de referentiemetagegevens voor bijlagen op in Azure Cosmos DB.

De bijlageresource wordt vertegenwoordigd door bijlagen in het Azure Cosmos DB REST-resourcemodel. De bijlageresource heeft een vast schema. Ongeacht waar de onbewerkte media zijn opgeslagen, zijn de volgende eigenschappen vereist.

In het volgende voorbeeld ziet u de JSON-constructie van een documentbijlage.

{    
   "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"  
}
Eigenschap Beschrijving
id Vereist. Het is een eigenschap die door de gebruiker kan worden ingesteld. Het is de unieke naam die de bijlage identificeert, dat wil gezegd dat geen twee bijlagen dezelfde id voor hetzelfde document delen. De id mag niet langer zijn dan 255 tekens.
contentType Vereist. Het is een eigenschap die door de gebruiker kan worden ingesteld. Hiermee wordt het inhoudstype van de bijlage opgegeven. Bij het verzenden van de bijlage-bits als de hoofdtekst, stelt Cosmos DB de contentType in op het type dat is ingesteld in de Content-Type koptekst.
Media Vereist. Dit is de URL-koppeling of het bestandspad waar de bijlage zich bevindt.
_rid Het is een door het systeem gegenereerde eigenschap. De resource-id (_rid) is een unieke id die ook hiërarchisch is volgens de resourcestack in het resourcemodel. Deze wordt intern gebruikt voor de plaatsing en navigatie van de bijlageresource.
_ts Het is een door het systeem gegenereerde eigenschap. Hiermee geeft u de laatst bijgewerkte tijdstempel van de resource op. De waarde is een tijdstempel.
_self Het is een door het systeem gegenereerde eigenschap. Dit is de unieke adresseerbare URI voor de resource.
_etag Het is een door het systeem gegenereerde eigenschap die de resource-etag aangeeft die is vereist voor optimistisch gelijktijdigheidsbeheer.

Algemene antwoordheaders

De volgende informatie is gemeenschappelijk voor alle antwoorden met betrekking tot bijlagen:

Header Beschrijving
x-ms-max-media-storage-usage-mb Wanneer u Cosmos DB-bijlageopslag gebruikt voor het opslaan van onbewerkte media, toont deze kop het totale toegewezen opslagquotum voor bijlagen voor het account.
x-ms-media-storage-usage-mb Wanneer u Cosmos DB-bijlageopslag gebruikt voor het opslaan van onbewerkte media, toont deze header de huidige opslag van bijlagen die is verbruikt.

Taken

U kunt deze taken uitvoeren met bijlagen:

De inhoud van de bijlage is niet geïndexeerd of doorzoekbaar; de eigenschappen van de bijlageresource zijn geïndexeerd en doorzoekbaar.

Deze bewerkingen zijn vergelijkbaar met de bewerkingen voor Documenten. In plaats van de bewerkingen uit te voeren op de documenten, worden ze uitgevoerd op basis van het resourcepad voor bijlagen onder een bepaald document. Daarom slaan we het uitwerken van elk van de bewerkingen over. In plaats daarvan wordt in de volgende sectie besproken hoe u een bijlage maakt met onbewerkte media en met het plaatsen van alleen metagegevens.

Zie ook