TableQuery<T> Clase

Paquete:

com.microsoft.azure.storage.table

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

Parámetros de tipo

T

Tipo de clase que implementa TableEntity y contiene un constructor nullary. Nota: al usar una clase interna para definir el tipo de clase, marque la clase como estática.

public class TableQuery

Clase que representa una consulta en una tabla especificada. Una TableQuery<T> instancia agrega los parámetros de consulta que se van a usar cuando se ejecuta la consulta. Se debe llamar a uno de los métodos o de CloudTableClient para ejecutar la consulta. Los parámetros se codifican y se pasan al servidor cuando se ejecuta la consulta de tabla.

Para crear una consulta de tabla con sintaxis fluida, el from(final Class<T> clazzType) método de generador estático y los where(final String filter)métodos mutadores , select(final String[] columns)y take(final Integer take) devuelven una referencia al objeto que se puede encadenar a una sola expresión. Use el from(Class) método de generador de clases estáticas para crear una instancia que se ejecute en la tabla con nombre con entidades del tipo de implementación especificado TableEntity . Use el where(final String filter) método para especificar una expresión de filtro para las entidades devueltas. Use el select(final String[] columns) método para especificar las propiedades de entidad de tabla que se van a devolver. Use el take(final Integer take) método para limitar el número de entidades devueltas por la consulta. Tenga en cuenta que nada impide llamar a estos métodos más de una vez en , por lo que los valores guardados en el será el último encontrado en orden de ejecución.

Por ejemplo, podría construir una consulta de tabla mediante una sintaxis fluida:

En este ejemplo se crea una consulta en la tabla "Products" para todas las entidades en las que el valor PartitionKey es "ProductsMNO" y el valor RowKey es mayor o igual que "Napkin" y solicita las primeras 25 entidades coincidentes, seleccionando solo las propiedades comunes y la propiedad denominada "InventoryCount" y las devuelve como DynamicTableEntity objetos.

Las expresiones de filtro para su uso con el método o el where(final String filter) método se pueden crear mediante la sintaxis fluida con los métodos y combineFilters(String filterA, String operator, String filterB) métodos sobrecargadosgenerateFilterCondition(String propertyName, String operation, final boolean value), mediante los operadores de comparación definidos en QueryComparisons y los operadores lógicos definidos en Operators.setFilterString(final String filterString) Tenga en cuenta que el primer operando de una comparación de filtros debe ser un nombre de propiedad y el segundo operando debe evaluarse como una constante. Los valores de propiedad PartitionKey y RowKey son tipos con fines de comparación.

Los valores que se pueden usar en las consultas de tabla se explican con más detalle en el tema de MSDN Consulta de tablas y entidades, pero tenga en cuenta que los caracteres de espacio dentro de los valores no necesitan estar codificados con dirección URL, ya que esto se hará cuando se ejecute la consulta.

Los TableQuery#TableQuery(Class) métodos constructor y TableQuery#from(Class) generador estático requieren un tipo de clase que implementa TableEntity y contiene un constructor nullary. Si la consulta se ejecutará mediante , EntityResolver<T>el autor de la llamada puede especificar TableServiceEntity como el tipo de clase .

Resumen del constructor

Constructor	Description
TableQuery()	Inicializa una instancia vacía TableQuery<T> . Esta consulta de tabla no se puede ejecutar sin establecer un tipo de entidad de tabla.
TableQuery(final Class<T> clazzType)	Inicializa un TableQuery<T> objeto con el tipo de entidad de tabla especificado. Los autores de llamadas pueden especificar TableServiceEntity como el parámetro de tipo de clase si no se requiere ningún tipo más especializado.

Resumen del método

Modificador y tipo	Método y descripción
String	combineFilters(String filterA, String operator, String filterB) Crea una condición de filtro usando el operador lógico especificado en dos condiciones de filtro.
static<T extends TableEntity> TableQuery<T>	from(final Class<T> clazzType) Método de generador estático que construye una TableQuery<T> instancia y define su tipo de entidad de tabla. El método devuelve la TableQuery<T> referencia de instancia, lo que permite encadenar métodos adicionales para modificar la consulta. La instancia creada TableQuery<T> está especializada para las entidades de tabla del tipo de clase T especificado. Los llamadores pueden especificar TableServiceEntity como parámetro de tipo de clase si no se requiere ningún tipo más especializado.
String	generateFilterCondition(String propertyName, String operation, final boolean value) Genera una cadena de condición de filtro de propiedad para un valor. Crea una cadena con formato que se va a usar en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor, con formato booleano, como en el ejemplo siguiente: Esta instrucción establece en el siguiente valor:
String	generateFilterCondition(String propertyName, String operation, final byte[] value) Genera una cadena de condición de filtro de propiedad para un valor. Crea una cadena con formato que se va a usar en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor, con el formato de un valor binario, como en el ejemplo siguiente: Esta instrucción establece en el siguiente valor:
String	generateFilterCondition(String propertyName, String operation, final Byte[] value) Genera una cadena de condición de filtro de propiedad para un valor. Crea una cadena con formato que se va a usar en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor, con el formato de un valor binario, como en el ejemplo siguiente: Esta instrucción establece en el siguiente valor:
String	generateFilterCondition(String propertyName, String operation, final Date value) Genera una cadena de condición de filtro de propiedad para un valor. Crea una cadena con formato que se va a usar en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor, con el formato de un valor datetime, como en el ejemplo siguiente: Esta instrucción establece en algo parecido al siguiente valor:
String	generateFilterCondition(String propertyName, String operation, final double value) Genera una cadena de condición de filtro de propiedad para un valor. Crea una cadena con formato que se va a usar en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor , con el formato de valor double, como en el ejemplo siguiente: Esta instrucción establece en el siguiente valor:
String	generateFilterCondition(String propertyName, String operation, final int value) Genera una cadena de condición de filtro de propiedad para un valor. Crea una cadena con formato que se usará en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor, con formato de valor numérico, como en el ejemplo siguiente: Esta instrucción establece en el siguiente valor:
String	generateFilterCondition(String propertyName, String operation, final long value) Genera una cadena de condición de filtro de propiedad para un valor. Crea una cadena con formato que se usará en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor, con formato de valor numérico, como en el ejemplo siguiente: Esta instrucción establece en el siguiente valor:
String	generateFilterCondition(String propertyName, String operation, final String value) Genera una cadena de condición de filtro de propiedad para un valor. Crea una cadena con formato que se va a usar en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor, con el formato de un valor de cadena, como en el ejemplo siguiente: Esta instrucción establece en el siguiente valor:
String	generateFilterCondition(String propertyName, String operation, final UUID value) Genera una cadena de condición de filtro de propiedad para un valor. Crea una cadena con formato que se va a usar en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor , con el formato de un valor UUID, como en el ejemplo siguiente: Esta instrucción establece en el siguiente valor:
String	generateFilterCondition(String propertyName, String operation, String value, EdmType edmType) Genera una cadena de condición de filtro de propiedad. Crea una cadena con formato que se usará en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor, con el formato especificado EdmType.
UriQueryBuilder	generateQueryBuilder() Reservado para uso interno. Crea un UriQueryBuilder objeto que representa la consulta de tabla.
Class<T>	getClazzType() Obtiene el tipo de clase de las entidades de tabla devueltas por la consulta.
String []	getColumns() Obtiene una matriz de los nombres de propiedad de entidad de tabla especificados en la consulta de tabla. Todas las propiedades de la tabla se devuelven de forma predeterminada si no se especifica ningún nombre de propiedad con una cláusula select en la consulta de tabla. Las propiedades de entidad de tabla que se van a devolver se pueden especificar con una llamada a los setColumns(final String[] columns) métodos o select(final String[] columns) con una matriz de nombres de propiedad como parámetro. Tenga en cuenta que las propiedades del sistema , y se solicitan automáticamente desde table service si se especifican en o TableQuery<T> no.
String	getFilterString() Obtiene la expresión de filtro especificada en la consulta de tabla. Todas las entidades de la tabla se devuelven de forma predeterminada si no se especifica ninguna expresión de filtro en la consulta de tabla. Se puede especificar un filtro para las entidades que se van a devolver con una llamada a los setFilterString(final String filterString) métodos o where(final String filter) .
String	getSourceTableName() Obtiene el nombre de la tabla de origen especificada en la consulta de tabla.
Integer	getTakeCount() Obtiene el número de entidades que devuelve la consulta especificada en la consulta de tabla. Si este valor no se especifica en una consulta de tabla, se devolverá un máximo de 1000 entradas. El número de entidades que se van a devolver se puede especificar con una llamada a los setTakeCount(final Integer takeCount) métodos o take(final Integer take) . Si el valor devuelto por es mayor que 1000, la consulta iniciará una StorageException excepción cuando se ejecute.
TableQuery<T>	select(final String[] columns) Define los nombres de propiedad de las propiedades de entidad de tabla que devolverán cuando se ejecute la consulta de tabla. La cláusula es opcional en una consulta de tabla, que se usa para limitar las propiedades de tabla devueltas desde el servidor. De forma predeterminada, una consulta devolverá todas las propiedades de la entidad de tabla. Tenga en cuenta que las propiedades del sistema , y se solicitan automáticamente desde table service si se especifican en o TableQuery<T> no.
void	setClazzType(final Class<T> clazzType) Establece el tipo de clase de las entidades de tabla devueltas por la consulta. Se requiere un tipo de clase para ejecutar una consulta de tabla. Los autores de llamadas pueden especificar TableServiceEntity como parámetro de tipo de clase si no se requiere ningún tipo más especializado.
void	setColumns(final String[] columns) Establece los nombres de propiedad de las propiedades de entidad de tabla que se devolverán cuando se ejecute la consulta de tabla. De forma predeterminada, una consulta devolverá todas las propiedades de la entidad de tabla. Tenga en cuenta que las propiedades del sistema , y se solicitan automáticamente desde table service si se especifican en o TableQuery<T> no.
void	setFilterString(final String filterString) Establece la expresión de filtro que se va a usar en la consulta de tabla. Una expresión de filtro es opcional; de forma predeterminada, una consulta de tabla devolverá todas las entidades de la tabla. Las expresiones de filtro para su uso con el setFilterString(final String filterString) método se pueden crear mediante la sintaxis fluida con los métodos y combineFilters(String filterA, String operator, String filterB) métodos sobrecargadosgenerateFilterCondition(String propertyName, String operation, final boolean value), mediante los operadores de comparación definidos en QueryComparisons y los operadores lógicos definidos en Operators. Tenga en cuenta que el primer operando de una comparación de filtros debe ser un nombre de propiedad y el segundo operando debe evaluarse como una constante. Los valores de propiedad PartitionKey y RowKey son tipos con fines de comparación. Por ejemplo, para consultar todas las entidades con un valor PartitionKey de "AccessLogs" en la consulta de tabla : Los valores que se pueden usar en las consultas de tabla se explican con más detalle en el tema de MSDN. Consulta de tablas y entidades, pero tenga en cuenta que los caracteres de espacio dentro de los valores no necesitan estar codificados con dirección URL, ya que esto se hará cuando se ejecute la consulta. Tenga en cuenta que no se permiten más de 15 comparaciones discretas dentro de una cadena de filtro.
void	setSourceTableName(final String sourceTableName) Establece el nombre de la tabla de origen para la consulta de tabla. Una consulta de tabla debe tener una tabla de origen que se va a ejecutar.
void	setTakeCount(final Integer takeCount) Establece el límite superior para el número de entidades que devuelve la consulta. Si este valor no se especifica en una consulta de tabla, se devolverá de forma predeterminada un máximo de 1000 entradas. Si el valor especificado para el parámetro es mayor que 1000, la consulta iniciará una StorageException excepción cuando se ejecute.
TableQuery<T>	take(final Integer take) Define el límite superior del número de entidades que devuelve la consulta. Si este valor no se especifica en una consulta de tabla, se devolverá de forma predeterminada un máximo de 1000 entradas. Si el valor especificado para el parámetro es mayor que 1000, la consulta iniciará una StorageException excepción cuando se ejecute.
TableQuery<T>	where(final String filter) Define una expresión de filtro para la consulta de tabla. La consulta devolverá únicamente las entidades que cumplan la expresión de filtro especificada. La configuración de una expresión de filtro es opcional; de forma predeterminada, se devuelven todas las entidades de la tabla si no se especifica ninguna expresión de filtro en la consulta de tabla. Las expresiones de filtro para su uso con el where(final String filter) método se pueden crear mediante la sintaxis fluida con los métodos y combineFilters(String filterA, String operator, String filterB) métodos sobrecargadosgenerateFilterCondition(String propertyName, String operation, final boolean value), mediante los operadores de comparación definidos en QueryComparisons y los operadores lógicos definidos en Operators. Tenga en cuenta que el primer operando de una comparación de filtros debe ser un nombre de propiedad y el segundo operando debe evaluarse como una constante. Los valores de propiedad PartitionKey y RowKey son tipos con fines de comparación. Por ejemplo, para consultar todas las entidades con un valor PartitionKey de "AccessLogs" en la consulta de tabla : Los valores que se pueden usar en las consultas de tabla se explican con más detalle en el tema de MSDN. Consulta de tablas y entidades, pero tenga en cuenta que los caracteres de espacio dentro de los valores no necesitan estar codificados con dirección URL, ya que esto se hará cuando se ejecute la consulta. Tenga en cuenta que no se permiten más de 15 comparaciones discretas dentro de una cadena de filtro.

Detalles del constructor

TableQuery

public TableQuery()

Inicializa una instancia vacía TableQuery<T> . Esta consulta de tabla no se puede ejecutar sin establecer un tipo de entidad de tabla.

TableQuery

public TableQuery(final Class clazzType)

Inicializa un TableQuery<T> objeto con el tipo de entidad de tabla especificado. Los autores de llamadas pueden especificar TableServiceEntity como el parámetro de tipo de clase si no se requiere ningún tipo más especializado.

Parámetros:

clazzType - de java.lang.Class la clase T que representa el tipo de entidad de tabla de la consulta. La clase T debe ser un tipo que implemente TableEntity y tenga un constructor nullary.

Detalles del método

combineFilters

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

Crea una condición de filtro usando el operador lógico especificado en dos condiciones de filtro.

Parámetros:

filterA - que String especifica la primera condición de filtro con formato.

operator - que String especifica Operators.AND o Operators.OR.

filterB - que String especifica la primera condición de filtro con formato.

Devoluciones:

que String representa la expresión de filtro combinada.

from

public static static TableQuery from(final Class clazzType)

Método de generador estático que construye una TableQuery<T> instancia y define su tipo de entidad de tabla. El método devuelve la TableQuery<T> referencia de instancia, lo que permite encadenar métodos adicionales para modificar la consulta.

La instancia creada TableQuery<T> está especializada para las entidades de tabla del tipo de clase T especificado. Los llamadores pueden especificar TableServiceEntity como parámetro de tipo de clase si no se requiere ningún tipo más especializado.

Parámetros:

clazzType - de java.lang.Class la clase T que implementa la TableEntity interfaz que representa el tipo de entidad de tabla para la consulta.

Devoluciones:

Instancia TableQuery<T> con el conjunto de especialización de tipo de entidad.

generateFilterCondition

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

Genera una cadena de condición de filtro de propiedad para un valor. Crea una cadena con formato que se va a usar en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor, con formato booleano, como en el ejemplo siguiente:

Esta instrucción establece en el siguiente valor:

Parámetros:

propertyName - que String especifica el nombre de la propiedad que se va a comparar.

operation - que String especifica el operador de comparación que se va a usar.

value - que boolean especifica el valor que se va a comparar con la propiedad .

Devoluciones:

que String representa la condición de filtro con formato.

generateFilterCondition

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

Genera una cadena de condición de filtro de propiedad para un valor. Crea una cadena con formato que se va a usar en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor, con el formato de un valor binario, como en el ejemplo siguiente:

Esta instrucción establece en el siguiente valor:

Parámetros:

propertyName - que String especifica el nombre de la propiedad que se va a comparar.

operation - que String especifica el operador de comparación que se va a usar.

value - Matriz byte que especifica el valor que se va a comparar con la propiedad .

Devoluciones:

que String representa la condición de filtro con formato.

generateFilterCondition

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

Genera una cadena de condición de filtro de propiedad para un valor. Crea una cadena con formato que se va a usar en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor, con el formato de un valor binario, como en el ejemplo siguiente:

Esta instrucción establece en el siguiente valor:

Parámetros:

propertyName - que String especifica el nombre de la propiedad que se va a comparar.

operation - que String especifica el operador de comparación que se va a usar.

value - Matriz Byte que especifica el valor que se va a comparar con la propiedad .

Devoluciones:

que String representa la condición de filtro con formato.

generateFilterCondition

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

Genera una cadena de condición de filtro de propiedad para un valor. Crea una cadena con formato que se va a usar en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor, con el formato de un valor datetime, como en el ejemplo siguiente:

Esta instrucción establece en algo parecido al siguiente valor:

Parámetros:

propertyName - que String especifica el nombre de la propiedad que se va a comparar.

operation - que String especifica el operador de comparación que se va a usar.

value - que java.util.Date especifica el valor que se va a comparar con la propiedad .

Devoluciones:

que String representa la condición de filtro con formato.

generateFilterCondition

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

Genera una cadena de condición de filtro de propiedad para un valor. Crea una cadena con formato que se va a usar en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor , con el formato de valor double, como en el ejemplo siguiente:

Esta instrucción establece en el siguiente valor:

Parámetros:

propertyName - que String especifica el nombre de la propiedad que se va a comparar.

operation - que String especifica el operador de comparación que se va a usar.

value - que double especifica el valor que se va a comparar con la propiedad .

Devoluciones:

que String representa la condición de filtro con formato.

generateFilterCondition

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

Genera una cadena de condición de filtro de propiedad para un valor. Crea una cadena con formato que se usará en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor, con formato de valor numérico, como en el ejemplo siguiente:

Esta instrucción establece en el siguiente valor:

Parámetros:

propertyName - que String especifica el nombre de la propiedad que se va a comparar.

operation - que String especifica el operador de comparación que se va a usar.

value - que int especifica el valor que se va a comparar con la propiedad .

Devoluciones:

que String representa la condición de filtro con formato.

generateFilterCondition

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

Genera una cadena de condición de filtro de propiedad para un valor. Crea una cadena con formato que se usará en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor, con formato de valor numérico, como en el ejemplo siguiente:

Esta instrucción establece en el siguiente valor:

Parámetros:

propertyName - que String especifica el nombre de la propiedad que se va a comparar.

operation - que String especifica el operador de comparación que se va a usar.

value - que long especifica el valor que se va a comparar con la propiedad .

Devoluciones:

que String representa la condición de filtro con formato.

generateFilterCondition

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

Genera una cadena de condición de filtro de propiedad para un valor. Crea una cadena con formato que se va a usar en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor, con el formato de un valor de cadena, como en el ejemplo siguiente:

Esta instrucción establece en el siguiente valor:

Parámetros:

propertyName - que String especifica el nombre de la propiedad que se va a comparar.

operation - que String especifica el operador de comparación que se va a usar.

value - que String especifica el valor que se va a comparar con la propiedad .

Devoluciones:

que String representa la condición de filtro con formato.

generateFilterCondition

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

Genera una cadena de condición de filtro de propiedad para un valor. Crea una cadena con formato que se va a usar en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor , con el formato de un valor UUID, como en el ejemplo siguiente:

Esta instrucción establece en el siguiente valor:

Parámetros:

propertyName - que String especifica el nombre de la propiedad que se va a comparar.

operation - que String especifica el operador de comparación que se va a usar.

value - que UUID especifica el valor que se va a comparar con la propiedad .

Devoluciones:

que String representa la condición de filtro con formato.

generateFilterCondition

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

Genera una cadena de condición de filtro de propiedad. Crea una cadena con formato que se usará en una expresión de filtro que usa la operación especificada para comparar la propiedad con el valor, con el formato especificado EdmType.

Parámetros:

propertyName - que String especifica el nombre de la propiedad que se va a comparar.

operation - que String especifica el operador de comparación que se va a usar.

value - que String especifica el valor que se va a comparar con la propiedad .

edmType - que EdmType se va a dar formato al valor como.

Devoluciones:

que String representa la condición de filtro con formato.

generateQueryBuilder

protected UriQueryBuilder generateQueryBuilder()

Reservado para uso interno. Crea un UriQueryBuilder objeto que representa la consulta de tabla.

Devoluciones:

Objeto UriQueryBuilder que representa la consulta de tabla.

Produce:

StorageException - si se produce un error al agregar o codificar los parámetros de consulta.

getClazzType

public Class getClazzType()

Obtiene el tipo de clase de las entidades de tabla devueltas por la consulta.

Devoluciones:

de java.lang.Class la clase T que representa el tipo de entidad de tabla para la consulta.

getColumns

public String [] getColumns()

Obtiene una matriz de los nombres de propiedad de entidad de tabla especificados en la consulta de tabla. Todas las propiedades de la tabla se devuelven de forma predeterminada si no se especifica ningún nombre de propiedad con una cláusula select en la consulta de tabla. Las propiedades de entidad de tabla que se van a devolver se pueden especificar con una llamada a los setColumns(final String[] columns) métodos o select(final String[] columns) con una matriz de nombres de propiedad como parámetro.

Tenga en cuenta que las propiedades del sistema , y se solicitan automáticamente desde table service si se especifican en o TableQuery<T> no.

Devoluciones:

Matriz de objetos que representa los nombres de String propiedad de las propiedades de entidad de tabla que se van a devolver en la consulta.

getFilterString

public String getFilterString()

Obtiene la expresión de filtro especificada en la consulta de tabla. Todas las entidades de la tabla se devuelven de forma predeterminada si no se especifica ninguna expresión de filtro en la consulta de tabla. Se puede especificar un filtro para las entidades que se van a devolver con una llamada a los setFilterString(final String filterString) métodos o where(final String filter) .

Devoluciones:

que String representa la expresión de filtro usada en la consulta.

getSourceTableName

protected String getSourceTableName()

Obtiene el nombre de la tabla de origen especificada en la consulta de tabla.

Devoluciones:

que String representa el nombre de la tabla de origen utilizada en la consulta.

getTakeCount

public Integer getTakeCount()

Obtiene el número de entidades que devuelve la consulta especificada en la consulta de tabla. Si este valor no se especifica en una consulta de tabla, se devolverá un máximo de 1000 entradas. El número de entidades que se van a devolver se puede especificar con una llamada a los setTakeCount(final Integer takeCount) métodos o take(final Integer take) .

Si el valor devuelto por es mayor que 1000, la consulta iniciará una StorageException excepción cuando se ejecute.

Devoluciones:

que Integer representa el número máximo de entidades para que se devuelva la consulta de tabla.

select

public TableQuery select(final String[] columns)

Define los nombres de propiedad de las propiedades de entidad de tabla que devolverán cuando se ejecute la consulta de tabla. La cláusula es opcional en una consulta de tabla, que se usa para limitar las propiedades de tabla devueltas desde el servidor. De forma predeterminada, una consulta devolverá todas las propiedades de la entidad de tabla.

Tenga en cuenta que las propiedades del sistema , y se solicitan automáticamente desde table service si se especifican en o TableQuery<T> no.

Parámetros:

columns - Matriz de objetos que especifican los nombres de String propiedad de las propiedades de entidad de tabla que se van a devolver cuando se ejecuta la consulta.

Devoluciones:

Referencia a la instancia con las propiedades de entidad TableQuery<T> de tabla que se van a devolver.

setClazzType

public void setClazzType(final Class clazzType)

Establece el tipo de clase de las entidades de tabla devueltas por la consulta. Se requiere un tipo de clase para ejecutar una consulta de tabla.

Los autores de llamadas pueden especificar TableServiceEntity como parámetro de tipo de clase si no se requiere ningún tipo más especializado.

Parámetros:

clazzType - de java.lang.Class la clase T que representa el tipo de entidad de tabla para la consulta. La clase T debe ser un tipo que implementa TableEntity y tiene un constructor nullary,

setColumns

public void setColumns(final String[] columns)

Establece los nombres de propiedad de las propiedades de entidad de tabla que se devolverán cuando se ejecute la consulta de tabla. De forma predeterminada, una consulta devolverá todas las propiedades de la entidad de tabla.

Tenga en cuenta que las propiedades del sistema , y se solicitan automáticamente desde table service si se especifican en o TableQuery<T> no.

Parámetros:

columns - Matriz de objetos que especifican los nombres de String propiedad de las propiedades de entidad de tabla que se van a devolver cuando se ejecuta la consulta.

setFilterString

public void setFilterString(final String filterString)

Establece la expresión de filtro que se va a usar en la consulta de tabla. Una expresión de filtro es opcional; de forma predeterminada, una consulta de tabla devolverá todas las entidades de la tabla.

Las expresiones de filtro para su uso con el setFilterString(final String filterString) método se pueden crear mediante la sintaxis fluida con los métodos y combineFilters(String filterA, String operator, String filterB) métodos sobrecargadosgenerateFilterCondition(String propertyName, String operation, final boolean value), mediante los operadores de comparación definidos en QueryComparisons y los operadores lógicos definidos en Operators. Tenga en cuenta que el primer operando de una comparación de filtros debe ser un nombre de propiedad y el segundo operando debe evaluarse como una constante. Los valores de propiedad PartitionKey y RowKey son tipos con fines de comparación. Por ejemplo, para consultar todas las entidades con un valor PartitionKey de "AccessLogs" en la consulta de tabla :

Los valores que se pueden usar en las consultas de tabla se explican con más detalle en el tema de MSDN.

Consulta de tablas y entidades, pero tenga en cuenta que los caracteres de espacio dentro de los valores no necesitan estar codificados con dirección URL, ya que esto se hará cuando se ejecute la consulta.

Tenga en cuenta que no se permiten más de 15 comparaciones discretas dentro de una cadena de filtro.

Parámetros:

filterString - que String representa la expresión de filtro que se va a usar en la consulta.

setSourceTableName

protected void setSourceTableName(final String sourceTableName)

Establece el nombre de la tabla de origen para la consulta de tabla. Una consulta de tabla debe tener una tabla de origen que se va a ejecutar.

Parámetros:

sourceTableName - que String especifica el nombre de la tabla de origen que se va a usar en la consulta.

setTakeCount

public void setTakeCount(final Integer takeCount)

Establece el límite superior para el número de entidades que devuelve la consulta. Si este valor no se especifica en una consulta de tabla, se devolverá de forma predeterminada un máximo de 1000 entradas.

Si el valor especificado para el parámetro es mayor que 1000, la consulta iniciará una StorageException excepción cuando se ejecute.

Parámetros:

takeCount - que Integer representa el número máximo de entidades para que se devuelva la consulta de tabla.

take

public TableQuery take(final Integer take)

Define el límite superior del número de entidades que devuelve la consulta. Si este valor no se especifica en una consulta de tabla, se devolverá de forma predeterminada un máximo de 1000 entradas.

Si el valor especificado para el parámetro es mayor que 1000, la consulta iniciará una StorageException excepción cuando se ejecute.

Parámetros:

take - que Integer representa el número máximo de entidades para que se devuelva la consulta de tabla.

Devoluciones:

Referencia a la TableQuery<T> instancia con el número de entidades que se van a devolver.

where

public TableQuery where(final String filter)

Define una expresión de filtro para la consulta de tabla. La consulta devolverá únicamente las entidades que cumplan la expresión de filtro especificada. La configuración de una expresión de filtro es opcional; de forma predeterminada, se devuelven todas las entidades de la tabla si no se especifica ninguna expresión de filtro en la consulta de tabla.

Las expresiones de filtro para su uso con el where(final String filter) método se pueden crear mediante la sintaxis fluida con los métodos y combineFilters(String filterA, String operator, String filterB) métodos sobrecargadosgenerateFilterCondition(String propertyName, String operation, final boolean value), mediante los operadores de comparación definidos en QueryComparisons y los operadores lógicos definidos en Operators. Tenga en cuenta que el primer operando de una comparación de filtros debe ser un nombre de propiedad y el segundo operando debe evaluarse como una constante. Los valores de propiedad PartitionKey y RowKey son tipos con fines de comparación. Por ejemplo, para consultar todas las entidades con un valor PartitionKey de "AccessLogs" en la consulta de tabla :

Los valores que se pueden usar en las consultas de tabla se explican con más detalle en el tema de MSDN.

Consulta de tablas y entidades, pero tenga en cuenta que los caracteres de espacio dentro de los valores no necesitan estar codificados con dirección URL, ya que esto se hará cuando se ejecute la consulta.

Tenga en cuenta que no se permiten más de 15 comparaciones discretas dentro de una cadena de filtro.

Parámetros:

filter - que String especifica la expresión de filtro que se va a aplicar a la consulta de tabla.

Devoluciones:

Referencia a la TableQuery<T> instancia con el filtro en las entidades que se van a devolver.