Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Resumen de las funciones de servicio de tabla

 

El servicio de tabla es compatible con la API de REST de la especificación de Protocolo OData, con algunas diferencias, como 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 las solicitudes de autenticación, consulte 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 token de continuación para un Query Tables operación o un Query Entities operación.

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 en el servicio tabla tienen dos propiedades clave: la PartitionKey propiedad y RowKey propiedad. 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, consulte Introducción al modelo de datos del servicio Tabla.

Todas las entidades en el servicio tabla tienen un Timestamp propiedad del sistema. La propiedad SIDHistory hace esto posible. El servicio tabla usa el Timestamp propiedad internamente para proporcionar simultaneidad optimista. El valor de Timestamp es un valor de progresión, 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 acerca de la Timestamp propiedad, vea Introducción al modelo de datos del servicio Tabla.

El servicio tabla admite transacciones por lotes en las entidades que están en la misma tabla y pertenecen al mismo grupo de partición, lo que significa que tienen el mismo PartitionKey valor. 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 la funcionalidad proporcionada por el Protocolo OData.

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

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

El servicio de la tabla no admite el uso del credenciales propiedad de la DataServiceContext clase para autenticar una solicitud. En su lugar, debe autenticar una solicitud en el servicio de la tabla agregando un Authorization encabezado para 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 tipos de propiedad 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 opción 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, consulte Consultar tablas y entidades y Escribir consultas LINQ con el servicio Tabla.

El servicio tabla admite el GetMetadataURI método de la DataServiceContext clase, pero no devuelve ninguna información de esquema más allá de las tres propiedades de esquema fijo. 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, consulte Formato de carga para las operaciones del servicio Tabla y Establecer los encabezados de versión del servicio de datos OData.

Mostrar: