Документы

  • Статья

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 Это системное свойство, указывающее тег ресурса, необходимый для управления оптимистическим параллелизмом.
_Вложения Это созданное системой свойство, указывающее адресный путь для ресурса вложений.

Задания

С документами можно выполнять следующие задачи:

См. также: