Resumen de la funcionalidad de Table Storage

La API REST de Azure Table Storage es compatible con la especificación del protocolo OData, con algunas diferencias, como se describe en las secciones siguientes.

Extensiones de Table Storage

Table Storage amplía la funcionalidad de OData de las siguientes maneras.

Clave compartida, Clave compartida Lite y autorización de Azure Active Directory

Table Storage requiere que cada solicitud esté autorizada. Se admite la clave compartida, la clave compartida Lite y la autorización de Microsoft Entra ID. Microsoft Entra ID autorización es más segura y se recomienda para las solicitudes realizadas en Table Storage mediante la API REST.

Para más información sobre la autorización de solicitudes, consulte Autorización de solicitudes a Azure Storage.

Tokens de continuación para la paginación de consultas

Una consulta en Table Storage puede devolver un máximo de 1000 elementos a la vez y puede ejecutarse durante un máximo de cinco segundos. Si el conjunto de resultados contiene más de 1000 elementos, o si la consulta no finalizó en cinco segundos, la respuesta incluye encabezados. Estos encabezados proporcionan al desarrollador tokens de continuación que se van a usar para reanudar la consulta en el siguiente elemento del conjunto de resultados. Los encabezados de token de continuación se pueden devolver para una operación Tablas de consulta o una operación de entidades de consulta .

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 sobre los tokens de continuación, consulte Tiempo de espera de consulta y paginación.

Propiedades del sistema de clave principal

Cada entidad de Table Storage tiene dos propiedades clave: la PartitionKey propiedad y la RowKey propiedad . Estas propiedades forman la clave principal de la tabla e identifican de forma única cada entidad de la tabla.

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

Para obtener más información sobre estas propiedades clave necesarias, consulte Descripción del modelo de datos de Table Storage.

Propiedad del sistema Timestamp

Cada entidad de Table Storage tiene una Timestamp propiedad del sistema. La Timestamp propiedad es un DateTime valor, mantenido en el lado servidor, para registrar la hora en que se modificó por última vez una entidad. Table Storage usa la Timestamp propiedad 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 Timestamp propiedad , vea Descripción del modelo de datos de Table Storage.

Operaciones por lotes

Table Storage admite transacciones por lotes en entidades que están en la misma tabla y pertenecen al mismo grupo de particiones, 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. Table Storage admite un subconjunto de la funcionalidad proporcionada por el protocolo OData.

Para obtener más información sobre las operaciones por lotes, consulte Realización de transacciones de grupo de entidades.

Restricciones de Table Storage

Table Storage tiene las siguientes restricciones sobre la funcionalidad proporcionada por OData.

propiedad Credentials

Table Storage no admite el uso de la propiedad Credentials de la clase DataServiceContext para autorizar una solicitud. En su lugar, debe autorizar una solicitud en Table Storage agregando un Authorization encabezado a la solicitud. Para obtener más información, vea Autorización de solicitudes a Azure Storage.

Tipos de propiedad

No se admiten todos los tipos de propiedad admitidos por OData . Para obtener una lista de los tipos de propiedades admitidos, consulte Descripción del modelo de datos de Table Storage.

Operaciones en vínculos

Table Storage no admite actualmente vínculos entre tablas. Los vínculos son relaciones asociativas entre los datos.

Operaciones en propiedades de selección

Proyección hace referencia a consultar un subconjunto de las propiedades de una entidad o entidades. Es análogo seleccionar un subconjunto de las columnas o propiedades de una tabla cuando se consultan en consultas integradas en lenguaje (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 2011-08-18 de Azure Storage. Para obtener más información, vea Entidades de consulta, Escritura de consultas LINQ en Table Storage y OData: Seleccionar opción de consulta del sistema ($select).

Operadores de consulta LINQ

Table Storage admite los siguientes operadores de consulta LINQ:

• From

• Where

• Take

Para más información, consulte Operadores de consulta compatibles con Table Storage.

Operadores de comparación linq

Puede usar un subconjunto de los operadores de comparación proporcionados por LINQ. Para más información, consulte Consulta de tablas y entidades yEscritura de consultas LINQ en Table Storage.

Método GetMetadataURI

Puede usar el método GetMetadataURI de la clase DataServiceContext , pero no devuelve información de esquema más allá de las tres propiedades fijas de esquema. Dichas propiedades son PartitionKey, RowKey y Timestamp.

Formatos de carga

OData admite el envío de cargas en formato JSON. Table Storage admite el OData formato JSON a partir de la versión de API 2013-08-15, con la versión del OData servicio de datos establecida en 3.0. Las versiones anteriores no admiten el formato JSON.

Las cargas de Atom se admiten en todas las versiones anteriores a 2015-12-11. La versión 2015-12-11 y versiones posteriores solo admiten cargas JSON.

Para obtener más información, consulte Formato de carga para las operaciones de Table Storage y Establecimiento de los encabezados de versión del servicio de datos de OData.

Consulte también

Table Storage REST API