Документы
Azure Cosmos DB — это глобально распределенная база данных с несколькими моделями, которая поддерживает модели данных документов, графов и ключей и значений. Содержимое этого раздела предназначено для создания , запроса и управления ресурсами документов с помощью API SQL через REST.
Ресурс документа представлен docs
в модели ресурсов Azure Cosmos DB. Документ состоит из определяемого пользователем содержимого в формате JSON. Помимо обязательного свойства идентификатора, пользователи могут определять любые произвольные элементы, структуры и иерархии для содержимого. Элемент ID — это уникальная строка, которая настраивается пользователем и не должна превышать 255 символов. Вы можете вставлять, заменять, удалять, читать, перечислять и запрашивать произвольные документы JSON в коллекции.
Azure Cosmos DB не требует никаких схем или вторичных индексов для поддержки запросов к документам в коллекции. По умолчанию документы автоматически индексируются и индексируются согласованно, что делает документ запрашиваемым сразу после его создания.
- Документы хранятся в коллекциях. Дополнительные сведения о коллекциях см. в разделе Коллекции.
- Документ может содержать одно или несколько вложений. Дополнительные сведения о вложениях см. в разделе Вложения.
- Доступом пользователей к документам можно управлять с помощью разрешений. Дополнительные сведения о разрешениях см. в разделе Разрешения.
В этом примере документа JSON показана запись для вулкана в коллекции. Запись содержит имя вулкана, сведения о местоположении, включая геопространственные данные, а также системные элементы, такие как _rid, _ts, _self, _etag и _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/"
}
Свойство | Описание |
---|---|
идентификатор | Обязательный. Это настраиваемое пользователем свойство. Это уникальное имя, которое идентифицирует документ, то есть два документа не имеют одинаковых идентификаторов в логической секции. Секция и идентификатор уникальным образом идентифицируют элемент в базе данных. Длина поля идентификатора не должна превышать 255 символов. |
_rid | Это свойство, созданное системой. Идентификатор ресурса (_rid) — это уникальный идентификатор, который также является иерархическим для стека ресурсов в модели ресурсов. Он используется внутренне для размещения ресурса документа и перемещения по нему. |
_Ts | Это свойство, созданное системой. Оно представляет метку времени последнего обновления ресурса. Значение — метка времени. |
_Самостоятельно | Это свойство, созданное системой. Это уникальный адресуемый URI для ресурса. |
_etag | Это системное свойство, указывающее тег ресурса, необходимый для управления оптимистическим параллелизмом. |
_Вложения | Это созданное системой свойство, указывающее адресный путь для ресурса вложений. |
Задания
С документами можно выполнять следующие задачи: