Anexos

  • Artigo

O Azure Cosmos DB é um banco de dados multimodelo distribuído globalmente que dá suporte aos modelos de dados de documento, grafo, cassandra e tabela. O conteúdo nesta seção destina-se ao gerenciamento de recursos de anexo usando a API do SQL por meio do REST.

Os anexos são documentos especiais que contêm referências e metadados associados com um blob externo ou arquivo de mídia.

Os desenvolvedores podem optar por ter:

  • A mídia/blob de anexos gerenciado pelo Azure Cosmos DB ou
  • Armazene-o com um provedor de serviços de blob externo, como OneDrive, Dropbox etc. e armazenam os metadados de referência para anexo no Azure Cosmos DB.

O recurso de anexo é representado por anexos no modelo de recurso REST do Azure Cosmos DB. O recurso do anexo tem um esquema fixo. Independentemente de onde a mídia está armazenada, as seguintes propriedades são necessárias.

O exemplo a seguir 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 Descrição
id Obrigatórios. É uma propriedade configurável pelo usuário. É o nome exclusivo que identifica o anexo, ou seja, nenhum anexo compartilha a mesma ID para o mesmo documento. A ID não deve exceder 255 caracteres.
contentType Obrigatórios. É uma propriedade configurável pelo usuário. Especifica o tipo de conteúdo do anexo. Ao enviar os bits de anexo como o corpo, o Cosmos DB define o contentType como o tipo definido no Content-Type cabeçalho.
Media Obrigatórios. É o link de URL ou o caminho do arquivo em que o anexo reside.
_rid É uma propriedade gerada pelo sistema. A ID do recurso (_rid) é um identificador exclusivo que também é hierárquico de acordo com a pilha de recursos no modelo de recurso. É usado internamente para colocação e navegação do recurso 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 do recurso.
_etag É uma propriedade gerada pelo sistema que especifica a etag de recurso necessária para o controle de simultaneidade otimista.

Cabeçalhos de resposta comuns

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

parâmetro Descrição
x-ms-max-media-storage-usage-mb Ao usar o armazenamento de anexos do Cosmos DB para armazenar mídia bruta, esse cabeçalho mostra a cota total de armazenamento de anexos alocado para a conta.
x-ms-media-storage-usage-mb Ao usar o armazenamento de anexos do Cosmos DB para armazenar mídia bruta, esse cabeçalho mostra o armazenamento de anexos atual consumido.

Tarefas

Você pode realizar essas tarefas com anexos:

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

Essas operações são semelhantes às de Documentos. Em vez de executar as operações nos documentos, elas são executadas no caminho do recurso anexos em um documento específico. Portanto, vamos pular a elaboração de cada uma das operações. Em vez disso, na próxima seção, vamos discutir como criar um anexo com o lançamento de mídia e com lançamento somente de metadados.

Consulte Também