Share via

Mellékletek

  • Cikk

Az Azure Cosmos DB egy globálisan elosztott többmodelles adatbázis, amely támogatja a dokumentum-, gráf-, cassandra- és táblaadatmodelleket. A jelen szakasz tartalma a melléklet-erőforrások REST-en keresztüli SQL API-val történő kezelésére használható.

A mellékletek olyan speciális dokumentumok, amelyek hivatkozásokat és társított metaadatokat tartalmaznak egy külső blobhoz vagy médiafájlhoz.

A fejlesztők a következőket választhatják:

  • Az Azure Cosmos DB vagy a
  • Tárolja egy külső blobszolgáltatónál, például a OneDrive-on, a Dropboxban stb. és tárolja a mellékletek referencia-metaadatait az Azure Cosmos DB-ben.

A mellékleterőforrást az Azure Cosmos DB REST-erőforrásmodell mellékletei jelölik. A mellékleterőforrás rögzített sémával rendelkezik. Függetlenül attól, hogy hol tárolja a nyers adathordozót, a következő tulajdonságokra van szükség.

Az alábbi példa egy dokumentummelléklet JSON-szerkezetét szemlélteti.

{    
   "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"  
}
Tulajdonság Leírás
id Kötelező. Ez egy felhasználó által beállított tábla tulajdonság. Ez az egyedi név azonosítja a mellékletet, vagyis egyetlen két melléklet sem osztozik ugyanazon dokumentum azonos azonosítójával. Az azonosító nem haladhatja meg a 255 karaktert.
contentType Kötelező. Ez egy felhasználó által beállított tábla tulajdonság. Meghatározza a melléklet tartalomtípusát. Amikor törzsként küldi el a melléklet biteket, a Cosmos DB a contentType fejlécben beállított típusra állítja be a Content-Type értéket.
Media Kötelező. Ez az URL-hivatkozás vagy fájl elérési útja, ahol a melléklet található.
_rid Ez egy rendszer által létrehozott tulajdonság. Az erőforrás-azonosító (_rid) egy egyedi azonosító, amely az erőforrásmodell erőforrás-verménként is hierarchikus. Belsőleg használják a mellékleterőforrás elhelyezésére és navigációjára.
_ts Ez egy rendszer által létrehozott tulajdonság. Meghatározza az erőforrás utolsó frissített időbélyegét. Az érték egy időbélyeg.
_self Ez egy rendszer által létrehozott tulajdonság. Ez az erőforrás egyedi címezhető URI-ja.
_etag Ez egy rendszer által létrehozott tulajdonság, amely meghatározza az optimista egyidejűség-vezérléshez szükséges erőforrás-etaget.

Gyakori válaszfejlécek

Az alábbi információk a mellékletekkel kapcsolatos összes válaszra jellemzőek:

Fejléc Description
x-ms-max-media-storage-usage-mb Ha a Cosmos DB-melléklettárolót nyers adathordozó tárolására használja, ez a fejléc a fiókhoz kiosztott mellékletek teljes tárterületkvótát jeleníti meg.
x-ms-media-storage-usage-mb Ha a Cosmos DB melléklettárolót használja a nyers adathordozó tárolására, ez a fejléc a felhasznált aktuális melléklettárolót jeleníti meg.

Feladatok

Ezeket a feladatokat mellékletekkel végezheti el:

A melléklet tartalma nem indexelhető vagy kereshető; a melléklet erőforrás-tulajdonságai indexelhetők és kereshetők.

Ezek a műveletek hasonlóak a Dokumentumokhoz. Ahelyett, hogy a műveleteket a dokumentumokon hajtanák végre, azokat egy adott dokumentum melléklet-erőforrásútvonalán hajtják végre. Ezért kihagyjuk az egyes műveletek kidolgozását. Ehelyett a következő szakaszban azt tárgyaljuk, hogyan hozhat létre mellékletet nyers adathordozó-közzététellel és csak metaadat-közzététellel.

Lásd még: