Tables de requête

  • Article

L'opération Query Tables envoie la liste des tables sous le compte spécifié.

Requête

Vous pouvez construire la Query Tables requête comme suit. Nous recommandons HTTPS. Remplacez myaccount par le nom de votre compte de stockage.

Méthode URI de demande Version HTTP
GET https://myaccount.table.core.windows.net/Tables HTTP/1.1

URI du service de stockage émulé

Lorsque vous effectuez une demande auprès du service de stockage émulé, spécifiez le nom d’hôte de l’émulateur et le port du service de table comme 127.0.0.1:10002. Suivez ces informations avec le nom du compte de stockage émulé.

Méthode URI de demande Version HTTP
GET http://127.0.0.1:10002/devstoreaccount1/Tables HTTP/1.1

Le service Table dans l’émulateur de stockage diffère de Stockage Table Azure de plusieurs façons. Pour plus d’informations, consultez Différences entre l’émulateur de stockage et les services de stockage Azure.

Paramètres URI

L’opération Query Tables prend en charge les options de requête que la spécification du protocole OData définit.

En-têtes de requête

Le tableau suivant décrit les en-têtes de requête obligatoires et facultatifs :

En-tête de requête Description
Authorization Obligatoire. Spécifie le schéma d’autorisation, le nom du compte et la signature. Pour plus d’informations, consultez Autoriser les requêtes auprès du Stockage Azure.
Date ou x-ms-date Obligatoire. Spécifie la date/heure en temps universel coordonné (UTC) pour la requête. Pour plus d’informations, consultez Autoriser les requêtes auprès du Stockage Azure.
x-ms-version Optionnel. Spécifie la version de l'opération à utiliser pour cette demande. Pour plus d'informations, consultez la page Contrôle de version pour les services de Stockage Microsoft Azure.
Accept Optionnel. Spécifie le type de contenu accepté de la charge utile de réponse. Les valeurs possibles sont les suivantes :

- application/atom+xml (versions antérieures à 2015-12-11 uniquement)
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Pour plus d’informations, consultez Format de charge utile pour les opérations de stockage table.
x-ms-client-request-id Optionnel. Fournit une valeur opaque générée par le client avec une limite de caractères de 1 kibioctet (Kio) enregistrée dans les journaux lors de la configuration de la journalisation. Nous vous recommandons vivement d’utiliser cet en-tête pour mettre en corrélation les activités côté client avec les demandes que le serveur reçoit.

Corps de la demande

Aucun.

response

La réponse inclut un code d'état HTTP, un ensemble d'en-têtes de réponse et un corps de réponse.

Code d’état

Une opération réussie envoie le code d'état 200 (OK).

Pour plus d’informations sur les codes status, consultez Codes d’état et d’erreur et Codes d’erreur de stockage table.

En-têtes de réponse

La réponse de l'opération inclut les en-têtes suivants. La réponse peut également inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.

En-tête de réponse Description
x-ms-continuation-NextTableName Retourne la valeur du jeton de continuation. Si le nombre de tables à retourner dépasse 1 000 ou si la requête ne se termine pas dans l’intervalle de délai d’expiration, l’en-tête de réponse inclut l’en-tête x-ms-continuation-NextTableName de continuation. Pour plus d’informations sur l’utilisation du jeton de continuation, consultez Délai d’expiration et pagination des requêtes.
x-ms-request-id Identifie de manière unique la demande qui a été effectuée. Vous pouvez l’utiliser pour résoudre les problèmes liés à la demande. Pour plus d’informations, consultez Résoudre les problèmes liés aux opérations d’API.
x-ms-version Indique la version de Stockage Table utilisée pour exécuter la requête. Cet en-tête est renvoyé pour les demandes effectuées avec la version 2009-09-19 ou une version ultérieure.
Date Valeur de date/heure UTC qui indique l’heure à laquelle le service a envoyé la réponse.
Content-Type Indique le type de contenu de la charge utile. La valeur dépend de l’en-tête de la Accept requête. Les valeurs possibles sont les suivantes :

- application/atom+xml
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Pour plus d’informations sur les types de contenu valides, consultez Format de charge utile pour les opérations de stockage table.
x-ms-client-request-id Peut être utilisé pour résoudre les problèmes liés aux demandes et aux réponses correspondantes. La valeur de cet en-tête est égale à la valeur de l’en-tête x-ms-client-request-id , si elle est présente dans la requête et que la valeur est au maximum de 1 024 caractères ASCII visibles. Si l’en-tête x-ms-client-request-id n’est pas présent dans la demande, cet en-tête ne sera pas présent dans la réponse.

