Вложения

  • Статья

Azure Cosmos DB — это глобально распределенная база данных с несколькими моделями, которая поддерживает модели данных документов, графов, cassandra и табличных данных. Содержимое этого раздела предназначено для управления ресурсами вложений с помощью API SQL через REST.

Вложения — это особые документы, содержащие ссылки и связанные метаданные для внешнего большого двоичного объекта или файла мультимедиа.

Разработчики могут сделать следующий выбор:

  • Носитель вложений или большой двоичный объект, управляемый Azure Cosmos DB или
  • Сохраните его с помощью внешнего поставщика службы BLOB-объектов, например OneDrive, Dropbox и т. д. и сохраните эталонные метаданные для вложения в Azure Cosmos DB.

Ресурс вложения представлен вложениями в модели ресурсов REST Azure Cosmos DB. Ресурс вложения имеет фиксированную схему. Независимо от места хранения необработанных медиаданных требуются следующие свойства.

В следующем примере показана конструкция JSON для вложения документа.

{    
   "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"  
}
Свойство Описание
id Обязательный. Это настраиваемое пользователем свойство. Это уникальное имя, которое идентифицирует вложение, то есть два вложения не имеют одинаковых идентификаторов для одного документа. Длина идентификатора не должна превышать 255 символов.
contentType Обязательный. Это настраиваемое пользователем свойство. Указывает тип содержимого вложения. При отправке битов вложения в качестве текста Cosmos DB присваивает contentType типу, заданному в заголовке Content-Type .
Media Обязательный. Это URL-ссылка или путь к файлу, в котором находится вложение.
_rid Это свойство, созданное системой. Идентификатор ресурса (_rid) — это уникальный идентификатор, который также является иерархическим для стека ресурсов в модели ресурсов. Он используется системой для размещения и перемещения по ресурсам вложения.
_ts Это свойство, созданное системой. Оно представляет метку времени последнего обновления ресурса. Значение — метка времени.
_self Это свойство, созданное системой. Это уникальный адресуемый URI для ресурса.
_etag Это системное свойство, указывающее тег ресурса, необходимый для управления оптимистическим параллелизмом.

Общие заголовки ответов

Следующие сведения являются общими для всех ответов, связанных с вложениями:

Header Описание
x-ms-max-media-storage-usage-mb При использовании хранилища вложений Cosmos DB для хранения необработанных носителей этот заголовок показывает общую выделенную квоту хранилища вложений для учетной записи.
x-ms-media-storage-usage-mb При использовании хранилища вложений Cosmos DB для хранения необработанных носителей в этом заголовке отображается текущее используемое хранилище вложений.

Задания

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

Содержимое вложения не индексируется или не поддерживается для поиска; свойства ресурса вложения индексируются и доступны для поиска.

Эти операции аналогичны операциям для документов. Вместо выполнения операций с документами они выполняются по пути к ресурсам вложений в определенном документе. Таким образом, опустим рассмотрение каждой из операций. Вместо этого, в следующем разделе обсудим создание вложений с размещением необработанных медиаданных и только с размещением метаданных.

См. также: