Sdílet prostřednictvím

Přílohy

  • Článek

Azure Cosmos DB je globálně distribuovaná databáze s více modely, která podporuje datové modely dokumentů, grafů, cassandry a tabulek. Obsah v této části je určený pro správu prostředků příloh pomocí rozhraní SQL API přes REST.

Přílohy jsou speciální dokumenty, které obsahují odkazy a přidružená metadata k externímu objektu blob nebo multimediálnímu souboru.

Vývojáři se můžou rozhodnout pro:

  • Médium nebo objekt blob přílohy spravovaný službou Azure Cosmos DB nebo
  • Uložte ho s externím poskytovatelem služby blob, jako je OneDrive, Dropbox atd. a uložte referenční metadata pro přílohu ve službě Azure Cosmos DB.

Prostředek přílohy jsou reprezentovány přílohami v modelu prostředků REST služby Azure Cosmos DB. Prostředek přílohy má pevné schéma. Bez ohledu na to, kde jsou uložená nezpracovaná média, jsou vyžadovány následující vlastnosti.

Následující příklad znázorňuje konstruktor JSON přílohy dokumentu.

{    
   "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"  
}
Vlastnost Popis
id Povinná hodnota. Jedná se o uživatelsky nastavitelnou vlastnost. Jedná se o jedinečný název, který identifikuje přílohu, to znamená, že žádné dvě přílohy nesdílely stejné ID pro stejný dokument. Id nesmí být delší než 255 znaků.
contentType Povinná hodnota. Jedná se o uživatelsky nastavitelnou vlastnost. Určuje typ obsahu přílohy. Při odesílání bitů přílohy jako těla nastaví contentType Cosmos DB na typ nastavený v hlavičce Content-Type .
Media Povinná hodnota. Jedná se o odkaz URL nebo cestu k souboru, kde se příloha nachází.
_rid Jedná se o systémem vygenerovanou vlastnost. ID prostředku (_rid) je jedinečný identifikátor, který je také hierarchický podle zásobníku prostředků v modelu prostředků. Používá se interně k umístění a navigaci prostředku přílohy.
_ts Jedná se o systémem vygenerovanou vlastnost. Určuje časové razítko poslední aktualizace prostředku. Hodnota je časové razítko.
_self Jedná se o systémem vygenerovanou vlastnost. Jedná se o jedinečný adresovatelný identifikátor URI prostředku.
_etag Jedná se o systémem vygenerovanou vlastnost, která určuje etag prostředku vyžadovanou pro optimistické řízení souběžnosti.

Běžné hlavičky odpovědi

Následující informace jsou společné pro všechny odpovědi související s přílohami:

Hlavička Description
x-ms-max-media-storage-usage-mb Pokud k ukládání nezpracovaných médií používáte úložiště příloh Cosmos DB, zobrazuje tato hlavička celkovou kvótu přiděleného úložiště příloh pro účet.
x-ms-media-storage-usage-mb Pokud k ukládání nezpracovaných médií používáte úložiště příloh Cosmos DB, zobrazuje tato hlavička aktuální spotřebované úložiště příloh.

Úlohy

S přílohami můžete provádět tyto úkoly:

Obsah přílohy není indexován ani prohledávatelný; Vlastnosti prostředku přílohy jsou indexované a prohledávatelné.

Tyto operace jsou podobné operacím pro dokumenty. Místo provádění operací s dokumenty se provádějí na cestě k prostředkům příloh pod konkrétním dokumentem. Proto přeskočíme zpracování jednotlivých operací. Místo toho v další části probereme, jak vytvořit přílohu s nezpracovaným publikováním médií a publikováním pouze s metadaty.

Viz také