Partager via

TableQuery<T> Classe

  • Référence
Paquet:
com.microsoft.azure.storage.table
  • java.lang.Object
    • com.microsoft.azure.storage.table.TableQuery<T>

Paramètres de type

T

Type de classe qui implémente TableEntity et contient un constructeur nullaire. Remarque : lorsque vous utilisez une classe interne pour définir le type de classe, marquez la classe comme statique.

public class TableQuery

Classe qui représente une requête sur une table spécifiée. Une TableQuery<T> instance agrège les paramètres de requête à utiliser lors de l’exécution de la requête. L’une des méthodes ou de CloudTableClient doit être appelée pour exécuter la requête. Les paramètres sont encodés et passés au serveur lorsque la requête de table est exécutée.

Pour créer une requête de table avec la syntaxe Fluent, la from(final Class<T> clazzType) méthode de fabrique statique et les where(final String filter)méthodes mutateurs , select(final String[] columns)et take(final Integer take) retournent chacune une référence à l’objet qui peut être chaînée en une seule expression. Utilisez la from(Class) méthode de fabrique de classes statique pour créer un instance qui s’exécute sur la table nommée avec des entités du type d’implémentation spécifiéTableEntity. Utilisez la where(final String filter) méthode pour spécifier une expression de filtre pour les entités retournées. Utilisez la select(final String[] columns) méthode pour spécifier les propriétés d’entité de table à retourner. Utilisez la take(final Integer take) méthode pour limiter le nombre d’entités retournées par la requête. Notez que rien n’empêche d’appeler ces méthodes plusieurs fois sur un , de sorte que les valeurs enregistrées dans seront les dernières rencontrées dans l’ordre d’exécution.

Par exemple, vous pouvez construire une requête de table à l’aide de la syntaxe Fluent :

Cet exemple crée une requête sur la table « Products » pour toutes les entités où la valeur PartitionKey est « ProductsMNO » et la valeur RowKey est supérieure ou égale à « Napkin » et demande les 25 premières entités correspondantes, en sélectionnant uniquement les propriétés communes et la propriété nommée « InventoryCount », puis les retourne en tant qu’objets DynamicTableEntity .

Les expressions de filtre à utiliser avec la méthode ou la where(final String filter) méthode peuvent être créées à l’aide de la syntaxe Fluent avec les méthodes et la méthode surchargéesgenerateFilterCondition(String propertyName, String operation, final boolean value), à combineFilters(String filterA, String operator, String filterB) l’aide des opérateurs de comparaison définis dans QueryComparisons et des opérateurs logiques définis dans Operators.setFilterString(final String filterString) Notez que le premier opérande d’une comparaison de filtres doit être un nom de propriété et que le deuxième opérande doit être évalué à une constante. Les valeurs des propriétés PartitionKey et RowKey sont des types à des fins de comparaison.

Les valeurs qui peuvent être utilisées dans les requêtes de table sont expliquées plus en détail dans la rubrique MSDN Interrogation des tables et des entités, mais notez que les caractères d’espace dans les valeurs n’ont pas besoin d’être encodés en URL, car cette opération sera effectuée lors de l’exécution de la requête.

Le TableQuery#TableQuery(Class) constructeur et TableQuery#from(Class) les méthodes de fabrique statique nécessitent un type de classe qui implémente TableEntity et contient un constructeur nullaire. Si la requête est exécutée à l’aide d’un EntityResolver<T>, l’appelant peut spécifier TableServiceEntity comme type de classe.

Récapitulatif du constructeur

Constructeur Description
TableQuery()

Initialise un instance vide TableQuery<T> . Cette requête de table ne peut pas être exécutée sans définir un type d’entité table.

TableQuery(final Class<T> clazzType)

Initialise un avec le type d’entité TableQuery<T> table spécifié. Les appelants peuvent spécifier TableServiceEntity comme paramètre de type de classe si aucun type plus spécialisé n’est requis.

Résumé de la méthode

Modificateur et type Méthode et description
String combineFilters(String filterA, String operator, String filterB)

Crée une condition de filtre à l'aide de l'opérateur logique spécifié sur deux conditions de filtre.
static<T extends TableEntity> TableQuery<T> from(final Class<T> clazzType)

Méthode de fabrique statique qui construit un TableQuery<T> instance et définit son type d’entité table. La méthode retourne le TableQuery<T> instance référence, ce qui permet de chaîner des méthodes supplémentaires pour modifier la requête.

Le instance créé TableQuery<T> est spécialisé pour les entités de table du type de classe spécifié T. Les appelants peuvent spécifier TableServiceEntity comme paramètre de type de classe si aucun type plus spécialisé n’est requis.
String generateFilterCondition(String propertyName, String operation, final boolean value)

Génère une chaîne de condition de filtre de propriété pour une valeur. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme en tant que booléen, comme dans l’exemple suivant :

Cette instruction définit la valeur suivante :
String generateFilterCondition(String propertyName, String operation, final byte[] value)

Génère une chaîne de condition de filtre de propriété pour une valeur. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme en tant que valeur binaire, comme dans l’exemple suivant :

Cette instruction définit la valeur suivante :
String generateFilterCondition(String propertyName, String operation, final Byte[] value)

Génère une chaîne de condition de filtre de propriété pour une valeur. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme en tant que valeur binaire, comme dans l’exemple suivant :

Cette instruction définit la valeur suivante :
String generateFilterCondition(String propertyName, String operation, final Date value)

Génère une chaîne de condition de filtre de propriété pour une valeur. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme en tant que valeur datetime, comme dans l’exemple suivant :

Cette instruction définit quelque chose comme la valeur suivante :
String generateFilterCondition(String propertyName, String operation, final double value)

Génère une chaîne de condition de filtre de propriété pour une valeur. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme en tant que double valeur, comme dans l’exemple suivant :

Cette instruction définit la valeur suivante :
String generateFilterCondition(String propertyName, String operation, final int value)

Génère une chaîne de condition de filtre de propriété pour une valeur. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme sous forme numérique, comme dans l’exemple suivant :

Cette instruction définit la valeur suivante :
String generateFilterCondition(String propertyName, String operation, final long value)

Génère une chaîne de condition de filtre de propriété pour une valeur. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme sous forme numérique, comme dans l’exemple suivant :

Cette instruction définit la valeur suivante :
String generateFilterCondition(String propertyName, String operation, final String value)

Génère une chaîne de condition de filtre de propriété pour une valeur. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme comme valeur de chaîne, comme dans l’exemple suivant :

Cette instruction définit la valeur suivante :
String generateFilterCondition(String propertyName, String operation, final UUID value)

Génère une chaîne de condition de filtre de propriété pour une valeur. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme en tant que valeur UUID, comme dans l’exemple suivant :

Cette instruction définit la valeur suivante :
String generateFilterCondition(String propertyName, String operation, String value, EdmType edmType)

Génère une chaîne de condition de filtre de propriété. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme comme spécifié EdmType.
UriQueryBuilder generateQueryBuilder()

Réservé à un usage interne. Crée un UriQueryBuilder objet représentant la requête de table.
Class<T> getClazzType()

Obtient le type de classe des entités de table retournées par la requête.
String [] getColumns()

Obtient un tableau des noms de propriétés d’entité de table spécifiés dans la requête de table. Toutes les propriétés de la table sont retournées par défaut si aucun nom de propriété n’est spécifié avec une clause select dans la requête de table. Les propriétés d’entité de table à retourner peuvent être spécifiées avec un appel aux setColumns(final String[] columns) méthodes ou select(final String[] columns) avec un tableau de noms de propriétés en tant que paramètre.

Notez que les propriétés système , et sont automatiquement demandées au service de table, qu’elles soient spécifiées dans ou TableQuery<T> non.
String getFilterString()

Obtient l’expression de filtre spécifiée dans la requête de table. Toutes les entités de la table sont retournées par défaut si aucune expression de filtre n’est spécifiée dans la requête de table. Un filtre pour les entités à retourner peut être spécifié avec un appel aux setFilterString(final String filterString) méthodes ou where(final String filter) .
String getSourceTableName()

Obtient le nom de la table source spécifiée dans la requête de table.
Integer getTakeCount()

Obtient le nombre d’entités retournées par la requête spécifiée dans la requête de table. Si cette valeur n’est pas spécifiée dans une requête de table, un maximum de 1 000 entrées est retourné. Le nombre d’entités à retourner peut être spécifié avec un appel aux setTakeCount(final Integer takeCount) méthodes ou take(final Integer take) .

Si la valeur retournée par est supérieure à 1 000, la requête lève un StorageException lors de son exécution.
TableQuery<T> select(final String[] columns)

Définit les noms des propriétés d'entités de table à retourner lors de l'exécution de la requête de table. La clause est facultative sur une requête de table, utilisée pour limiter les propriétés de table retournées par le serveur. Par défaut, une requête retourne toutes les propriétés de l'entité de table.

Notez que les propriétés système , et sont automatiquement demandées au service de table, qu’elles soient spécifiées dans ou TableQuery<T> non.
void setClazzType(final Class<T> clazzType)

Définit le type de classe des entités de table retournées par la requête. Un type de classe est requis pour exécuter une requête de table.

Les appelants peuvent spécifier TableServiceEntity comme paramètre de type de classe si aucun type plus spécialisé n’est requis.
void setColumns(final String[] columns)

Définit les noms de propriétés des propriétés de l’entité de table à retourner lors de l’exécution de la requête de table. Par défaut, une requête retourne toutes les propriétés de l'entité de table.

Notez que les propriétés système , et sont automatiquement demandées au service de table, qu’elles soient spécifiées dans ou TableQuery<T> non.
void setFilterString(final String filterString)

Définit l’expression de filtre à utiliser dans la requête de table. Une expression de filtre est facultative ; par défaut, une requête de table retourne toutes les entités de la table.

Les expressions de filtre à utiliser avec la méthode peuvent être créées à l’aide setFilterString(final String filterString) de la syntaxe Fluent avec les méthodes et combineFilters(String filterA, String operator, String filterB) la méthode surchargéesgenerateFilterCondition(String propertyName, String operation, final boolean value), à l’aide des opérateurs de comparaison définis dans QueryComparisons et des opérateurs logiques définis dans Operators. Notez que le premier opérande d’une comparaison de filtres doit être un nom de propriété et que le deuxième opérande doit être évalué à une constante. Les valeurs des propriétés PartitionKey et RowKey sont des types à des fins de comparaison. Par exemple, pour interroger toutes les entités avec la valeur PartitionKey « AccessLogs » sur la requête de table :

Les valeurs qui peuvent être utilisées dans les requêtes de table sont expliquées plus en détail dans la rubrique MSDN

Interrogation des tables et des entités, mais notez que les caractères d’espace dans les valeurs n’ont pas besoin d’être encodés en URL, car cela sera effectué lorsque la requête sera exécutée.

Notez que pas plus de 15 comparaisons discrètes sont autorisées dans une chaîne de filtre.
void setSourceTableName(final String sourceTableName)

Définit le nom de la table source pour la requête de table. Une requête de table doit avoir une table source à exécuter.
void setTakeCount(final Integer takeCount)

Définit la limite supérieure pour le nombre d’entités retournées par la requête. Si cette valeur n’est pas spécifiée dans une requête de table, un maximum de 1 000 entrées est retourné par défaut.

Si la valeur spécifiée pour le paramètre est supérieure à 1 000, la requête lève un StorageException lors de l’exécution.
TableQuery<T> take(final Integer take)

Définit la limite supérieure du nombre d'entités retournées par la requête. Si cette valeur n’est pas spécifiée dans une requête de table, un maximum de 1 000 entrées est retourné par défaut.

Si la valeur spécifiée pour le paramètre est supérieure à 1 000, la requête lève un StorageException lors de l’exécution.
TableQuery<T> where(final String filter)

Définit une expression de filtre pour la requête de table. Seules les entités qui satisfont à l'expression de filtre spécifiée sont retournées par la requête. La définition d'une expression de filtre est facultative ; par défaut, toutes les entités de la table sont retournées si aucune expression de filtre n'est spécifiée dans la requête de table.

