Compartir a través de

Documentos

  • Artículo

Azure Cosmos DB es una base de datos multimodelo distribuida globalmente que admite los modelos de datos de documento, gráfico y clave-valor. El contenido de esta sección es para crear, consultar y administrar recursos de documentos mediante la API de SQL a través de REST.

El recurso de documento se representa mediante docs en el modelo de recursos de Azure Cosmos DB. Un documento consta de contenido definido por el usuario en formato JSON. Aparte de la propiedad id. necesaria, los usuarios pueden definir cualquier elemento, estructuras y jerarquías arbitrarios para el contenido. El elemento ID es una cadena única que es configurable por el usuario y no debe superar los 255 caracteres. Puede insertar, reemplazar, eliminar, leer, enumerar y consultar documentos JSON arbitrarios de una colección.

Azure Cosmos DB no requiere ningún esquema ni índices secundarios para admitir consultas sobre documentos de una colección. De forma predeterminada, los documentos se indexan automáticamente y se indexan de forma coherente, lo que hace que un documento sea consultable en cuanto se cree.

  • Los documentos se almacenan dentro de colecciones. Para obtener más información sobre las colecciones, consulte Colecciones.
  • Un documento puede contener uno o varios datos adjuntos. Para obtener más información sobre los datos adjuntos, consulte Datos adjuntos.
  • El acceso de usuario a los documentos se puede administrar mediante permisos. Para obtener más información sobre los permisos, consulte Permisos.

En este documento JSON de ejemplo se muestra la entrada de un volcán en una colección. La entrada incluye el nombre del volcán, la información de ubicación, incluidos los datos geoespaciales y los elementos definidos por el sistema, como _rid, _ts, _self, _etag y _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/"  
}
Propiedad Descripción
id Necesario. Es una propiedad que se puede establecer por el usuario. Es el nombre único que identifica el documento, es decir, no hay dos documentos que compartan el mismo identificador dentro de una partición lógica. La partición y el identificador identifican de forma única un elemento de la base de datos. El campo id no debe superar los 255 caracteres.
_Librar Es una propiedad generada por el sistema. El identificador de recurso (_rid) es un identificador único que también es jerárquico por la pila de recursos en el modelo de recursos. Se usa de forma interna para la ubicación y la navegación del recurso de documento.
_Ts Es una propiedad generada por el sistema. Especifica la última marca de tiempo actualizada del recurso. El valor es una marca de tiempo.
_propio Es una propiedad generada por el sistema. Es el URI direccionable único para el recurso.
_Etag Es una propiedad generada por el sistema que especifica la etag de recursos necesaria para el control de simultaneidad optimista.
_Accesorios Es una propiedad generada por el sistema que especifica la ruta de acceso direccionable para el recurso de datos adjuntos.

Tareas

Puede realizar las siguientes tareas con documentos:

Consulte también