Exportar (0) Imprimir
Expandir todo

Resumen de la funcionalidad del servicio Tabla

Actualizado: agosto de 2014

El Servicio Tabla API REST se ajustan a la Especificación de protocolo OData, con algunas diferencias, según se describe en las secciones siguientes.

Extensiones del servicio Tabla

Restricciones del servicio Tabla

El servicio Tabla amplía la funcionalidad de OData de las maneras siguientes.

El servicio Tabla requiere que cada solicitud esté autenticada. Se admiten las autenticaciones Shared Key y Shared Key Lite. La autenticación Shared Key es más segura y se recomienda para las solicitudes realizadas en el servicio Tabla mediante la API de REST.

Para obtener más información acerca de la autenticación de solicitudes, vea Autenticación para los servicios de almacenamiento de Azure.

Una consulta al servicio Tabla puede devolver un máximo de 1.000 elementos al mismo tiempo, y se puede ejecutar durante cinco segundos como máximo. Si el conjunto de resultados contiene más de 1.000 elementos o si la consulta no se completa en un plazo de cinco segundos, la respuesta incluirá encabezados que proporcionan al desarrollador los tokens de continuación que debe usar para reanudar la consulta en el siguiente elemento del conjunto de resultados. Pueden devolverse encabezados de los tokens de continuación para una operación Query Tables o una operación Query Entities.

Tenga presente que el tiempo total asignado a la solicitud para programar y procesar la consulta es de 30 segundos, incluidos los cinco segundos para la ejecución de la consulta.

Para obtener más información acerca de los tokens de continuación, vea Tiempo de espera y paginación de las consultas.

Todas las entidades del servicio Tabla tienen dos propiedades clave: la propiedad PartitionKey y RowKey. La combinación de estas propiedades forma la clave principal de la tabla y sirve para identificar de forma exclusiva cada entidad de la tabla.

Ambas propiedades requieren valores de cadena. Es responsabilidad del desarrollador proporcionar los valores de estas propiedades cuando se inserta una nueva entidad e incluirlas en cualquier operación de actualización o eliminación de una entidad.

Para obtener más información acerca de estas propiedades de clave obligatorias, vea Introducción al modelo de datos del servicio Tabla.

Todas las entidades del servicio Tabla tienen una propiedad del sistema Timestamp. La propiedad Timestamp es un valor DateTime que se conserva en el servidor para registrar el momento en que una entidad se modificó por última vez. El servicio Tabla usa la propiedad Timestamp internamente para proporcionar simultaneidad optimista. El valor de Timestamp es un valor que aumenta de forma continua, lo que significa que cada vez que se modifica la entidad, el valor de Timestamp aumenta para esa entidad. Esta propiedad no debe establecerse en operaciones de inserción o actualización (no se hará caso al valor).

Para obtener más información sobre la propiedad Timestamp, vea Introducción al modelo de datos del servicio Tabla.

El servicio Tabla admite transacciones por lotes con entidades que están en la misma tabla y pertenecen al mismo grupo de partición, lo que significa que tienen el mismo valor de PartitionKey. Esto permite realizar varias operaciones de inserción, actualización, combinación y eliminación en una única transacción atómica. El servicio Tabla admite un subconjunto de funcionalidad proporcionado por el Protocolo OData.

Para obtener más información acerca de las operaciones por lotes, vea Realizar transacciones con grupos de entidades.

El servicio Tabla tiene las restricciones sobre funcionalidad siguientes establecidas por OData.

El servicio Tabla no admite el uso de la propiedad Credentials de la clase DataServiceContext para autenticar una solicitud. En su lugar, para autenticar una solicitud en el servicio Tabla es preciso agregar un encabezado Authorization a la solicitud. Para obtener más información, vea Autenticación para los servicios de almacenamiento de Azure.

No todos los tipos de propiedades admitidos por OData son compatibles con el servicio Tabla. Para obtener una lista de los tipos de propiedades admitidos, vea Introducción al modelo de datos del servicio Tabla.

El servicio Tabla actualmente no admite vínculos entre tablas. Los vínculos son relaciones asociativas entre los datos.

La proyección se refiere a la consulta de un subconjunto de las propiedades de una entidad o entidades. Es análoga a la selección de un subconjunto de las columnas o propiedades de una tabla cuando se consulta en LINQ. La proyección reduce la cantidad de datos que debe devolver una consulta especificando que solo se devuelvan ciertas propiedades en la respuesta. La proyección se admite como parte de la versión del 18/08/2011 de los servicios de almacenamiento de Azure. Para obtener más información, consulte Query Entities, Escribir consultas LINQ con el servicio Tabla y OData: Seleccionar opciones de consulta de sistema ($select).

El servicio Tabla admite el uso de Language Integrated Query (LINQ). Solo se admiten estos operadores de consulta LINQ con el servicio Tabla:

  • From

  • Where

  • Take

Para obtener más información, vea Operadores de consulta admitidos para el servicio Tabla.

El servicio Tabla permite usar un subconjunto de los operadores de comparación proporcionados por LINQ. Para obtener más información, vea Consultar tablas y entidades y Escribir consultas LINQ con el servicio Tabla.

El servicio Tabla admite el método GetMetadataURI de la clase DataServiceContext, pero no devuelve ninguna información de esquema distinta de las tres propiedades fijas del esquema. Estas propiedades son PartitionKey, RowKey y Timestamp.

OData admite el envío de cargas en el formato JSON. El servicio Tabla de Azure admite el formato JSON de OData desde la versión del 15/08/2013 de la API, con la versión del servicio de datos de OData establecida en 3.0; las versiones anteriores no admiten el formato JSON. Para obtener más información, vea Formato de carga para las operaciones del servicio Tabla y Establecer los encabezados de versión del servicio de datos OData.

Vea también

Mostrar:
© 2015 Microsoft