TableQuery<T> Classe

Pacote:

com.microsoft.azure.storage.table

• java.lang.Object
• • com.microsoft.azure.storage.table.TableQuery<T>

Parâmetros de tipo

T

Um tipo de classe que implementa TableEntity e contém um construtor nullary. Observação: ao usar uma classe interna para definir o tipo de classe, marque a classe como estática.

public class TableQuery

Uma classe que representa uma consulta em relação a uma tabela especificada. Uma TableQuery<T> instância agrega os parâmetros de consulta a serem usados quando a consulta é executada. Um dos métodos ou de CloudTableClient deve ser chamado para executar a consulta. Os parâmetros são codificados e passados para o servidor quando a consulta de tabela é executada.

Para criar uma consulta de tabela com sintaxe fluente, o from(final Class<T> clazzType) método de fábrica estático e os where(final String filter)métodos de mutador , select(final String[] columns)e take(final Integer take) retornam uma referência ao objeto que pode ser encadeado em uma única expressão. Use o from(Class) método de fábrica de classe estática para criar uma instância executada na tabela nomeada com entidades do tipo de implementação especificado TableEntity . Use o where(final String filter) método para especificar uma expressão de filtro para as entidades retornadas. Use o select(final String[] columns) método para especificar as propriedades da entidade de tabela a serem retornadas. Use o take(final Integer take) método para limitar o número de entidades retornadas pela consulta. Observe que nada impede chamar esses métodos mais de uma vez em um , portanto, os valores salvos no serão os últimos encontrados na ordem de execução.

Por exemplo, você pode construir uma consulta de tabela usando a sintaxe fluente:

Este exemplo cria uma consulta na tabela "Products" para todas as entidades em que o valor PartitionKey é "ProductsMNO" e o valor RowKey é maior ou igual a "Napkin" e solicita as primeiras 25 entidades correspondentes, selecionando apenas as propriedades comuns e a propriedade chamada "InventoryCount" e as retorna como DynamicTableEntity objetos.

Expressões de filtro para uso com o método ou setFilterString(final String filterString) método podem ser criadas usando a sintaxe fluente com os métodos e combineFilters(String filterA, String operator, String filterB) o método sobrecarregadosgenerateFilterCondition(String propertyName, String operation, final boolean value), usando os operadores de comparação definidos em QueryComparisons e os operadores lógicos definidos em Operators.where(final String filter) Observe que o primeiro operando em uma comparação de filtro deve ser um nome de propriedade e o segundo operando deve ser avaliado como uma constante. Os valores da propriedade PartitionKey e RowKey são tipos para fins de comparação.

Os valores que podem ser usados em consultas de tabela são explicados mais detalhadamente no tópico MSDN Consultando Tabelas e Entidades, mas observe que os caracteres de espaço dentro de valores não precisam ser codificados em URL, pois isso será feito quando a consulta for executada.

O TableQuery#TableQuery(Class) construtor e TableQuery#from(Class) os métodos de fábrica estáticos exigem um tipo de classe que implementa TableEntity e contém um construtor nullary. Se a consulta for executada usando um EntityResolver<T>, o chamador poderá especificar TableServiceEntity como o tipo de classe.

Resumo do Construtor

Construtor	Description
TableQuery()	Inicializa uma instância vazia TableQuery<T> . Essa consulta de tabela não pode ser executada sem definir um tipo de entidade de tabela.
TableQuery(final Class<T> clazzType)	Inicializa um TableQuery<T> com o tipo de entidade de tabela especificado. Os chamadores poderão especificar TableServiceEntity como o parâmetro de tipo de classe se nenhum tipo mais especializado for necessário.

Resumo do método

Modificador e tipo	Método e descrição
String	combineFilters(String filterA, String operator, String filterB) Cria uma condição de filtro usando o operador lógico especificado em duas condições de filtro.
static<T extends TableEntity> TableQuery<T>	from(final Class<T> clazzType) Um método de fábrica estático que constrói uma TableQuery<T> instância e define seu tipo de entidade de tabela. O método retorna a referência de TableQuery<T> instância, permitindo que métodos adicionais sejam encadeados para modificar a consulta. A instância criada TableQuery<T> é especializada para entidades de tabela do tipo de classe especificado T. Os chamadores podem especificar TableServiceEntity como o parâmetro de tipo de classe se nenhum tipo mais especializado for necessário.
String	generateFilterCondition(String propertyName, String operation, final boolean value) Gera uma cadeia de caracteres de condição de filtro de propriedade para um valor. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatado como um booliano, como no exemplo a seguir: Esta instrução define como o seguinte valor:
String	generateFilterCondition(String propertyName, String operation, final byte[] value) Gera uma cadeia de caracteres de condição de filtro de propriedade para um valor. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatado como um valor binário, como no exemplo a seguir: Esta instrução define como o seguinte valor:
String	generateFilterCondition(String propertyName, String operation, final Byte[] value) Gera uma cadeia de caracteres de condição de filtro de propriedade para um valor. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatado como um valor binário, como no exemplo a seguir: Esta instrução define como o seguinte valor:
String	generateFilterCondition(String propertyName, String operation, final Date value) Gera uma cadeia de caracteres de condição de filtro de propriedade para um valor. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatado como um valor datetime, como no exemplo a seguir: Essa instrução define como algo semelhante ao seguinte valor:
String	generateFilterCondition(String propertyName, String operation, final double value) Gera uma cadeia de caracteres de condição de filtro de propriedade para um valor. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatada como um valor duplo, como no exemplo a seguir: Esta instrução define como o seguinte valor:
String	generateFilterCondition(String propertyName, String operation, final int value) Gera uma cadeia de caracteres de condição de filtro de propriedade para um valor. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatada como um valor numérico, como no exemplo a seguir: Esta instrução define como o seguinte valor:
String	generateFilterCondition(String propertyName, String operation, final long value) Gera uma cadeia de caracteres de condição de filtro de propriedade para um valor. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatada como um valor numérico, como no exemplo a seguir: Esta instrução define como o seguinte valor:
String	generateFilterCondition(String propertyName, String operation, final String value) Gera uma cadeia de caracteres de condição de filtro de propriedade para um valor. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatado como um valor de cadeia de caracteres, como no exemplo a seguir: Esta instrução define como o seguinte valor:
String	generateFilterCondition(String propertyName, String operation, final UUID value) Gera uma cadeia de caracteres de condição de filtro de propriedade para um valor. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatado como um valor UUID, como no exemplo a seguir: Esta instrução define como o seguinte valor:
String	generateFilterCondition(String propertyName, String operation, String value, EdmType edmType) Gera uma cadeia de caracteres de condição de filtro de propriedade. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatado como o especificado EdmType.
UriQueryBuilder	generateQueryBuilder() Reservado para uso interno. Cria um UriQueryBuilder objeto que representa a consulta de tabela.
Class<T>	getClazzType() Obtém o tipo de classe das entidades de tabela retornadas pela consulta.
String []	getColumns() Obtém uma matriz dos nomes de propriedade da entidade de tabela especificados na consulta de tabela. Todas as propriedades na tabela serão retornadas por padrão se nenhum nome de propriedade for especificado com uma cláusula select na consulta de tabela. As propriedades da entidade de tabela a serem retornadas podem ser especificadas com uma chamada para os setColumns(final String[] columns) métodos ou select(final String[] columns) com uma matriz de nomes de propriedade como parâmetro. Observe que as propriedades do sistema , e são solicitadas automaticamente do serviço de tabela especificada no TableQuery<T> ou não.
String	getFilterString() Obtém a expressão de filtro especificada na consulta de tabela. Todas as entidades na tabela serão retornadas por padrão se nenhuma expressão de filtro for especificada na consulta de tabela. Um filtro para as entidades a serem retornadas pode ser especificado com uma chamada para os setFilterString(final String filterString) métodos ou where(final String filter) .
String	getSourceTableName() Obtém o nome da tabela de origem especificada na consulta de tabela.
Integer	getTakeCount() Obtém o número de entidades que a consulta retorna especificadas na consulta de tabela. Se esse valor não for especificado em uma consulta de tabela, um máximo de 1.000 entradas será retornado. O número de entidades a serem retornadas pode ser especificado com uma chamada para os setTakeCount(final Integer takeCount) métodos ou take(final Integer take) . Se o valor retornado por for maior que 1.000, a consulta gerará um StorageException quando executada.
TableQuery<T>	select(final String[] columns) Define os nomes da propriedade das propriedades das entidades de tabela para retornar quando a consulta de tabela é executada. A cláusula é opcional em uma consulta de tabela, usada para limitar as propriedades da tabela retornadas do servidor. Por padrão, uma consulta retornará todas as propriedades da entidade de tabela. Observe que as propriedades do sistema , e são solicitadas automaticamente do serviço de tabela especificada no TableQuery<T> ou não.
void	setClazzType(final Class<T> clazzType) Define o tipo de classe das entidades de tabela retornadas pela consulta. Um tipo de classe é necessário para executar uma consulta de tabela. Os chamadores poderão especificar TableServiceEntity como o parâmetro de tipo de classe se nenhum tipo mais especializado for necessário.
void	setColumns(final String[] columns) Define os nomes de propriedade das propriedades da entidade de tabela a serem retornadas quando a consulta de tabela for executada. Por padrão, uma consulta retornará todas as propriedades da entidade de tabela. Observe que as propriedades do sistema , e são solicitadas automaticamente do serviço de tabela especificada no TableQuery<T> ou não.
void	setFilterString(final String filterString) Define a expressão de filtro a ser usada na consulta de tabela. Uma expressão de filtro é opcional; por padrão, uma consulta de tabela retornará todas as entidades na tabela. As expressões de filtro para uso com o setFilterString(final String filterString) método podem ser criadas usando a sintaxe fluente com os métodos e combineFilters(String filterA, String operator, String filterB) o método sobrecarregadosgenerateFilterCondition(String propertyName, String operation, final boolean value), usando os operadores de comparação definidos em QueryComparisons e os operadores lógicos definidos em Operators. Observe que o primeiro operando em uma comparação de filtro deve ser um nome de propriedade e o segundo operando deve ser avaliado como uma constante. Os valores da propriedade PartitionKey e RowKey são tipos para fins de comparação. Por exemplo, para consultar todas as entidades com um valor PartitionKey de "AccessLogs" na consulta de tabela: Os valores que podem ser usados em consultas de tabela são explicados mais detalhadamente no tópico MSDN Consultando tabelas e entidades, mas observe que os caracteres de espaço dentro dos valores não precisam ser codificados em URL, pois isso será feito quando a consulta for executada. Observe que não são permitidas mais de 15 comparações discretas em uma cadeia de caracteres de filtro.
void	setSourceTableName(final String sourceTableName) Define o nome da tabela de origem para a consulta de tabela. Uma consulta de tabela deve ter uma tabela de origem a ser executada.
void	setTakeCount(final Integer takeCount) Define o limite superior para o número de entidades que a consulta retorna. Se esse valor não for especificado em uma consulta de tabela, por padrão, um máximo de 1.000 entradas será retornado. Se o valor especificado para o parâmetro for maior que 1.000, a consulta gerará um StorageException quando executada.
TableQuery<T>	take(final Integer take) Define o limite superior para o número de entidades que a consulta retorna. Se esse valor não for especificado em uma consulta de tabela, por padrão, um máximo de 1.000 entradas será retornado. Se o valor especificado para o parâmetro for maior que 1.000, a consulta gerará um StorageException quando executada.
TableQuery<T>	where(final String filter) Define uma expressão de filtro para a consulta de tabela. Apenas entidades que satisfaçam a expressão de filtro especificada serão retornadas pela consulta. Definir uma expressão de filtro é opcional. Por padrão, todas as entidades na tabela são retornadas se nenhuma expressão de filtro é especificada na consulta de tabela. As expressões de filtro para uso com o where(final String filter) método podem ser criadas usando a sintaxe fluente com os métodos e combineFilters(String filterA, String operator, String filterB) o método sobrecarregadosgenerateFilterCondition(String propertyName, String operation, final boolean value), usando os operadores de comparação definidos em QueryComparisons e os operadores lógicos definidos em Operators. Observe que o primeiro operando em uma comparação de filtro deve ser um nome de propriedade e o segundo operando deve ser avaliado como uma constante. Os valores da propriedade PartitionKey e RowKey são tipos para fins de comparação. Por exemplo, para consultar todas as entidades com um valor PartitionKey de "AccessLogs" na consulta de tabela: Os valores que podem ser usados em consultas de tabela são explicados mais detalhadamente no tópico MSDN Consultando tabelas e entidades, mas observe que os caracteres de espaço dentro dos valores não precisam ser codificados em URL, pois isso será feito quando a consulta for executada. Observe que não são permitidas mais de 15 comparações discretas em uma cadeia de caracteres de filtro.

Detalhes do construtor

TableQuery

public TableQuery()

Inicializa uma instância vazia TableQuery<T> . Essa consulta de tabela não pode ser executada sem definir um tipo de entidade de tabela.

TableQuery

public TableQuery(final Class clazzType)

Inicializa um TableQuery<T> com o tipo de entidade de tabela especificado. Os chamadores poderão especificar TableServiceEntity como o parâmetro de tipo de classe se nenhum tipo mais especializado for necessário.

Parameters:

clazzType - O java.lang.Class da classe T que representa o tipo de entidade de tabela para a consulta. A classe T deve ser um tipo que implementa TableEntity e tem um construtor nullary.

Detalhes do método

combineFilters

public static String combineFilters(String filterA, String operator, String filterB)

Cria uma condição de filtro usando o operador lógico especificado em duas condições de filtro.

Parameters:

filterA - Um String que especifica a primeira condição de filtro formatada.

operator - Um String que especifica Operators.AND ou Operators.OR.

filterB - Um String que especifica a primeira condição de filtro formatada.

Returns:

Um String que representa a expressão de filtro combinada.

from

public static static TableQuery from(final Class clazzType)

Um método de fábrica estático que constrói uma TableQuery<T> instância e define seu tipo de entidade de tabela. O método retorna a referência de TableQuery<T> instância, permitindo que métodos adicionais sejam encadeados para modificar a consulta.

A instância criada TableQuery<T> é especializada para entidades de tabela do tipo de classe especificado T. Os chamadores podem especificar TableServiceEntity como o parâmetro de tipo de classe se nenhum tipo mais especializado for necessário.

Parameters:

clazzType - O java.lang.Class da classe T que implementa a TableEntity interface que representa o tipo de entidade de tabela para a consulta.

Returns:

A TableQuery<T> instância com o conjunto de especialização de tipo de entidade.

generateFilterCondition

public static String generateFilterCondition(String propertyName, String operation, final boolean value)

Gera uma cadeia de caracteres de condição de filtro de propriedade para um valor. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatado como um booliano, como no exemplo a seguir:

Esta instrução define como o seguinte valor:

Parameters:

propertyName - Um String que especifica o nome da propriedade a ser comparada.

operation - Um String que especifica o operador de comparação a ser usado.

value - Um boolean que especifica o valor a ser comparado com a propriedade .

Returns:

Um String que representa a condição de filtro formatada.

generateFilterCondition

public static String generateFilterCondition(String propertyName, String operation, final byte[] value)

Gera uma cadeia de caracteres de condição de filtro de propriedade para um valor. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatado como um valor binário, como no exemplo a seguir:

Esta instrução define como o seguinte valor:

Parameters:

propertyName - Um String que especifica o nome da propriedade a ser comparada.

operation - Um String que especifica o operador de comparação a ser usado.

value - Uma byte matriz que especifica o valor a ser comparado com a propriedade .

Returns:

Um String que representa a condição de filtro formatada.

generateFilterCondition

public static String generateFilterCondition(String propertyName, String operation, final Byte[] value)

Gera uma cadeia de caracteres de condição de filtro de propriedade para um valor. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatado como um valor binário, como no exemplo a seguir:

Esta instrução define como o seguinte valor:

Parameters:

propertyName - Um String que especifica o nome da propriedade a ser comparada.

operation - Um String que especifica o operador de comparação a ser usado.

value - Uma Byte matriz que especifica o valor a ser comparado com a propriedade .

Returns:

Um String que representa a condição de filtro formatada.

generateFilterCondition

public static String generateFilterCondition(String propertyName, String operation, final Date value)

Gera uma cadeia de caracteres de condição de filtro de propriedade para um valor. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatado como um valor datetime, como no exemplo a seguir:

Essa instrução define como algo semelhante ao seguinte valor:

Parameters:

propertyName - Um String que especifica o nome da propriedade a ser comparada.

operation - Um String que especifica o operador de comparação a ser usado.

value - Um java.util.Date que especifica o valor a ser comparado com a propriedade .

Returns:

Um String que representa a condição de filtro formatada.

generateFilterCondition

public static String generateFilterCondition(String propertyName, String operation, final double value)

Gera uma cadeia de caracteres de condição de filtro de propriedade para um valor. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatada como um valor duplo, como no exemplo a seguir:

Esta instrução define como o seguinte valor:

Parameters:

propertyName - Um String que especifica o nome da propriedade a ser comparada.

operation - Um String que especifica o operador de comparação a ser usado.

value - Um double que especifica o valor a ser comparado com a propriedade .

Returns:

Um String que representa a condição de filtro formatada.

generateFilterCondition

public static String generateFilterCondition(String propertyName, String operation, final int value)

Gera uma cadeia de caracteres de condição de filtro de propriedade para um valor. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatada como um valor numérico, como no exemplo a seguir:

Esta instrução define como o seguinte valor:

Parameters:

propertyName - Um String que especifica o nome da propriedade a ser comparada.

operation - Um String que especifica o operador de comparação a ser usado.

value - Um int que especifica o valor a ser comparado com a propriedade .

Returns:

Um String que representa a condição de filtro formatada.

generateFilterCondition

public static String generateFilterCondition(String propertyName, String operation, final long value)

Gera uma cadeia de caracteres de condição de filtro de propriedade para um valor. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatada como um valor numérico, como no exemplo a seguir:

Esta instrução define como o seguinte valor:

Parameters:

propertyName - Um String que especifica o nome da propriedade a ser comparada.

operation - Um String que especifica o operador de comparação a ser usado.

value - Um long que especifica o valor a ser comparado com a propriedade .

Returns:

Um String que representa a condição de filtro formatada.

generateFilterCondition

public static String generateFilterCondition(String propertyName, String operation, final String value)

Gera uma cadeia de caracteres de condição de filtro de propriedade para um valor. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatado como um valor de cadeia de caracteres, como no exemplo a seguir:

Esta instrução define como o seguinte valor:

Parameters:

propertyName - Um String que especifica o nome da propriedade a ser comparada.

operation - Um String que especifica o operador de comparação a ser usado.

value - Um String que especifica o valor a ser comparado com a propriedade .

Returns:

Um String que representa a condição de filtro formatada.

generateFilterCondition

public static String generateFilterCondition(String propertyName, String operation, final UUID value)

Gera uma cadeia de caracteres de condição de filtro de propriedade para um valor. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatado como um valor UUID, como no exemplo a seguir:

Esta instrução define como o seguinte valor:

Parameters:

propertyName - Um String que especifica o nome da propriedade a ser comparada.

operation - Um String que especifica o operador de comparação a ser usado.

value - Um UUID que especifica o valor a ser comparado com a propriedade .

Returns:

Um String que representa a condição de filtro formatada.

generateFilterCondition

public static String generateFilterCondition(String propertyName, String operation, String value, EdmType edmType)

Gera uma cadeia de caracteres de condição de filtro de propriedade. Cria uma cadeia de caracteres formatada a ser usada em uma expressão de filtro que usa a operação especificada para comparar a propriedade com o valor, formatado como o especificado EdmType.

Parameters:

propertyName - Um String que especifica o nome da propriedade a ser comparada.

operation - Um String que especifica o operador de comparação a ser usado.

value - Um String que especifica o valor a ser comparado com a propriedade .

edmType - O EdmType para formatar o valor como.

Returns:

Um String que representa a condição de filtro formatada.

generateQueryBuilder

protected UriQueryBuilder generateQueryBuilder()

Reservado para uso interno. Cria um UriQueryBuilder objeto que representa a consulta de tabela.

Returns:

Um UriQueryBuilder objeto que representa a consulta de tabela.

Throws:

StorageException - se ocorrer um erro ao adicionar ou codificar os parâmetros de consulta.

getClazzType

public Class getClazzType()

Obtém o tipo de classe das entidades de tabela retornadas pela consulta.

Returns:

O java.lang.Class da classe T que representa o tipo de entidade de tabela para a consulta.

getColumns

public String [] getColumns()

Obtém uma matriz dos nomes de propriedade da entidade de tabela especificados na consulta de tabela. Todas as propriedades na tabela serão retornadas por padrão se nenhum nome de propriedade for especificado com uma cláusula select na consulta de tabela. As propriedades da entidade de tabela a serem retornadas podem ser especificadas com uma chamada para os setColumns(final String[] columns) métodos ou select(final String[] columns) com uma matriz de nomes de propriedade como parâmetro.

Observe que as propriedades do sistema , e são solicitadas automaticamente do serviço de tabela especificada no TableQuery<T> ou não.

Returns:

Uma matriz de String objetos que representa os nomes de propriedade das propriedades da entidade de tabela a serem retornadas na consulta.

getFilterString

public String getFilterString()

Obtém a expressão de filtro especificada na consulta de tabela. Todas as entidades na tabela serão retornadas por padrão se nenhuma expressão de filtro for especificada na consulta de tabela. Um filtro para as entidades a serem retornadas pode ser especificado com uma chamada para os setFilterString(final String filterString) métodos ou where(final String filter) .

Returns:

Um String que representa a expressão de filtro usada na consulta.

getSourceTableName

protected String getSourceTableName()

Obtém o nome da tabela de origem especificada na consulta de tabela.

Returns:

Um String que representa o nome da tabela de origem usada na consulta.

getTakeCount

public Integer getTakeCount()

Obtém o número de entidades que a consulta retorna especificadas na consulta de tabela. Se esse valor não for especificado em uma consulta de tabela, um máximo de 1.000 entradas será retornado. O número de entidades a serem retornadas pode ser especificado com uma chamada para os setTakeCount(final Integer takeCount) métodos ou take(final Integer take) .

Se o valor retornado por for maior que 1.000, a consulta gerará um StorageException quando executada.

Returns:

Um Integer que representa o número máximo de entidades para a consulta de tabela retornar.

select

public TableQuery select(final String[] columns)

Define os nomes da propriedade das propriedades das entidades de tabela para retornar quando a consulta de tabela é executada. A cláusula é opcional em uma consulta de tabela, usada para limitar as propriedades da tabela retornadas do servidor. Por padrão, uma consulta retornará todas as propriedades da entidade de tabela.

Observe que as propriedades do sistema , e são solicitadas automaticamente do serviço de tabela especificada no TableQuery<T> ou não.

Parameters:

columns - Uma matriz de String objetos que especifica os nomes de propriedade das propriedades da entidade de tabela a serem retornadas quando a consulta é executada.

Returns:

Uma referência à TableQuery<T> instância com as propriedades da entidade de tabela a serem retornadas.

setClazzType

public void setClazzType(final Class clazzType)

Define o tipo de classe das entidades de tabela retornadas pela consulta. Um tipo de classe é necessário para executar uma consulta de tabela.

Os chamadores poderão especificar TableServiceEntity como o parâmetro de tipo de classe se nenhum tipo mais especializado for necessário.

Parameters:

clazzType - O java.lang.Class da classe T que representa o tipo de entidade de tabela para a consulta. A classe T deve ser um tipo que implementa TableEntity e tem um construtor nullary,

setColumns

public void setColumns(final String[] columns)

Define os nomes de propriedade das propriedades da entidade de tabela a serem retornadas quando a consulta de tabela for executada. Por padrão, uma consulta retornará todas as propriedades da entidade de tabela.

Observe que as propriedades do sistema , e são solicitadas automaticamente do serviço de tabela especificada no TableQuery<T> ou não.

Parameters:

columns - Uma matriz de String objetos que especifica os nomes de propriedade das propriedades da entidade de tabela a serem retornadas quando a consulta é executada.

setFilterString

public void setFilterString(final String filterString)

Define a expressão de filtro a ser usada na consulta de tabela. Uma expressão de filtro é opcional; por padrão, uma consulta de tabela retornará todas as entidades na tabela.

As expressões de filtro para uso com o setFilterString(final String filterString) método podem ser criadas usando a sintaxe fluente com os métodos e combineFilters(String filterA, String operator, String filterB) o método sobrecarregadosgenerateFilterCondition(String propertyName, String operation, final boolean value), usando os operadores de comparação definidos em QueryComparisons e os operadores lógicos definidos em Operators. Observe que o primeiro operando em uma comparação de filtro deve ser um nome de propriedade e o segundo operando deve ser avaliado como uma constante. Os valores da propriedade PartitionKey e RowKey são tipos para fins de comparação. Por exemplo, para consultar todas as entidades com um valor PartitionKey de "AccessLogs" na consulta de tabela:

Os valores que podem ser usados em consultas de tabela são explicados mais detalhadamente no tópico MSDN

Consultando tabelas e entidades, mas observe que os caracteres de espaço dentro dos valores não precisam ser codificados em URL, pois isso será feito quando a consulta for executada.

Observe que não são permitidas mais de 15 comparações discretas em uma cadeia de caracteres de filtro.

Parameters:

filterString - Um String que representa a expressão de filtro a ser usada na consulta.

setSourceTableName

protected void setSourceTableName(final String sourceTableName)

Define o nome da tabela de origem para a consulta de tabela. Uma consulta de tabela deve ter uma tabela de origem a ser executada.

Parameters:

sourceTableName - Um String que especifica o nome da tabela de origem a ser usada na consulta.

setTakeCount

public void setTakeCount(final Integer takeCount)

Define o limite superior para o número de entidades que a consulta retorna. Se esse valor não for especificado em uma consulta de tabela, por padrão, um máximo de 1.000 entradas será retornado.

Se o valor especificado para o parâmetro for maior que 1.000, a consulta gerará um StorageException quando executada.

Parameters:

takeCount - Um Integer que representa o número máximo de entidades para a consulta de tabela retornar.

take

public TableQuery take(final Integer take)

Define o limite superior para o número de entidades que a consulta retorna. Se esse valor não for especificado em uma consulta de tabela, por padrão, um máximo de 1.000 entradas será retornado.

Se o valor especificado para o parâmetro for maior que 1.000, a consulta gerará um StorageException quando executada.

Parameters:

take - Um Integer que representa o número máximo de entidades para a consulta de tabela retornar.

Returns:

Uma referência à TableQuery<T> instância com o número de entidades a serem retornadas.

where

public TableQuery where(final String filter)

Define uma expressão de filtro para a consulta de tabela. Apenas entidades que satisfaçam a expressão de filtro especificada serão retornadas pela consulta. Definir uma expressão de filtro é opcional. Por padrão, todas as entidades na tabela são retornadas se nenhuma expressão de filtro é especificada na consulta de tabela.

As expressões de filtro para uso com o where(final String filter) método podem ser criadas usando a sintaxe fluente com os métodos e combineFilters(String filterA, String operator, String filterB) o método sobrecarregadosgenerateFilterCondition(String propertyName, String operation, final boolean value), usando os operadores de comparação definidos em QueryComparisons e os operadores lógicos definidos em Operators. Observe que o primeiro operando em uma comparação de filtro deve ser um nome de propriedade e o segundo operando deve ser avaliado como uma constante. Os valores da propriedade PartitionKey e RowKey são tipos para fins de comparação. Por exemplo, para consultar todas as entidades com um valor PartitionKey de "AccessLogs" na consulta de tabela:

Os valores que podem ser usados em consultas de tabela são explicados mais detalhadamente no tópico MSDN

Consultando tabelas e entidades, mas observe que os caracteres de espaço dentro dos valores não precisam ser codificados em URL, pois isso será feito quando a consulta for executada.

Observe que não são permitidas mais de 15 comparações discretas em uma cadeia de caracteres de filtro.

Parameters:

filter - Um String que especifica a expressão de filtro a ser aplicada à consulta de tabela.

Returns:

Uma referência à TableQuery<T> instância com o filtro em entidades a serem retornadas.