Les expressions de filtre à utiliser avec la méthode peuvent être créées à l’aide where(final String filter) de la syntaxe Fluent avec les méthodes et combineFilters(String filterA, String operator, String filterB) la méthode surchargéesgenerateFilterCondition(String propertyName, String operation, final boolean value), à l’aide des opérateurs de comparaison définis dans QueryComparisons et des opérateurs logiques définis dans Operators. Notez que le premier opérande d’une comparaison de filtres doit être un nom de propriété et que le deuxième opérande doit être évalué à une constante. Les valeurs des propriétés PartitionKey et RowKey sont des types à des fins de comparaison. Par exemple, pour interroger toutes les entités avec la valeur PartitionKey « AccessLogs » sur la requête de table :

Les valeurs qui peuvent être utilisées dans les requêtes de table sont expliquées plus en détail dans la rubrique MSDN

Interrogation des tables et des entités, mais notez que les caractères d’espace dans les valeurs n’ont pas besoin d’être encodés en URL, car cela sera effectué lorsque la requête sera exécutée.

Notez que pas plus de 15 comparaisons discrètes sont autorisées dans une chaîne de filtre.

Détails du constructeur

TableQuery

public TableQuery()

Initialise un instance vide TableQuery<T> . Cette requête de table ne peut pas être exécutée sans définir un type d’entité table.

TableQuery

public TableQuery(final Class clazzType)

Initialise un avec le type d’entité TableQuery<T> table spécifié. Les appelants peuvent spécifier TableServiceEntity comme paramètre de type de classe si aucun type plus spécialisé n’est requis.

Parameters:

clazzType - java.lang.Class de la classe T qui représente le type d’entité table pour la requête. La classe T doit être un type qui implémente TableEntity et a un constructeur nullaire.

Détails de la méthode

combineFilters

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

Crée une condition de filtre à l'aide de l'opérateur logique spécifié sur deux conditions de filtre.

Parameters:

filterA - String qui spécifie la première condition de filtre mise en forme.
operator - String qui spécifie Operators.AND ou Operators.OR.
filterB - String qui spécifie la première condition de filtre mise en forme.

Returns:

String qui représente l’expression de filtre combinée.

from

public static static TableQuery from(final Class clazzType)

Méthode de fabrique statique qui construit un TableQuery<T> instance et définit son type d’entité table. La méthode retourne le TableQuery<T> instance référence, ce qui permet de chaîner des méthodes supplémentaires pour modifier la requête.

Le instance créé TableQuery<T> est spécialisé pour les entités de table du type de classe spécifié T. Les appelants peuvent spécifier TableServiceEntity comme paramètre de type de classe si aucun type plus spécialisé n’est requis.

Parameters:

clazzType - de java.lang.Class la classe T implémentant l’interface TableEntity qui représente le type d’entité table pour la requête.

Returns:

Le TableQuery<T> instance avec l’ensemble de spécialisation de type d’entité.

generateFilterCondition

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

Génère une chaîne de condition de filtre de propriété pour une valeur. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme en tant que booléen, comme dans l’exemple suivant :

Cette instruction définit la valeur suivante :

Parameters:

propertyName - String qui spécifie le nom de la propriété à comparer.
operation - String qui spécifie l’opérateur de comparaison à utiliser.
value - boolean qui spécifie la valeur à comparer avec la propriété .

Returns:

String qui représente la condition de filtre mise en forme.

generateFilterCondition

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

Génère une chaîne de condition de filtre de propriété pour une valeur. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme en tant que valeur binaire, comme dans l’exemple suivant :

Cette instruction définit la valeur suivante :

Parameters:

propertyName - String qui spécifie le nom de la propriété à comparer.
operation - String qui spécifie l’opérateur de comparaison à utiliser.
value - Tableau byte qui spécifie la valeur à comparer avec la propriété .

Returns:

String qui représente la condition de filtre mise en forme.

generateFilterCondition

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

Génère une chaîne de condition de filtre de propriété pour une valeur. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme en tant que valeur binaire, comme dans l’exemple suivant :

Cette instruction définit la valeur suivante :

Parameters:

