dokumenty.
Azure Cosmos DB je globálně distribuovaná databáze s více modely, která podporuje modely dokumentů, grafů a datových modelů klíč-hodnota. Obsah v této části je určený pro vytváření, dotazování a správu prostředků dokumentů pomocí rozhraní SQL API přes REST.
Prostředek dokumentu je reprezentovaný docs
v modelu prostředků Azure Cosmos DB. Dokument se skládá z uživatelem definovaného obsahu ve formátu JSON. Kromě požadované vlastnosti ID můžou uživatelé pro obsah definovat libovolné prvky, struktury a hierarchie. Element ID je jedinečný řetězec, který je nastavitelný uživatelem a nesmí překročit 255 znaků. V kolekci můžete vkládat, nahrazovat, odstraňovat, číst, vyčíslovat a dotazovat libovolné dokumenty JSON.
Azure Cosmos DB nevyžaduje žádné schéma ani sekundární indexy, aby podporovala dotazování na dokumenty v kolekci. Ve výchozím nastavení jsou dokumenty automaticky a indexovány konzistentním způsobem, takže se dokument může dotazovat hned po vytvoření.
- Dokumenty se ukládají v rámci kolekcí. Další informace o kolekcích najdete v tématu Kolekce.
- Dokument může obsahovat jednu nebo více příloh. Další informace o přílohách najdete v tématu Přílohy.
- Přístup uživatelů k dokumentům je možné spravovat prostřednictvím oprávnění. Další informace o oprávněních najdete v tématu Oprávnění.
Tento ukázkový dokument JSON ukazuje položku sopky v kolekci. Položka obsahuje název sopky, informace o poloze včetně geoprostorových dat a prvky definované systémem, jako jsou _rid, _ts, _self, _etag a _attachments.
{
"Volcano Name": "Agua de Pau",
"Country": "Portugal",
"Region": "Azores",
"Location": {
"type": "Point",
"coordinates": [
-25.47,
37.77
]
},
"Elevation": 947,
"Type": "Stratovolcano",
"Status": "Historical",
"Last Known Eruption": "Last known eruption from 1500-1699, inclusive",
"id": "d44c94b6-81f8-4b27-4970-f79b149529d3",
"_rid": "Sl8fALN4sw4BAAAAAAAAAA==",
"_ts": 1448049512,
"_self": "dbs/Sl8fAA==/colls/Sl8fALN4sw4=/docs/Sl8fALN4sw4BAAAAAAAAAA==/",
"_etag": "\"0000443f-0000-0000-0000-564f7b680000\"",
"_attachments": "attachments/"
}
Vlastnost | Popis |
---|---|
id | Povinná hodnota. Jedná se o uživatelsky nastavitelnou vlastnost. Jedná se o jedinečný název, který identifikuje dokument, to znamená, že žádné dva dokumenty nesdílely stejné ID v rámci logického oddílu. Oddíl a ID jednoznačně identifikuje položku v databázi. Pole ID nesmí být delší než 255 znaků. |
_Zbavit | 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ě pro umístění a navigaci v tomto prostředku dokumentu. |
_Ts | Jedná se o systémem vygenerovanou vlastnost. Určuje časové razítko poslední aktualizace prostředku. Hodnota je časové razítko. |
_Vlastní | 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. |
_Přílohy | Jedná se o systémem vygenerovanou vlastnost, která určuje adresovatelnou cestu pro prostředek příloh. |
Úlohy
S dokumenty můžete provádět následující úlohy: