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.