Documents
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 et de clé-valeur. Le contenu de cette section est destiné à créer, interroger et gérer des ressources de document à l’aide de l’API SQL via REST.
La ressource de document est représentée par docs dans le modèle de ressource Azure Cosmos DB. Un document se compose d'un contenu défini par l'utilisateur au format JSON. Outre la propriété ID requise, les utilisateurs peuvent définir des éléments arbitraires, des structures et des hiérarchies pour le contenu. L’élément ID est une chaîne unique qui peut être définie par l’utilisateur et ne doit pas dépasser 255 caractères. Vous pouvez insérer, remplacer, supprimer, lire, énumérer et interroger arbitrairement des documents JSON dans une collection.
Azure Cosmos DB ne nécessite aucun schéma ou index secondaire pour prendre en charge l’interrogation des documents d’une collection. Par défaut, les documents sont automatiquement et indexés de manière cohérente, ce qui rend un document interrogeable dès sa création.
- Les documents sont stockés dans des collections. Pour plus d’informations sur les collections, consultez Collections.
- Un document peut contenir une ou plusieurs pièces jointes. Pour plus d’informations sur les pièces jointes, consultez Pièces jointes.
- L’accès utilisateur aux documents peut être géré via des autorisations. Pour plus d’informations sur les autorisations, consultez Autorisations.
Cet exemple de document JSON montre l’entrée d’un volcan dans une collection. L’entrée inclut le nom du volcan, les informations d’emplacement, y compris les données géospatiales, et des éléments définis par le système tels que _rid, _ts, _self, _etag et _attachments.
{
"Volcano Name": "Agua de Pau",
"Country": "Portugal",
"Region": "Azores",
"Location": {
"type": "Point",
"coordinates": [
-25.47,
37.77
]
},
"Elevation": 947,
"Type": "Stratovolcano",
"Status": "Historical",
"Last Known Eruption": "Last known eruption from 1500-1699, inclusive",
"id": "d44c94b6-81f8-4b27-4970-f79b149529d3",
"_rid": "Sl8fALN4sw4BAAAAAAAAAA==",
"_ts": 1448049512,
"_self": "dbs/Sl8fAA==/colls/Sl8fALN4sw4=/docs/Sl8fALN4sw4BAAAAAAAAAA==/",
"_etag": "\"0000443f-0000-0000-0000-564f7b680000\"",
"_attachments": "attachments/"
}
| Propriété | Description |
|---|---|
| id | Obligatoire. Il s’agit d’une propriété settable par l’utilisateur. Il s’agit du nom unique qui identifie le document, c’est-à-dire qu’aucun document ne partage le même ID au sein d’une partition logique. La partition et l’ID identifient de manière unique un élément dans la base de données. Le champ id ne doit pas dépasser 255 caractères. |
| _Débarrasser | 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 de la ressource de document. |
| _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. |
| _Pièces jointes | Il s’agit d’une propriété générée par le système qui spécifie le chemin d’accès adressable pour la ressource pièces jointes. |
Tâches
Vous pouvez effectuer les tâches suivantes avec des documents :