Tables de requêteQuery Tables

L'opération Query Tables envoie la liste des tables sous le compte spécifié.The Query Tables operation returns a list of tables under the specified account.

RequêteRequest

La demande Query Tables peut être construite comme indiqué ci-dessous.The Query Tables request may be constructed as follows. HTTPS est recommandé.HTTPS is recommended. Remplacez moncompte par le nom de votre compte de stockage :Replace myaccount with the name of your storage account:

MéthodeMethod URI de demandeRequest URI Version HTTPHTTP Version
GET https://myaccount.table.core.windows.net/Tables HTTP/1.1HTTP/1.1

URI du service de stockage émuléEmulated Storage Service URI

Lorsque vous élaborez une demande pour le service de stockage émulé, spécifiez le nom d'hôte de l'émulateur et le port de service de Table sous la forme 127.0.0.1:10002, suivi du nom de compte de stockage émulé :When making a request against the emulated storage service, specify the emulator hostname and Table service port as 127.0.0.1:10002, followed by the emulated storage account name:

MéthodeMethod URI de demandeRequest URI Version HTTPHTTP Version
GET http://127.0.0.1:10002/devstoreaccount1/Tables HTTP/1.1HTTP/1.1

Le service de Table dans le service de stockage émulé et le service de Table de Windows® Azure™ diffèrent sur plusieurs points.The Table service in the emulated storage service differs from the Windows® Azure™ Table service in several ways. Pour plus d’informations, consultez différences entre l’émulateur de stockage et les services de stockage Azure.For more information, see Differences Between the Storage Emulator and Azure Storage Services.

Paramètres URIURI Parameters

L'opération Query Tables prend en charge les options de requête définies par la Spécification du protocole OData.The Query Tables operation supports the query options defined by the OData Protocol Specification. Pour plus d’informations, consultez protocole OData.For more information, see OData Protocol.

En-têtes de requêteRequest Headers

Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.The following table describes required and optional request headers.

En-tête de requêteRequest header DescriptionDescription
Authorization Obligatoire.Required. Spécifie le schéma d’autorisation, le nom de compte et la signature.Specifies the authorization scheme, account name, and signature. Pour plus d’informations, consultez autoriser les demandes dans le stockage Azure.For more information, see Authorize requests to Azure Storage.
Date ou x-ms-dateDate or x-ms-date Obligatoire.Required. Spécifie la date/heure en temps universel coordonné (UTC) pour la requête.Specifies the Coordinated Universal Time (UTC) for the request. Pour plus d’informations, consultez autoriser les demandes dans le stockage Azure.For more information, see Authorize requests to Azure Storage.
x-ms-version facultatif.Optional. Spécifie la version de l'opération à utiliser pour cette demande.Specifies the version of the operation to use for this request. Pour plus d’informations, consultez contrôle de version pour les services de stockage Azure.For more information, see Versioning for the Azure Storage Services.
Accept facultatif.Optional. Spécifie le type de contenu accepté de la charge utile de réponse.Specifies the accepted content type of the response payload. Les valeurs possibles sont les suivantes :Possible values are:

- application/atom+xml(versions antérieures à 2015-12-11 uniquement)- application/atom+xml (versions prior to 2015-12-11 only)
- 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 service de table.For more information, see Payload Format for Table Service Operations.
x-ms-client-request-id facultatif.Optional. Fournit une valeur opaque générée par le client avec une limite de 1 Kio de caractères qui est enregistrée dans les journaux d’analyse lorsque la journalisation de l’analyse de stockage est activée.Provides a client-generated, opaque value with a 1 KiB character limit that is recorded in the analytics logs when storage analytics logging is enabled. L’utilisation de cet en-tête est fortement recommandée pour la mise en corrélation des activités côté client avec les requêtes reçues par le serveur.Using this header is highly recommended for correlating client-side activities with requests received by the server. Pour plus d’informations, consultez à propos de la journalisation des Storage Analytics et de la journalisation Windows Azure : utilisation des journaux pour suivre les demandes de stockage.For more information, see About Storage Analytics Logging and Windows Azure Logging: Using Logs to Track Storage Requests.

Corps de la demandeRequest Body

Aucun.None.

responseResponse

La réponse inclut un code d'état HTTP, un ensemble d'en-têtes de réponse et un corps de réponse.The response includes an HTTP status code, a set of response headers, and a response body.

Code d’étatStatus Code

Une opération réussie envoie le code d'état 200 (OK).A successful operation returns status code 200 (OK).

Pour plus d’informations sur les codes d’État, consultez codes d’État et d’erreur et codes d’erreur du service de table.For information about status codes, see Status and Error Codes and Table Service Error Codes.

En-têtes de réponseResponse Headers

La réponse de l'opération inclut les en-têtes suivants.The response for this operation includes the following headers. La réponse peut aussi inclure des en-têtes HTTP standard supplémentaires.The response may also include additional standard HTTP headers. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.All standard headers conform to the HTTP/1.1 protocol specification.

En-tête de réponseResponse header DescriptionDescription
x-ms-continuation-NextTableName Si le nombre de tables à renvoyer est supérieur à 1 000 ou que la requête ne se termine pas dans le délai imparti, l'en-tête de réponse comprend l'en-tête de continuation x-ms-continuation-NextTableName.If the number of tables to be returned exceeds 1,000 or the query does not complete within the timeout interval, the response header includes the x-ms-continuation-NextTableName continuation header. Cet en-tête renvoie la valeur de jeton de continuation.This header returns the continuation token value. Pour plus d’informations sur l’utilisation du jeton de continuation, consultez délai de requête et pagination.For more information about using the continuation token, see Query Timeout and Pagination.
x-ms-request-id Cet en-tête identifie de façon unique la demande qui a été effectuée et peut être utilisé pour résoudre les problèmes de la demande.This header uniquely identifies the request that was made and can be used for troubleshooting the request. Pour plus d’informations, consultez Troubleshooting API Operations.For more information, see Troubleshooting API Operations.
x-ms-version Indique la version du service de Table utilisée pour exécuter la demande.Indicates the version of the Table service used to execute the request. Cet en-tête est renvoyé pour les demandes effectuées avec la version 2009-09-19 ou une version ultérieure.This header is returned for requests made against version 2009-09-19 and later.
Date Une valeur de date/heure UTC générée par le service qui indique le moment auquel la réponse a été initiée.A UTC date/time value generated by the service that indicates the time at which the response was initiated.
Content-Type Indique le type de contenu de la charge utile.Indicates the content type of the payload. La valeur dépend de l'en-tête de demande Accept.Value depends on the request Accept header. Les valeurs possibles sont les suivantes :Possible values are:

- 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 service de table.For more formation about valid content types, see Payload Format for Table Service Operations.
x-ms-client-request-id Cet en-tête peut être utilisé pour dépanner les demandes et les réponses correspondantes.This header can be used to troubleshoot requests and corresponding responses. La valeur de cet en-tête est égale à la valeur de l' x-ms-client-request-id en-tête si elle est présente dans la demande et que la valeur est supérieure à 1024 caractères ASCII visibles.The value of this header is equal to the value of the x-ms-client-request-id header if it is present in the request and the value is at most 1024 visible ASCII characters. Si l' x-ms-client-request-id en-tête n’est pas présent dans la demande, cet en-tête ne sera pas présent dans la réponse.If the x-ms-client-request-id header is not present in the request, this header will not be present in the response.

Corps de la réponseResponse Body

L'opération Query Tables renvoie la liste des tables au sein du compte, sous forme de jeu d'entités OData.The Query Tables operation returns the list of tables in the account as an OData entity set. En fonction de la valeur de l' Accept en-tête, le contenu est soit JSON, soit un flux Atom.According to the value of the Accept header, the content is either JSON or an Atom feed.

