Partilhar via


Anexos

O Azure Cosmos DB é uma base de dados com vários modelos distribuída globalmente que suporta os modelos de dados de documentos, gráficos, cassandra e tabelas. O conteúdo nesta secção destina-se à gestão de recursos de anexos através da API SQL através do REST.

Os anexos são documentos especiais que contêm referências e metadados associados a um blob externo ou ficheiro de multimédia.

Os programadores podem optar por ter:

  • O suporte de dados/blob de anexos gerido pelo Azure Cosmos DB ou
  • Armazene-o com um fornecedor de serviços de blobs externo, como o OneDrive, Dropbox, etc. e armazene os metadados de referência para anexos no Azure Cosmos DB.

O recurso de anexo é representado por anexos no modelo de recursos REST do Azure Cosmos DB. O recurso de anexo tem um esquema fixo. Independentemente do local onde o suporte de dados não processado é armazenado, são necessárias as seguintes propriedades.

O exemplo seguinte ilustra a construção JSON de um anexo de documento.

{    
   "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"  
}  
  
Propriedade Description
id Obrigatório. É uma propriedade de definição de utilizador. É o nome exclusivo que identifica o anexo, ou seja, não existem dois anexos que partilhem o mesmo ID para o mesmo documento. O ID não pode exceder os 255 carateres.
contentType Obrigatório. É uma propriedade de definição de utilizador. Especifica o tipo de conteúdo do anexo. Ao submeter os bits de anexo como o corpo, o Cosmos DB define o contentType para o tipo definido no Content-Type cabeçalho.
Media Obrigatório. É a ligação de URL ou o caminho do ficheiro onde reside o anexo.
_rid É uma propriedade gerada pelo sistema. O ID do recurso (_rid) é um identificador exclusivo que também é hierárquico de acordo com a pilha de recursos no modelo de recursos. É utilizado internamente para colocação e navegação do recurso de anexo.
_ts É uma propriedade gerada pelo sistema. Especifica o último carimbo de data/hora atualizado do recurso. O valor é um carimbo de data/hora.
_self É uma propriedade gerada pelo sistema. É o URI endereçável exclusivo para o recurso.
_etag É uma propriedade gerada pelo sistema que especifica o etag de recursos necessário para o controlo de simultaneidade otimista.

Cabeçalhos de resposta comuns

As seguintes informações são comuns a todas as respostas relacionadas com anexos:

Cabeçalho Description
x-ms-max-media-storage-usage-mb Ao utilizar o armazenamento de anexos do Cosmos DB para armazenar suportes de dados não processados, este cabeçalho mostra a quota total de armazenamento de anexos atribuída para a conta.
x-ms-media-storage-usage-mb Ao utilizar o armazenamento de anexos do Cosmos DB para armazenar suportes de dados não processados, este cabeçalho mostra o armazenamento de anexos atual consumido.

Tarefas

Pode realizar estas tarefas com anexos:

O conteúdo do anexo não está indexado ou pesquisável; as propriedades do recurso de anexo são indexadas e pesquisáveis.

Estas operações são semelhantes às dos Documentos. Em vez de efetuarem as operações nos documentos, são executadas no caminho do recurso de anexos num documento específico. Assim, vamos ignorar a elaboração de cada uma das operações. Em vez disso, na próxima secção, vamos discutir como criar um anexo com publicação de multimédia não processada e com publicação apenas de metadados.

Consulte também