Mellékletek
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.