Condividi tramite

Allegati

  • Articolo

Azure Cosmos DB è un database multimodello distribuito a livello globale che supporta i modelli di dati del documento, del grafo, della cassandra e della tabella. Il contenuto di questa sezione consiste nella gestione delle risorse degli allegati tramite l'API SQL tramite REST.

Gli allegati sono documenti speciali contenenti riferimenti e metadati associati a file multimediali o BLOB esterni.

Gli sviluppatori possono decidere di:

  • Supporto di allegato/BLOB gestito da Azure Cosmos DB o
  • Archiviarlo con un provider di servizi BLOB esterno, ad esempio OneDrive, Dropbox e così via. e archiviare i metadati di riferimento per l'allegato in Azure Cosmos DB.

La risorsa allegato è rappresentata dagli allegati nel modello di risorse REST di Azure Cosmos DB. La risorsa allegato ha uno schema fisso. Indipendentemente dal percorso di archiviazione del file multimediale non elaborato, sono necessarie le seguenti proprietà.

Il seguente esempio mostra il costrutto JSON di un allegato di 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"  
}
Proprietà Descrizione
id Obbligatorio. È una proprietà impostabile dall'utente. È il nome univoco che identifica l'allegato, ovvero non due allegati condividono lo stesso ID per lo stesso documento. L'ID non deve superare i 255 caratteri.
contentType Obbligatorio. È una proprietà impostabile dall'utente. Specifica il tipo di contenuto dell'allegato. Quando si inviano i bit di allegato come corpo, Cosmos DB imposta l'oggetto contentType sul tipo impostato nell'intestazione Content-Type .
Media Obbligatorio. È il collegamento URL o il percorso del file in cui risiede l'allegato.
_rid Si tratta di una proprietà generata dal sistema. L'ID risorsa (_rid) è un identificatore univoco che è anche gerarchico per ogni stack di risorse nel modello di risorsa. Viene usato internamente per il posizionamento e l'esplorazione della risorsa allegato.
_ts Si tratta di una proprietà generata dal sistema. Indica il timestamp dell'ultimo aggiornamento della risorsa. Il valore è un timestamp.
_self Si tratta di una proprietà generata dal sistema. URI indirizzabile univoco per la risorsa.
_etag Si tratta di una proprietà generata dal sistema che specifica l'etag della risorsa necessaria per il controllo di concorrenza ottimistica.

Intestazioni di risposta comuni

Le informazioni seguenti sono comuni a tutte le risposte correlate agli allegati:

Intestazione Descrizione
x-ms-max-media-storage-usage-mb Quando si usa l'archiviazione allegati di Cosmos DB per archiviare supporti non elaborati, questa intestazione mostra la quota totale di archiviazione degli allegati allocato per l'account.
x-ms-media-storage-usage-mb Quando si usa l'archiviazione allegati di Cosmos DB per archiviare supporti non elaborati, questa intestazione mostra l'archiviazione dell'allegato corrente utilizzata.

Attività

È possibile eseguire queste attività con allegati:

Il contenuto dell'allegato non è indicizzato o ricercabile; le proprietà delle risorse allegati sono indicizzate e ricercabili.

Queste operazioni sono simili a quelle per Documenti. Anziché eseguire le operazioni sulla documentazione, vengono eseguite sul percorso della risorsa allegati in un documento specifico. Non verrà quindi illustrata l'elaborazione di tutte le operazioni. La sezione successiva illustra invece come creare un allegato con inserimento di file multimediali non elaborati e con inserimento di soli metadati.

Vedere anche