Exportar (0) Imprimir
Expandir Tudo

Resumo de funcionalidade do serviço Tabela

Atualizado: fevereiro de 2014

A API REST do serviço Tabela é compatível com a Especificação de protocolo OData, com algumas diferenças, conforme descrito nas seções a seguir.

Extensões do serviço Tabela

Restrições do serviço Tabela

O serviço Tabela estende a funcionalidade de OData das maneiras a seguir.

O serviço Tabela requer que toda solicitação seja autenticada. Há suporte tanto para a autenticação de Chave Compartilhada quanto Shared Key Lite. A autenticação de Chave Compartilhada é mais segura e é recomendada para solicitações feitas em relação ao serviço Tabela usando a API REST.

Para obter mais informações sobre as solicitações de autenticação, consulte Autenticação federada para os Serviços de Armazenamento do Windows Azure.

Uma consulta no serviço Tabela pode retornar, no máximo, 1.000 itens simultaneamente e pode ser executada por até cinco segundos. Se o conjunto de resultados contiver mais de 1.000 itens ou se a consulta não foi concluída dentro de cinco segundos, a resposta incluirá os cabeçalhos que fornecem ao desenvolvedor os tokens de acompanhamento a serem usados para retomar a consulta no próximo item no conjunto de resultados. Os cabeçalhos de tokens de acompanhamento podem ser retornados para a operação Consultar tabelas (API REST) ou uma operação Entidades de consulta (API REST).

Observe que o tempo total distribuído à solicitação para agendar e processar a consulta é de 30 segundos, incluindo os cinco segundos para a execução da consulta.

Para obter mais informações sobre tokens de acompanhamento, consulte Tempo limite de consulta e paginação.

Cada entidade do serviço Tabela tem duas propriedades principais: a propriedade PartitionKey e a propriedade RowKey. Juntas, essas propriedades constituem a chave primária da tabela e identificam exclusivamente cada entidade na tabela.

Ambas as propriedades requerem valores de cadeia de caracteres. É responsabilidade do desenvolvedor fornecer valores para essas propriedades quando uma nova entidade é inserida e incluí-las em qualquer operação de atualização ou exclusão em uma entidade.

Para obter mais informações sobre essas propriedades de chave necessárias, consulte Noções básicas sobre o modelo de dados do serviço Tabela.

Cada entidade do serviço Tabela tem uma propriedade de sistema Timestamp. A propriedade Timestamp é um valor de DateTime que é mantido no servidor para registrar a hora em que uma entidade foi modificada pela última vez. O serviço Tabela usa a propriedade Timestamp internamente para fornecer simultaneidade otimista. O valor de Timestamp é um valor de forma monotônica, o que significa que cada vez que a entidade é alterada, o valor de Timestamp aumenta para essa entidade. Essa propriedade deve ser definida como operações de inserção ou atualização (o valor será ignorado).

Para obter mais informações sobre a propriedade Timestamp, consulte Noções básicas sobre o modelo de dados do serviço Tabela.

O serviço Tabela oferece suporte a transações em lotes em entidades que estão na mesma tabela e pertencem ao mesmo grupo de partição, o que significa que têm o mesmo valor PartitionKey. Isso permite o suporte para várias operações de inserção, atualização, mesclagem e exclusão em uma única transação atômica. O serviço Tabela dá suporte a um subconjunto da funcionalidade fornecida pelo protocolo OData.

Para obter mais informações sobre operações em lote, consulte Executando transações do grupo de entidades.

O serviço Tabela tem as seguintes limitações na funcionalidade fornecida por OData.

O serviço Tabela não oferece suporte ao uso da propriedade Credentials da classe DataServiceContext para autenticar uma solicitação. Em vez disso, você deve autenticar uma solicitação no serviço Tabela adicionando um cabeçalho Authorization à solicitação. Para obter mais informações, consulte Autenticação federada para os Serviços de Armazenamento do Windows Azure.

Nem todos os tipos de propriedade com suporte de OData têm suporte do serviço Tabela. Para obter uma lista dos tipos de propriedade com suporte, consulte Noções básicas sobre o modelo de dados do serviço Tabela.

Atualmente, o serviço Tabela não tem suporte para links entre tabelas. Os links são relações associativas entre dados.

A projeção refere-se a consultar um subconjunto de propriedades para uma ou mais entidades. Equivale a selecionar um subconjunto das colunas ou propriedades de uma tabela ao consultar no LINQ. A projeção reduz a quantidade de dados que devem ser retornados por uma consulta especificando que somente algumas propriedades serão retornadas na resposta. A projeção tem suporte como parte da versão 2011-08-18 dos serviços de armazenamento do Windows Azure. Para obter mais informações, consulte Entidades de consulta (API REST), Gravando consultas LINQ no serviço Tabela e OData: selecionar opção de consulta do sistema ($select).

O serviço Tabela dá suporte ao uso de consultas integradas de idioma (LINQ). Somente esses operadores de consulta LINQ têm suporte para uso com o serviço Tabela:

  • From

  • Where

  • Take

Para obter mais informações, consulte Operadores de consulta com suporte do serviço Tabela.

O serviço Tabela oferece suporte ao uso de um subconjunto dos operadores de comparação fornecidos pelo LINQ. Para obter mais informações, consulte Consultando tabelas e entidades e Gravando consultas LINQ no serviço Tabela.

O serviço Tabela oferece suporte ao método GetMetadataURI da classe DataServiceContext, mas não retorna nenhuma informação de esquema além das três propriedades de esquema fixo. Essas propriedades são PartitionKey, RowKey e Timestamp.

O OData oferece suporte ao envio de cargas no formato JSON. O serviço Tabela do Windows Azure dá suporte ao formato OData JSON a partir da versão 2013-08-15 da API, com a versão do serviço de dados OData definida como 3.0; as versões anteriores não dão suporte ao formato JSON. Para obter mais informações, consulte Formato de carga para operações do serviço Tabela e Definindo os cabeçalhos da versão do serviço de dados OData.

Consulte também

Mostrar:
© 2014 Microsoft