Notes

JSON est le format de charge utile recommandé, et est le seul format pris en charge pour les versions 2015-12-11 et ultérieures.JSON is the recommended payload format, and is the only format supported for versions 2015-12-11 and later.

JSON (versions 2013-08-15 et ultérieures)JSON (versions 2013-08-15 and later)

Voici un exemple de corps de réponse JSON pour les opérations Query Tables.Here is a sample JSON response body for the Query Tables operations.

Métadonnées complètesFull Metadata

{  
   "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"  
      }  
}  

Métadonnées minimalesMinimal Metadata

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

Aucune métadonnéeNo Metadata

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

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

Voici un exemple de corps de réponse Atom pour l'opération Query Tables.Here is a sample Atom response body for the Query Tables operation.

<?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>   

AutorisationAuthorization

Seul le propriétaire du compte peut appeler cette opération.Only the account owner may call this operation.

RemarquesRemarks

Une requête du service de Table peut renvoyer un maximum de 1 000 tables à la fois et peut s'exécuter pendant cinq secondes au maximum.A query against the Table service may return a maximum of 1,000 tables at one time and may execute for a maximum of five seconds. Si le jeu de résultats contient plus de 1 000 tables, si la requête ne s'est pas terminée dans les cinq secondes ou si la requête dépasse les limites de la partition, la réponse comprend un en-tête personnalisé qui contient le jeton de continuation x-ms-continuation-NextTableName.If the result set contains more than 1,000 tables, if the query did not complete within five seconds, or if the query crosses the partition boundary, the response includes a custom header containing the x-ms-continuation-NextTableName continuation token. Le jeton de continuation peut être utilisé pour construire une demande suivante pour la page de données suivante.The continuation token may be used to construct a subsequent request for the next page of data. Pour plus d’informations sur les jetons de continuation, consultez délai de requête et pagination.For more information about continuation tokens, see Query Timeout and Pagination.

Notes

Lorsque vous effectuez les demandes suivantes qui incluent des jetons de continuation, veillez à transmettre l’URI d’origine à la demande.When making subsequent requests that include continuation tokens, be sure to pass the original URI on the request. Par exemple, si vous avez spécifié une $filter $select option de requête, ou dans $top le cadre de la demande d’origine, vous pouvez inclure cette option sur les demandes suivantes.For example, if you have specified a $filter, $select, or $top query option as part of the original request, you will want to include that option on subsequent requests. Dans le cas contraire, vos demandes suivantes peuvent retourner des résultats inattendus.Otherwise your subsequent requests may return unexpected results.

Notez que $top dans ce cas, l’option de requête spécifie le nombre maximal de résultats par page, et non le nombre maximal de résultats dans l’ensemble de la réponse.Note that the $top query option in this case specifies the maximum number of results per page, not the maximum number of results in the whole response set.

Pour plus d’informations, consultez interrogation des tables et des entités .See Querying Tables and Entities for more details.

Notez que la durée totale allouée à la demande pour planifier et gérer la requête est de 30 secondes, y compris les cinq secondes pour l'exécution de la requête.Note that the total time allotted to the request for scheduling and processing the query is 30 seconds, including the five seconds for query execution.

Pour plus d’informations sur les opérations de requête prises en charge sur le service de table via LINQ, consultez opérateurs de requête pris en charge pour le service de table et écriture de requêtes LINQ sur le service de table.For more information about supported query operations against the Table service through LINQ, see Query Operators Supported for the Table Service and Writing LINQ Queries Against the Table Service.

Voir aussiSee Also

Adressage des ressources du service de table Addressing Table Service Resources
Autoriser les demandes au stockage Azure Authorize requests to Azure Storage
Définition des en-têtes de version du service de données OData Setting the OData Data Service Version Headers
Codes d’État et d’erreur Status and Error Codes
Codes d’erreur du service de tableTable Service Error Codes