Partager via

CloudTableClient Classe

  • Référence
Paquet:
com.microsoft.azure.storage.table
  • java.lang.Object
    • ServiceClient
      • com.microsoft.azure.storage.table.CloudTableClient

public class CloudTableClient extends ServiceClient

Fournit un client de service pour accéder au service Table Microsoft Azure.

La CloudTableClient classe encapsule l’URI de base pour le point de terminaison du service Table et les informations d’identification pour accéder au compte de stockage, et fournit des méthodes pour créer, supprimer, répertorier et interroger des tables, ainsi que des méthodes pour exécuter des opérations et des requêtes sur des entités de table. Ces méthodes appellent les opérations de l’API REST du service de stockage pour effectuer les requêtes et obtenir les résultats retournés.

Un point de terminaison de service Table est l’URI de base pour les ressources de service de table, y compris le nom DNS du compte de stockage :

Pour plus d’informations, consultez la rubrique MSDN Addressing Table Service Resources.

Les informations d’identification peuvent être une combinaison du nom du compte de stockage et d’une clé, ou d’une signature d’accès partagé. Pour plus d’informations, consultez la rubrique MSDN Authentification de l’accès à votre compte de stockage.

Récapitulatif du constructeur

Constructeur Description
CloudTableClient(final StorageUri baseUri, StorageCredentials credentials)

Initialise un instance de la classe à l’aide d’un point de terminaison de service Table et des informations d’identification de compte de stockage.
CloudTableClient(final URI baseUri, StorageCredentials credentials)

Initialise un instance de la classe à l’aide d’un point de terminaison de service Table et des informations d’identification de compte de stockage.

Résumé de la méthode

Modificateur et type Méthode et description
final ServiceProperties downloadServiceProperties()

Récupère le actuel ServiceProperties pour le service de stockage donné. Cela inclut les configurations Logging, HourMetrics, MinuteMetrics et CORS.
final ServiceProperties downloadServiceProperties(TableRequestOptions options, OperationContext opContext)

Récupère le actuel ServiceProperties pour le service de stockage donné. Cela inclut les configurations Logging, HourMetrics, MinuteMetrics et CORS.
<T extends TableEntity, R> ResultSegment<?> executeQuerySegmentedImpl(final TableQuery<T> queryToExecute, final EntityResolver<R> resolver, final ResultContinuation continuationToken, TableRequestOptions options, OperationContext opContext)

Réservé à un usage interne. Exécute une opération de requête segmentée à l’aide des stratégies de nouvelle tentative et de délai d’expiration spécifiées.
<T extends TableEntity, R> Iterable<?> generateIteratorForQuery(final TableQuery<T> queryRef, final EntityResolver<R> resolver, TableRequestOptions options, OperationContext opContext)

Réservé à un usage interne. Génère un itérateur pour une opération de requête segmentée.
TableRequestOptions getDefaultRequestOptions()

Obtient le TableRequestOptions qui est utilisé pour les requêtes associées à ce
ServiceStats getServiceStats()

Interroge le service pour le ServiceStats.
ServiceStats getServiceStats(TableRequestOptions options, OperationContext opContext)

Interroge le service de stockage donné pour .ServiceStats
CloudTable getTableReference(final String tableName)

Obtient un CloudTable objet avec le nom spécifié.
final StorageUri getTransformedEndPoint(final OperationContext opContext)
boolean isUsePathStyleUris()

Indique si des URI de style chemin d’accès sont utilisés.
Iterable<String> listTables()

Répertorie les noms de table dans le compte de stockage.

Cette méthode appelle l’API REST Tables de requête pour répertorier les noms des tables, à l’aide du point de terminaison du service de table et des informations d’identification du compte de stockage de cette instance.
Iterable<String> listTables(final String prefix)

Répertorie les noms de table dans le compte de stockage qui correspondent au préfixe spécifié.

Cette méthode appelle l’API REST Tables de requête pour répertorier les noms de tables qui correspondent au préfixe, en utilisant le point de terminaison du service table et les informations d’identification du compte de stockage de ce instance.
Iterable<String> listTables(final String prefix, final TableRequestOptions options, final OperationContext opContext)