propertyName - String qui spécifie le nom de la propriété à comparer.
operation - String qui spécifie l’opérateur de comparaison à utiliser.
value - Tableau Byte qui spécifie la valeur à comparer avec la propriété .

Returns:

String qui représente la condition de filtre mise en forme.

generateFilterCondition

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

Génère une chaîne de condition de filtre de propriété pour une valeur. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme en tant que valeur datetime, comme dans l’exemple suivant :

Cette instruction définit quelque chose comme la valeur suivante :

Parameters:

propertyName - String qui spécifie le nom de la propriété à comparer.
operation - String qui spécifie l’opérateur de comparaison à utiliser.
value - java.util.Date qui spécifie la valeur à comparer avec la propriété .

Returns:

String qui représente la condition de filtre mise en forme.

generateFilterCondition

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

Génère une chaîne de condition de filtre de propriété pour une valeur. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme en tant que double valeur, comme dans l’exemple suivant :

Cette instruction définit la valeur suivante :

Parameters:

propertyName - String qui spécifie le nom de la propriété à comparer.
operation - String qui spécifie l’opérateur de comparaison à utiliser.
value - double qui spécifie la valeur à comparer avec la propriété .

Returns:

String qui représente la condition de filtre mise en forme.

generateFilterCondition

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

Génère une chaîne de condition de filtre de propriété pour une valeur. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme sous forme numérique, comme dans l’exemple suivant :

Cette instruction définit la valeur suivante :

Parameters:

propertyName - String qui spécifie le nom de la propriété à comparer.
operation - String qui spécifie l’opérateur de comparaison à utiliser.
value - int qui spécifie la valeur à comparer à la propriété .

Returns:

String qui représente la condition de filtre mise en forme.

generateFilterCondition

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

Génère une chaîne de condition de filtre de propriété pour une valeur. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme sous forme numérique, comme dans l’exemple suivant :

Cette instruction définit la valeur suivante :

Parameters:

propertyName - String qui spécifie le nom de la propriété à comparer.
operation - String qui spécifie l’opérateur de comparaison à utiliser.
value - long qui spécifie la valeur à comparer avec la propriété .

Returns:

String qui représente la condition de filtre mise en forme.

generateFilterCondition

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

Génère une chaîne de condition de filtre de propriété pour une valeur. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme comme valeur de chaîne, comme dans l’exemple suivant :

Cette instruction définit la valeur suivante :

Parameters:

propertyName - String qui spécifie le nom de la propriété à comparer.
operation - String qui spécifie l’opérateur de comparaison à utiliser.
value - String qui spécifie la valeur à comparer avec la propriété .

Returns:

String qui représente la condition de filtre mise en forme.

generateFilterCondition

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

Génère une chaîne de condition de filtre de propriété pour une valeur. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme en tant que valeur UUID, comme dans l’exemple suivant :

Cette instruction définit la valeur suivante :

Parameters:

propertyName - String qui spécifie le nom de la propriété à comparer.
operation - String qui spécifie l’opérateur de comparaison à utiliser.
value - UUID qui spécifie la valeur à comparer avec la propriété .

Returns:

String qui représente la condition de filtre mise en forme.

generateFilterCondition

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

Génère une chaîne de condition de filtre de propriété. Crée une chaîne mise en forme à utiliser dans une expression de filtre qui utilise l’opération spécifiée pour comparer la propriété à la valeur, mise en forme comme spécifié EdmType.

Parameters:

propertyName - String qui spécifie le nom de la propriété à comparer.
operation - String qui spécifie l’opérateur de comparaison à utiliser.
value - String qui spécifie la valeur à comparer avec la propriété .
edmType - EdmType pour mettre en forme la valeur .

Returns:

String qui représente la condition de filtre mise en forme.

generateQueryBuilder

protected UriQueryBuilder generateQueryBuilder()

Réservé à un usage interne. Crée un UriQueryBuilder objet représentant la requête de table.

Returns:

Objet UriQueryBuilder représentant la requête de table.

Throws:

StorageException - si une erreur se produit lors de l’ajout ou de l’encodage des paramètres de requête.

getClazzType

public Class getClazzType()

Obtient le type de classe des entités de table retournées par la requête.

Returns:

java.lang.Class de la classe T qui représente le type d’entité table pour la requête.

getColumns

public String [] getColumns()

Obtient un tableau des noms de propriétés d’entité de table spécifiés dans la requête de table. Toutes les propriétés de la table sont retournées par défaut si aucun nom de propriété n’est spécifié avec une clause select dans la requête de table. Les propriétés d’entité de table à retourner peuvent être spécifiées avec un appel aux setColumns(final String[] columns) méthodes ou select(final String[] columns) avec un tableau de noms de propriétés en tant que paramètre.

Notez que les propriétés système , et sont automatiquement demandées au service de table, qu’elles soient spécifiées dans ou TableQuery<T> non.

Returns:

Tableau d’objets String qui représente les noms de propriétés des propriétés d’entité de table à retourner dans la requête.

getFilterString

public String getFilterString()

Obtient l’expression de filtre spécifiée dans la requête de table. Toutes les entités de la table sont retournées par défaut si aucune expression de filtre n’est spécifiée dans la requête de table. Un filtre pour les entités à retourner peut être spécifié avec un appel aux setFilterString(final String filterString) méthodes ou where(final String filter) .

Returns:

String qui représente l’expression de filtre utilisée dans la requête.

getSourceTableName

protected String getSourceTableName()

Obtient le nom de la table source spécifiée dans la requête de table.

Returns:

String qui représente le nom de la table source utilisée dans la requête.

getTakeCount

public Integer getTakeCount()

Obtient le nombre d’entités retournées par la requête spécifiée dans la requête de table. Si cette valeur n’est pas spécifiée dans une requête de table, un maximum de 1 000 entrées est retourné. Le nombre d’entités à retourner peut être spécifié avec un appel aux setTakeCount(final Integer takeCount) méthodes ou take(final Integer take) .

Si la valeur retournée par est supérieure à 1 000, la requête lève un StorageException lors de son exécution.

Returns:

Integer qui représente le nombre maximal d’entités que la requête de table doit retourner.

select

public TableQuery select(final String[] columns)

Définit les noms des propriétés d'entités de table à retourner lors de l'exécution de la requête de table. La clause est facultative sur une requête de table, utilisée pour limiter les propriétés de table retournées par le serveur. Par défaut, une requête retourne toutes les propriétés de l'entité de table.

Notez que les propriétés système , et sont automatiquement demandées au service de table, qu’elles soient spécifiées dans ou TableQuery<T> non.

Parameters:

columns - Tableau d’objets String qui spécifient les noms de propriétés des propriétés d’entité de table à retourner lors de l’exécution de la requête.

Returns:

Référence à l’instance TableQuery<T> avec les propriétés d’entité de table pour retourner le jeu.

setClazzType

public void setClazzType(final Class clazzType)

Définit le type de classe des entités de table retournées par la requête. Un type de classe est requis pour exécuter une requête de table.

Les appelants peuvent spécifier TableServiceEntity comme paramètre de type de classe si aucun type plus spécialisé n’est requis.

Parameters:

clazzType - java.lang.Class de la classe T qui représente le type d’entité table pour la requête. La classe T doit être un type qui implémente TableEntity et a un constructeur nullaire,

setColumns

public void setColumns(final String[] columns)

Définit les noms de propriétés des propriétés de l’entité de table à retourner lors de l’exécution de la requête de table. Par défaut, une requête retourne toutes les propriétés de l'entité de table.

Notez que les propriétés système , et sont automatiquement demandées au service de table, qu’elles soient spécifiées dans ou TableQuery<T> non.

Parameters:

columns - Tableau d’objets String qui spécifient les noms de propriétés des propriétés d’entité de table à retourner lors de l’exécution de la requête.

setFilterString

public void setFilterString(final String filterString)

Définit l’expression de filtre à utiliser dans la requête de table. Une expression de filtre est facultative ; par défaut, une requête de table retourne toutes les entités de la table.

Les expressions de filtre à utiliser avec la méthode peuvent être créées à l’aide setFilterString(final String filterString) de la syntaxe Fluent avec les méthodes et combineFilters(String filterA, String operator, String filterB) la méthode surchargéesgenerateFilterCondition(String propertyName, String operation, final boolean value), à l’aide des opérateurs de comparaison définis dans QueryComparisons et des opérateurs logiques définis dans Operators. Notez que le premier opérande d’une comparaison de filtres doit être un nom de propriété et que le deuxième opérande doit être évalué à une constante. Les valeurs des propriétés PartitionKey et RowKey sont des types à des fins de comparaison. Par exemple, pour interroger toutes les entités avec la valeur PartitionKey « AccessLogs » sur la requête de table :

Les valeurs qui peuvent être utilisées dans les requêtes de table sont expliquées plus en détail dans la rubrique MSDN

Interrogation des tables et des entités, mais notez que les caractères d’espace dans les valeurs n’ont pas besoin d’être encodés en URL, car cela sera effectué lorsque la requête sera exécutée.

Notez que pas plus de 15 comparaisons discrètes sont autorisées dans une chaîne de filtre.

Parameters:

filterString - String qui représente l’expression de filtre à utiliser dans la requête.

setSourceTableName

protected void setSourceTableName(final String sourceTableName)

Définit le nom de la table source pour la requête de table. Une requête de table doit avoir une table source à exécuter.

Parameters:

sourceTableName - String qui spécifie le nom de la table source à utiliser dans la requête.

setTakeCount

public void setTakeCount(final Integer takeCount)

Définit la limite supérieure pour le nombre d’entités retournées par la requête. Si cette valeur n’est pas spécifiée dans une requête de table, un maximum de 1 000 entrées est retourné par défaut.

Si la valeur spécifiée pour le paramètre est supérieure à 1 000, la requête lève un StorageException lors de l’exécution.

Parameters:

takeCount - Integer qui représente le nombre maximal d’entités que la requête de table doit retourner.

take

public TableQuery take(final Integer take)

Définit la limite supérieure du nombre d'entités retournées par la requête. Si cette valeur n’est pas spécifiée dans une requête de table, un maximum de 1 000 entrées est retourné par défaut.

Si la valeur spécifiée pour le paramètre est supérieure à 1 000, la requête lève un StorageException lors de l’exécution.

Parameters:

take - Integer qui représente le nombre maximal d’entités que la requête de table doit retourner.

Returns:

Référence au TableQuery<T> instance avec le nombre d’entités à retourner.

where

public TableQuery where(final String filter)

Définit une expression de filtre pour la requête de table. Seules les entités qui satisfont à l'expression de filtre spécifiée sont retournées par la requête. La définition d'une expression de filtre est facultative ; par défaut, toutes les entités de la table sont retournées si aucune expression de filtre n'est spécifiée dans la requête de table.

Les expressions de filtre à utiliser avec la méthode peuvent être créées à l’aide where(final String filter) de la syntaxe Fluent avec les méthodes et combineFilters(String filterA, String operator, String filterB) la méthode surchargéesgenerateFilterCondition(String propertyName, String operation, final boolean value), à l’aide des opérateurs de comparaison définis dans QueryComparisons et des opérateurs logiques définis dans Operators. Notez que le premier opérande d’une comparaison de filtres doit être un nom de propriété et que le deuxième opérande doit être évalué à une constante. Les valeurs des propriétés PartitionKey et RowKey sont des types à des fins de comparaison. Par exemple, pour interroger toutes les entités avec la valeur PartitionKey « AccessLogs » sur la requête de table :

Les valeurs qui peuvent être utilisées dans les requêtes de table sont expliquées plus en détail dans la rubrique MSDN

Interrogation des tables et des entités, mais notez que les caractères d’espace dans les valeurs n’ont pas besoin d’être encodés en URL, car cela sera effectué lorsque la requête sera exécutée.

Notez que pas plus de 15 comparaisons discrètes sont autorisées dans une chaîne de filtre.

Parameters:

filter - String qui spécifie l’expression de filtre à appliquer à la requête de table.

Returns:

Référence à l’instance TableQuery<T> avec le filtre sur les entités à retourner.

S’applique à