Response body

L'opération Query Tables renvoie la liste des tables au sein du compte, sous forme de jeu d'entités OData. Selon la valeur de l’en-tête Accept , le contenu est JSON ou un flux Atom.

Notes

Nous recommandons JSON comme format de charge utile. Il s’agit du seul format pris en charge pour la version 2015-12-11 et ultérieure.

JSON (version 2013-08-15 et ultérieures)

Voici un exemple de corps de réponse JSON pour une Query Tables opération avec des métadonnées complètes :

{  
   "odata.metadata":"https://myaccount.table.core.windows.net/$metadata#Tables",  
   "value":[  
      {  
         "odata.type":"myaccount.Tables",  
         "odata.id":"https://myaccount.table.core.windows.net/Tables('mytable')",  
         "odata.editLink":"Tables('mytable')",  
         "TableName":"mytable"  
      }  
}

Voici un exemple de corps de réponse JSON pour une Query Tables opération avec des métadonnées minimales :

{  
    "odata.metadata":"https://myaccount.table.core.windows.net/$metadata#Tables",  
    "value":[{  
        "TableName":"mytable"  
    }]  
}

Voici un exemple de corps de réponse JSON pour une Query Tables opération sans métadonnées :

{  
   "value":[{  
       "TableName":"mytable"  
   },  
}

Flux Atom (versions antérieures à 2015-12-11)

Voici un exemple de corps de réponse Atom pour l’opération Query Tables :

<?xml version="1.0" encoding="utf-8" standalone="yes"?>  
<feed xml:base="https://myaccount.table.core.windows.net/" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom">  
  <title type="text">Tables</title>  
  <id>https://myaccount.table.core.windows.net/Tables</id>  
  <updated>2009-01-04T17:18:54.7062347Z</updated>  
  <link rel="self" title="Tables" href="Tables" />  
  <entry>  
    <id>https://myaccount.table.core.windows.net/Tables('mytable')</id>  
    <title type="text"></title>  
    <updated>2009-01-04T17:18:54.7062347Z</updated>  
    <author>  
      <name />  
    </author>  
    <link rel="edit" title="Tables" href="Tables('mytable')" />  
    <category term="myaccount.Tables" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />  
    <content type="application/xml">  
      <m:properties>  
        <d:TableName>mytable</d:TableName>  
      </m:properties>  
    </content>  
  </entry>  
</feed>

Autorisation

Seul le propriétaire du compte peut appeler cette opération.

Notes

Une requête sur le stockage table peut retourner un maximum de 1 000 tables à la fois et s’exécuter pendant un maximum de cinq secondes. La réponse inclut un en-tête personnalisé qui contient le x-ms-continuation-NextTableName jeton de continuation dans l’un des cas suivants :

  • Le jeu de résultats contient plus de 1 000 tables.
  • La requête ne s’est pas terminée dans les cinq secondes.
  • La requête franchit les limites de la partition.

Vous pouvez utiliser la continuation pour construire une requête suivante pour la page de données suivante. Pour plus d’informations sur les jetons de continuation, consultez Délai d’expiration et pagination des requêtes.

Notes

Lorsque vous effectuez des requêtes suivantes qui incluent des jetons de continuation, veillez à passer l’URI d’origine sur la demande. Par exemple, si vous avez spécifié une $filteroption de requête , $selectou $top dans le cadre de la demande d’origine, incluez cette option sur les requêtes suivantes. Dans le cas contraire, vos demandes suivantes peuvent retourner des résultats inattendus.

L’option $top de requête dans ce cas spécifie le nombre maximal de résultats par page. Il ne spécifie pas le nombre maximal de résultats dans l’ensemble du jeu de réponses.

Pour plus d’informations, consultez Interroger des tables et des entités.

Le temps total alloué à la demande pour la planification et le traitement de la requête est de 30 secondes. Ce total inclut les cinq secondes pour l’exécution de la requête.

Pour plus d’informations sur les opérations de requête prises en charge sur le stockage Table via LINQ, consultez Opérateurs de requête pris en charge pour le stockage Table et Écrire des requêtes LINQ sur le stockage Table.

Voir aussi

Ressources de stockage de table d’adressage
Autoriser les demandes à Stockage Azure
Définir les en-têtes de version du service de données OData
Codes d’état et d’erreur
Codes d’erreur stockage table