Exportar (0) Imprimir
Expandir todo

Crear cadenas de filtro para el Diseñador de tablas

Actualizado: mayo de 2015

Para filtrar los datos de una tabla de Azure que se muestra en el Diseñador de tablas de Visual Studio, se crea una cadena de filtro que posteriormente se especifica en el campo de filtro. La sintaxis de la cadena de filtro la definen los Servicios de datos de WCF, y es similar a una cláusula WHERE de SQL, pero se envía al servicio Tabla a través de una solicitud HTTP. El Diseñador de tablas se encarga de administrar automáticamente la codificación correcta, por lo que, para filtrar según un valor de propiedad dado, sólo necesita escribir el nombre de la propiedad, el operador de comparación, el criterio y, opcionalmente, un operador booleano en el campo de filtro. No necesita incluir la opción de consulta $filter como si estuviese creando una dirección URL para consultar la tabla a través de la Referencia de la API REST de servicios de almacenamiento.

WCF Data Services se basan en el Open Data Protocol (OData). Para obtener detalles sobre la opción de consulta del sistema ($filter), vea la especificación OData URI Conventions.

Los siguientes operadores lógicos se admiten para todos los tipos de propiedades:

 

Operador lógico Descripción Ejemplo de cadena de filtro

eq

Igual

City eq 'Redmond'

gt

Mayor que

Price gt 20

ge

Mayor o igual que

Price ge 10

lt

Menor que

Price lt 20

le

Menor o igual que

Price le 100

ne

No igual

City ne 'London'

y

Y

Price le 200 and Price gt 3.5

O bien

O bien,

Price le 3.5 or Price gt 200

not

No

not isAvailable

Al construir una cadena de filtro, las siguientes reglas son importantes:

  • Utilice los operadores lógicos para comparar una propiedad con un valor. Tenga en cuenta que no es posible comparar una propiedad con un valor dinámico; un lado de la expresión debe ser una constante.

  • Todas las partes de la cadena de filtro distinguen entre mayúsculas y minúsculas.

  • El valor constante debe ser del mismo tipo de datos que la propiedad para que el filtro devuelva resultados válidos. Para obtener más información sobre los tipos de propiedad admitidos, vea Introducción al modelo de datos del servicio Tabla.

Filtrar según propiedades de cadena

Al filtrar por propiedades de cadena, encierre la constante de cadena entre comillas sencillas.

En el siguiente ejemplo se filtra según las propiedades PartitionKey y RowKey; también podrían agregarse otras propiedades adicionales que no son clave a la cadena de filtro:

PartitionKey eq 'Partition1' and RowKey eq '00001'

Puede encerrar cada expresión de filtro entre paréntesis, aunque no es necesario:

(PartitionKey eq 'Partition1') and (RowKey eq '00001')

Observe que el servicio Tabla no admite consultas con caracteres comodín, y tampoco se admiten en el Diseñador de tablas. Sin embargo, puede usar operadores de comparación con el prefijo deseado para obtener coincidencias con prefijos. En el siguiente ejemplo se devuelven las entidades cuya propiedad LastName empieza por la letra 'A':

LastName ge 'A' and LastName lt 'B'

Filtrar según propiedades numéricas

Para filtrar por un número entero o de punto flotante, especifique el número sin comillas.

En este ejemplo se devuelven todas las entidades que tienen una propiedad Age con un valor mayor que 30:

Age gt 30

En este ejemplo se devuelven todas las entidades con una propiedad AmountDue cuyo valor es menor o igual que 100.25:

AmountDue le 100.25

Filtrar según propiedades booleanas

Para filtrar por un valor booleano, especifique true o false sin comillas dobles.

En el siguiente ejemplo se devuelven todas las entidades cuya propiedad IsActive está establecida en true:

IsActive eq true

También puede escribir esta expresión de filtro sin el operador lógico. En el siguiente ejemplo, el servicio Tabla también devolverá todas las entidades donde IsActive sea true:

IsActive

Para devolver todas las entidades donde IsActive sea false, puede utilizar el operador not:

not IsActive

Filtrar según propiedades DateTime

Para filtrar por un valor DateTime, especifique la palabra clave datetime, seguida de la constante de fecha y hora entre comillas simples. La constante de fecha y hora debe estar en formato UTC combinado, tal y como se describe en Formato de los valores de la propiedad DateTime.

En el siguiente ejemplo se devuelven las entidades cuya propiedad CustomerSince es igual al 10 de julio de 2008:

CustomerSince eq datetime'2008-07-10T00:00:00Z'

Mostrar:
© 2015 Microsoft