Compartir a través de


Datos adjuntos

Azure Cosmos DB es una base de datos multimodelo distribuida globalmente que admite los modelos de datos de documentos, grafos, cassandra y tablas. El contenido de esta sección es para administrar recursos adjuntos mediante la API de SQL a través de REST.

Los datos adjuntos son documentos especiales que contienen las referencias y los metadatos asociados con un archivo multimedia o blob externo.

Los desarrolladores pueden elegir:

  • Medios o blobs adjuntos administrados por Azure Cosmos DB o
  • Almacénelo con un proveedor de servicios de blobs externo, como OneDrive, Dropbox, etc. y almacenan los metadatos de referencia para los datos adjuntos en Azure Cosmos DB.

El recurso de datos adjuntos se representa mediante datos adjuntos en el modelo de recursos REST de Azure Cosmos DB. El recurso de datos adjuntos tiene un esquema fijo. Independientemente de dónde se almacenen los medios sin procesar, se requieren las siguientes propiedades.

En el ejemplo siguiente se muestra la construcción JSON de los datos adjuntos 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"  
}  
  
Propiedad Descripción
id Necesario. Es una propiedad que se puede establecer por el usuario. Es el nombre único que identifica los datos adjuntos, es decir, no dos datos adjuntos comparten el mismo identificador para el mismo documento. El identificador no debe superar los 255 caracteres.
contentType Necesario. Es una propiedad que se puede establecer por el usuario. Especifica el tipo de contenido de los datos adjuntos. Al enviar los bits de datos adjuntos como cuerpo, Cosmos DB establece en contentType el tipo establecido en el Content-Type encabezado .
Media Necesario. Es el vínculo de dirección URL o la ruta de acceso del archivo donde residen los datos adjuntos.
_rid 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 internamente para la colocación y el desplazamiento del recurso de datos adjuntos.
_ts Es una propiedad generada por el sistema. Especifica la última marca de tiempo actualizada del recurso. El valor es una marca de tiempo.
_self Es una propiedad generada por el sistema. Es el URI direccionable único para el recurso.
_etag Se trata de una propiedad generada por el sistema que especifica la etag de recursos necesaria para el control de simultaneidad optimista.

Encabezados de respuesta comunes

La siguiente información es común a todas las respuestas relacionadas con los datos adjuntos:

Encabezado Descripción
x-ms-max-media-storage-usage-mb Cuando se usa el almacenamiento de datos adjuntos de Cosmos DB para almacenar medios sin procesar, este encabezado muestra la cuota total de almacenamiento de datos adjuntos asignados para la cuenta.
x-ms-media-storage-usage-mb Al usar el almacenamiento de datos adjuntos de Cosmos DB para almacenar medios sin procesar, este encabezado muestra el almacenamiento de datos adjuntos actual consumido.

Tareas

Puede realizar estas tareas con datos adjuntos:

El contenido adjunto no se indexa ni se puede buscar; las propiedades del recurso de datos adjuntos se indexan y se pueden buscar.

Estas operaciones son similares a las de documentos. En lugar de realizar las operaciones en los documentos, se realizan en la ruta de acceso del recurso de datos adjuntos en un documento determinado. Por lo tanto, no explicaremos con detalle cada una de las operaciones. En su lugar, en la sección siguiente, analizaremos cómo crear datos adjuntos con el registro de medios sin procesar y con el registro de solo metadatos.

Consulte también