Bilagor
Azure Cosmos DB är en globalt distribuerad databas med flera modeller som stöder datamodellerna dokument, grafer, cassandra och tabeller. Innehållet i det här avsnittet är till för att hantera bifogade resurser med hjälp av SQL API via REST.
Bifogade filer är särskilda dokument som innehåller referenser och associerade metadata med en extern blob eller mediefil.
Utvecklare kan välja att ha:
- Mediet/bloben för bifogade filer som hanteras av Azure Cosmos DB eller
- Lagra den med en extern blobtjänstleverantör som OneDrive, Dropbox osv. och lagra referensmetadata för bifogade filer i Azure Cosmos DB.
Den bifogade resursen representeras av bifogade filer i Azure Cosmos DB REST-resursmodellen. Den bifogade resursen har ett fast schema. Oavsett var det råa mediet lagras krävs följande egenskaper.
I följande exempel visas JSON-konstruktionen för en dokumentbilaga.
{
"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"
}
| Egenskap | Beskrivning |
|---|---|
id |
Krävs. Det är en användaruppsättningsbar egenskap. Det är det unika namnet som identifierar den bifogade filen, dvs. inga två bifogade filer delar samma ID för samma dokument. ID:t får inte överstiga 255 tecken. |
contentType |
Krävs. Det är en användaruppsättningsbar egenskap. Den anger innehållstypen för den bifogade filen. När du skickar de bifogade filerna som brödtext anger contentType Cosmos DB den typ som angetts i Content-Type rubriken. |
Media |
Krävs. Det är URL-länken eller filsökvägen där den bifogade filen finns. |
_rid |
Det är en systemgenererad egenskap. Resurs-ID :t (_rid) är en unik identifierare som också är hierarkisk per resursstacken i resursmodellen. Den används internt för placering och navigering av den bifogade resursen. |
_ts |
Det är en systemgenererad egenskap. Den anger resursens senast uppdaterade tidsstämpel. Värdet är en tidsstämpel. |
_self |
Det är en systemgenererad egenskap. Det är den unika adresserbara URI:n för resursen. |
_etag |
Det är en systemgenererad egenskap som anger resursetaggen som krävs för optimistisk samtidighetskontroll. |
Vanliga svarshuvuden
Följande information är gemensam för alla svar som rör bifogade filer:
| Huvud | Description |
|---|---|
x-ms-max-media-storage-usage-mb |
När du använder Cosmos DB-lagring av bifogade filer för att lagra råmedia visar det här huvudet den totala tilldelade lagringskvoten för bifogade filer för kontot. |
x-ms-media-storage-usage-mb |
När du använder Cosmos DB-lagring av bifogade filer för att lagra råmedia visar det här huvudet det aktuella lagringsutrymmet för bifogade filer som används. |
Aktiviteter
Du kan utföra dessa uppgifter med bifogade filer:
Innehållet i den bifogade filen är inte indexerat eller sökbart. egenskaperna för den bifogade filen är indexerade och sökbara.
De här åtgärderna liknar dem för Dokument. I stället för att utföra åtgärderna mot dokumenten utförs de mot resurssökvägen för bifogade filer under ett visst dokument. Därför hoppar vi över att utveckla var och en av åtgärderna. I nästa avsnitt diskuterar vi i stället hur du skapar en bifogad fil med inlägg i råa medier och med endast metadatapublicering.