Tables de requête

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.

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é.

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 :

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.

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.

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.

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