Répertorie les noms de table dans le compte de stockage qui correspondent au préfixe spécifié, à l’aide des et spécifiés TableRequestOptionsOperationContext.

Cette méthode appelle l’API REST Tables de requête pour répertorier les noms de tables qui correspondent au préfixe, en utilisant le point de terminaison du service table et les informations d’identification du compte de stockage de ce instance.

Utilisez pour remplacer les TableRequestOptions options d’exécution telles que le délai d’expiration ou la stratégie de nouvelle tentative pour l’opération.
ResultSegment<String> listTablesSegmented()

Répertorie les noms de table dans le compte de stockage en mode segmenté. Cette méthode permet de reprendre la liste des tables après avoir retourné un ensemble partiel de résultats, à l’aide des informations retournées par le serveur dans l’objet ResultSegment<T> .

Cette méthode appelle l’API REST Tables de requête pour répertorier les noms des tables, à l’aide du point de terminaison du service de table et des informations d’identification du compte de stockage de cette instance.
ResultSegment<String> listTablesSegmented(final String prefix)

Répertorie les noms de table dans le compte de stockage qui correspondent au préfixe spécifié en mode segmenté. Cette méthode permet de reprendre la liste des tables après avoir retourné un ensemble partiel de résultats, à l’aide des informations retournées par le serveur dans l’objet ResultSegment<T> .

Cette méthode appelle l’API REST Tables de requête pour répertorier les noms de tables qui correspondent au préfixe, en utilisant le point de terminaison du service table et les informations d’identification du compte de stockage de ce instance.
ResultSegment<String> listTablesSegmented(final String prefix, final Integer maxResults, final ResultContinuation continuationToken, final TableRequestOptions options, final OperationContext opContext)

Répertorie jusqu’au maximum spécifié des noms de table dans le compte de stockage qui correspondent au préfixe spécifié dans un mode pouvant être repris avec le jeton de continuation spécifié ResultContinuation , à l’aide des et spécifiés TableRequestOptionsOperationContext. Cette méthode permet de reprendre la liste des tables après avoir retourné une page de résultats, à l’aide des informations retournées par le serveur dans l’objet ResultSegment<T> .

Cette méthode appelle l’API REST Tables de requête pour répertorier les noms de tables qui correspondent au préfixe, en utilisant le point de terminaison du service table et les informations d’identification du compte de stockage de ce instance.

Utilisez pour remplacer les TableRequestOptions options d’exécution telles que le délai d’expiration ou la stratégie de nouvelle tentative pour l’opération.
void setDefaultRequestOptions(TableRequestOptions defaultRequestOptions)

Définit le TableRequestOptions qui est utilisé pour toute table accessible avec cet objet.
void uploadServiceProperties(final ServiceProperties properties)

Charge une nouvelle ServiceProperties configuration sur le service de stockage donné. Cela inclut les configurations Logging, HourMetrics, MinuteMetrics et CORS.
void uploadServiceProperties(final ServiceProperties properties, TableRequestOptions options, OperationContext opContext)

Charge une nouvelle ServiceProperties configuration sur le service de stockage donné. Cela inclut les configurations Logging, HourMetrics, MinuteMetrics et CORS.

Membres hérités

ServiceClient.credentials ServiceClient.downloadServicePropertiesImpl(final RequestOptions options, final boolean signAsTable) ServiceClient.getCredentials() ServiceClient.getEndpoint() ServiceClient.getServiceStatsImpl(final RequestOptions options, final boolean signAsTable) ServiceClient.getStorageUri() ServiceClient.ServiceClient(final StorageUri storageUri, final StorageCredentials credentials) ServiceClient.setCredentials(final StorageCredentials credentials) ServiceClient.setStorageUri(final StorageUri storageUri) ServiceClient.uploadServicePropertiesImpl(final ServiceProperties properties, final RequestOptions options, final OperationContext opContext, final boolean signAsTable)

Détails du constructeur

CloudTableClient

public CloudTableClient(final StorageUri baseUri, StorageCredentials credentials)

Initialise un instance de la classe à l’aide d’un point de terminaison de service Table et des informations d’identification de compte de stockage.

Parameters:

baseUri - Objet StorageUri qui représente le point de terminaison du service Table utilisé pour initialiser le client.
credentials - Objet StorageCredentials qui représente les informations d’identification du compte de stockage pour l’accès.

CloudTableClient

public CloudTableClient(final URI baseUri, StorageCredentials credentials)

Initialise un instance de la classe à l’aide d’un point de terminaison de service Table et des informations d’identification de compte de stockage.

Parameters:

baseUri - Objet java.net.URI qui représente le point de terminaison du service Table utilisé pour initialiser le client.
credentials - Objet StorageCredentials qui représente les informations d’identification du compte de stockage pour l’accès.

Détails de la méthode

downloadServiceProperties

public final ServiceProperties downloadServiceProperties()

Récupère le actuel ServiceProperties pour le service de stockage donné. Cela inclut les configurations Logging, HourMetrics, MinuteMetrics et CORS.

Returns:

objet ServiceProperties représentant la configuration actuelle du service.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

downloadServiceProperties

public final ServiceProperties downloadServiceProperties(TableRequestOptions options, OperationContext opContext)

Récupère le actuel ServiceProperties pour le service de stockage donné. Cela inclut les configurations Logging, HourMetrics, MinuteMetrics et CORS.

Parameters:

options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

objet ServiceProperties représentant la configuration actuelle du service.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

executeQuerySegmentedImpl

protected ResultSegment executeQuerySegmentedImpl(final TableQuery queryToExecute, final EntityResolver resolver, final ResultContinuation continuationToken, TableRequestOptions options, OperationContext opContext)

Réservé à un usage interne. Exécute une opération de requête segmentée à l’aide des stratégies de nouvelle tentative et de délai d’expiration spécifiées.

Parameters:

queryToExecute - TableQuery<T> à exécuter.
resolver - Instance EntityResolver<T> qui crée une projection des entités de résultats de requête de table dans le type R spécifié. null Passez pour retourner les résultats en tant que type d’entité de table.
continuationToken - ResultContinuation à passer avec l’opération pour reprendre une requête, le cas échéant. null Passer pour une requête initiale.
options - Objet TableRequestOptions qui spécifie des options d’exécution telles que la stratégie de nouvelle tentative et les paramètres de délai d’expiration pour l’opération. Spécifiez null pour utiliser les options de requête spécifiées sur le CloudTableClient.
opContext - Objet OperationContext de suivi de l'opération en cours. Spécifiez null pour ignorer en toute sécurité le contexte d’opération.

Returns:

ResultSegment<T> contenant une collection des résultats de la requête spécialisée pour le TableEntity type ou EntityResolver<T> retourné par la requête.

Throws:

StorageException - si une erreur de service de stockage se produit.

generateIteratorForQuery

protected Iterable generateIteratorForQuery(final TableQuery queryRef, final EntityResolver resolver, TableRequestOptions options, OperationContext opContext)

Réservé à un usage interne. Génère un itérateur pour une opération de requête segmentée.

Parameters:

queryRef - TableQuery<T> à exécuter.
resolver - Instance EntityResolver<T> qui crée une projection des entités de résultats de requête de table dans le type R spécifié. null Passez pour retourner les résultats en tant que type d’entité de table.
options - Objet TableRequestOptions qui spécifie des options d’exécution telles que la stratégie de nouvelle tentative et les paramètres de délai d’expiration pour l’opération. Spécifiez null pour utiliser les options de requête spécifiées sur le CloudTableClient.
opContext - Objet OperationContext de suivi de l'opération en cours. Spécifiez null pour ignorer en toute sécurité le contexte d’opération.

Returns:

Un instance de Iterable spécialisé pour le TableEntity type ou EntityResolver<T> retourné par la requête.

getDefaultRequestOptions

public TableRequestOptions getDefaultRequestOptions()

Obtient le TableRequestOptions qui est utilisé pour les requêtes associées à ce

Returns:

Objet TableRequestOptions contenant les valeurs utilisées par ce CloudTableClient

getServiceStats

public ServiceStats getServiceStats()

Interroge le service pour le ServiceStats.

Returns:

ServiceStats pour le service de stockage donné

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

getServiceStats

public ServiceStats getServiceStats(TableRequestOptions options, OperationContext opContext)

Interroge le service de stockage donné pour .ServiceStats

Parameters:

options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

ServiceStats pour le service de stockage donné

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

getTableReference

public CloudTable getTableReference(final String tableName)

Obtient un CloudTable objet avec le nom spécifié.

Parameters:

tableName - String qui représente le nom de la table, qui doit respecter les règles de nommage de table. Le nom de la table ne doit pas inclure de caractères séparateurs de chemin (/). Les noms de table ne respectent pas la casse, doivent être uniques au sein d’un compte et doivent comporter entre 3 et 63 caractères. Les noms de table doivent commencer par un ne peut pas commencer par un caractère numérique et ne peuvent contenir que des caractères alphanumériques. Certains noms de table sont réservés, y compris « table ».

Returns:

Référence à un objet CloudTable.

Throws:

URISyntaxException - Si l’URI de ressource construit en fonction de tableName n’est pas valide.
StorageException - Si une erreur de service de stockage s’est produite.

getTransformedEndPoint

protected final StorageUri getTransformedEndPoint(final OperationContext opContext)

Parameters:

opContext

isUsePathStyleUris

protected boolean isUsePathStyleUris()

Indique si des URI de style chemin d’accès sont utilisés.

Returns:

true si des URI de style chemin d’accès sont utilisés ; sinon false, .

listTables

public Iterable listTables()

Répertorie les noms de table dans le compte de stockage.

Cette méthode appelle l’API REST Tables de requête pour répertorier les noms des tables, à l’aide du point de terminaison du service de table et des informations d’identification du compte de stockage de cette instance.

Returns:

Collection Iterable des noms de table dans le compte de stockage récupérés tardivement.

listTables

public Iterable listTables(final String prefix)

Répertorie les noms de table dans le compte de stockage qui correspondent au préfixe spécifié.

Cette méthode appelle l’API REST Tables de requête pour répertorier les noms de tables qui correspondent au préfixe, en utilisant le point de terminaison du service table et les informations d’identification du compte de stockage de ce instance.

Parameters:

prefix - String contenant le préfixe à mettre en correspondance sur les noms de table à retourner.

Returns:

Collection Iterable des noms de table dans le compte de stockage récupérés tardivement qui correspondent au préfixe spécifié.

listTables

public Iterable listTables(final String prefix, final TableRequestOptions options, final OperationContext opContext)

Répertorie les noms de table dans le compte de stockage qui correspondent au préfixe spécifié, à l’aide des et spécifiés TableRequestOptionsOperationContext.

Cette méthode appelle l’API REST Tables de requête pour répertorier les noms de tables qui correspondent au préfixe, en utilisant le point de terminaison du service table et les informations d’identification du compte de stockage de ce instance.

Utilisez pour remplacer les TableRequestOptions options d’exécution telles que le délai d’expiration ou la stratégie de nouvelle tentative pour l’opération.

Parameters:

prefix - String contenant le préfixe à mettre en correspondance sur les noms de table à retourner.
options - Objet TableRequestOptions qui spécifie des options d’exécution telles que la stratégie de nouvelle tentative et les paramètres de délai d’expiration pour l’opération. Spécifiez null pour utiliser les options de requête spécifiées sur le CloudTableClient.
opContext - Objet OperationContext de suivi de l'opération en cours. Spécifiez null pour ignorer en toute sécurité le contexte d’opération.

Returns:

Collection Iterable des noms de table dans le compte de stockage récupérés tardivement qui correspondent au préfixe spécifié.

listTablesSegmented

public ResultSegment listTablesSegmented()

Répertorie les noms de table dans le compte de stockage en mode segmenté. Cette méthode permet de reprendre la liste des tables après avoir retourné un ensemble partiel de résultats, à l’aide des informations retournées par le serveur dans l’objet ResultSegment<T> .

Cette méthode appelle l’API REST Tables de requête pour répertorier les noms des tables, à l’aide du point de terminaison du service de table et des informations d’identification du compte de stockage de cette instance.

Returns:

d’objets ResultSegment<T>String contenant des noms de table dans le compte de stockage.

