Pièces jointes
Azure Cosmos DB est une base de données multimodèle distribuée à l’échelle mondiale qui prend en charge les modèles de données de document, de graphique, de cassandra et de table. Le contenu de cette section est destiné à la gestion des ressources de pièces jointes à l’aide de l’API SQL via REST.
Les pièces jointes sont des documents spéciaux contenant des références et des métadonnées associées avec un objet blob ou un fichier multimédia externe.
Les développeurs peuvent choisir d'avoir :
- Média/objet blob de pièce jointe géré par Azure Cosmos DB ou
- Stockez-le auprès d’un fournisseur de services d’objets blob externes tels que OneDrive, Dropbox, etc. et stockent les métadonnées de référence pour la pièce jointe dans Azure Cosmos DB.
La ressource de pièce jointe est représentée par des pièces jointes dans le modèle de ressource REST Azure Cosmos DB. La ressource de pièce jointe a un schéma fixe. Quel que soit l'emplacement où le média brut est stocké, les propriétés suivantes sont requises.
L'exemple suivant illustre la construction JSON d'une pièce jointe de document :
{
"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"
}
| Propriété | Description |
|---|---|
id |
Obligatoire. Il s’agit d’une propriété settable par l’utilisateur. Il s’agit du nom unique qui identifie la pièce jointe, autrement dit, que deux pièces jointes ne partagent pas le même ID pour le même document. L’ID ne doit pas dépasser 255 caractères. |
contentType |
Obligatoire. Il s’agit d’une propriété settable par l’utilisateur. Elle indique le type de contenu de la pièce jointe. Lors de l’envoi des bits de pièce jointe en tant que corps, Cosmos DB définit le contentType sur le type défini dans l’en-tête Content-Type . |
Media |
Obligatoire. Il s’agit du lien d’URL ou du chemin d’accès au fichier où réside la pièce jointe. |
_rid |
Il s’agit d’une propriété générée par le système. L’ID de ressource (_rid) est un identificateur unique qui est également hiérarchique en fonction de la pile de ressources sur le modèle de ressource. Il est utilisé en interne pour le positionnement et la navigation dans la ressource de pièce jointe. |
_ts |
Il s’agit d’une propriété générée par le système. Elle spécifie l'horodateur de la dernière mise à jour de la ressource. La valeur est un horodateur. |
_self |
Il s’agit d’une propriété générée par le système. Il s'agit de l'URI adressable unique pour la ressource. |
_etag |
Il s’agit d’une propriété générée par le système qui spécifie l’etag de ressource requis pour le contrôle d’accès concurrentiel optimiste. |
En-têtes de réponse courants
Les informations suivantes sont communes à toutes les réponses liées aux pièces jointes :
| En-tête | Description |
|---|---|
x-ms-max-media-storage-usage-mb |
Lorsque vous utilisez le stockage de pièces jointes Cosmos DB pour stocker le média brut, cet en-tête affiche le quota total alloué de stockage des pièces jointes pour le compte. |
x-ms-media-storage-usage-mb |
Lorsque vous utilisez le stockage de pièces jointes Cosmos DB pour stocker le média brut, cet en-tête affiche le stockage de pièces jointes actuel consommé. |
Tâches
Vous pouvez effectuer ces tâches avec des pièces jointes :
Le contenu de la pièce jointe n’est pas indexé ou ne peut pas faire l’objet d’une recherche ; les propriétés de la ressource de pièce jointe sont indexées et peuvent faire l’objet d’une recherche.
Ces opérations sont similaires à celles de Documents. Au lieu d’effectuer les opérations sur les documents, elles sont effectuées sur le chemin de ressource pièces jointes sous un document particulier. Par conséquent, nous ne décrivons pas ici l'élaboration de ces opérations. En revanche, dans la section suivante, nous abordons la création d'une pièce jointe avec publication de média brut et publication de métadonnées uniquement.