Throws:

StorageException - si une erreur de service de stockage s’est produite pendant l’opération.

listTablesSegmented

public ResultSegment listTablesSegmented(final String prefix)

Répertorie les noms de table dans le compte de stockage qui correspondent au préfixe spécifié en mode segmenté. Cette méthode permet de reprendre la liste des tables après avoir retourné un ensemble partiel de résultats, à l’aide des informations retournées par le serveur dans l’objet ResultSegment<T> .

Cette méthode appelle l’API REST Tables de requête pour répertorier les noms de tables qui correspondent au préfixe, en utilisant le point de terminaison du service table et les informations d’identification du compte de stockage de ce instance.

Parameters:

prefix - String contenant le préfixe à mettre en correspondance sur les noms de table à retourner.

Returns:

d’objets ResultSegment<T>String contenant des noms de table correspondant au préfixe dans le compte de stockage.

Throws:

StorageException - si une erreur de service de stockage s’est produite pendant l’opération.

listTablesSegmented

public ResultSegment listTablesSegmented(final String prefix, final Integer maxResults, final ResultContinuation continuationToken, final TableRequestOptions options, final OperationContext opContext)

Répertorie jusqu’au maximum spécifié des noms de table dans le compte de stockage qui correspondent au préfixe spécifié dans un mode pouvant être repris avec le jeton de continuation spécifié ResultContinuation , à l’aide des et spécifiés TableRequestOptionsOperationContext. Cette méthode permet de reprendre la liste des tables après avoir retourné une page de résultats, à l’aide des informations retournées par le serveur dans l’objet ResultSegment<T> .

Cette méthode appelle l’API REST Tables de requête pour répertorier les noms de tables qui correspondent au préfixe, en utilisant le point de terminaison du service table et les informations d’identification du compte de stockage de ce instance.

Utilisez pour remplacer les TableRequestOptions options d’exécution telles que le délai d’expiration ou la stratégie de nouvelle tentative pour l’opération.

Parameters:

prefix - String contenant le préfixe à mettre en correspondance sur les noms de table à retourner.
maxResults - Nombre maximal de noms de table à retourner dans .ResultSegment<T> Si ce paramètre a la valeur Null, la requête répertorie jusqu’à 1 000 résultats maximum.
continuationToken - Objet ResultContinuation représentant un jeton de liaison à partir du serveur quand l'opération retourne un résultat partiel. Spécifiez null lors de l’appel initial. Appelez la getContinuationToken() méthode sur le résultat pour obtenir l’objet ResultContinuation à utiliser dans l’appel suivant pour reprendre la requête.
options - Objet TableRequestOptions qui spécifie des options d’exécution telles que la stratégie de nouvelle tentative et les paramètres de délai d’expiration pour l’opération. Spécifiez null pour utiliser les options de requête spécifiées sur le CloudTableClient.
opContext - Objet OperationContext de suivi de l'opération en cours. Spécifiez null pour ignorer en toute sécurité le contexte d’opération.

Returns:

d’objets ResultSegment<T>String contenant des noms de table dans le compte de stockage.

Throws:

StorageException - si une erreur de service de stockage s’est produite pendant l’opération.

setDefaultRequestOptions

public void setDefaultRequestOptions(TableRequestOptions defaultRequestOptions)

Définit le TableRequestOptions qui est utilisé pour toute table accessible avec cet objet.

Parameters:

defaultRequestOptions - TableRequestOptions à utiliser.

uploadServiceProperties

public void uploadServiceProperties(final ServiceProperties properties)

Charge une nouvelle ServiceProperties configuration sur le service de stockage donné. Cela inclut les configurations Logging, HourMetrics, MinuteMetrics et CORS.

Parameters:

properties - ServiceProperties à charger.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

uploadServiceProperties

public void uploadServiceProperties(final ServiceProperties properties, TableRequestOptions options, OperationContext opContext)

Charge une nouvelle ServiceProperties configuration sur le service de stockage donné. Cela inclut les configurations Logging, HourMetrics, MinuteMetrics et CORS.

Parameters:

properties - ServiceProperties à charger.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

S’applique à