Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout

Interrogation de tables

Mis à jour: avril 2015

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

La demande Query Tables peut être construite comme indiqué ci-dessous. HTTPS est recommandé. Remplacez moncompte 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

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

 

Méthode URI de demande Version HTTP

GET

http://127.0.0.1:10002/devstoreaccount1/Tables

HTTP/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. Pour plus d'informations, consultez Differences between Development Storage and Cloud Storage Services.

L'opération Query Tables prend en charge les options de requête définies par la Spécification du protocole OData. Pour plus d'informations, consultez Protocole OData.

Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.

 

En-tête de demande Description

Authorization

Obligatoire. Spécifie le schéma d'authentification, le nom du compte et la signature. Pour plus d'informations, consultez Authentification pour les services Azure Storage.

Date ou x-ms-date

Obligatoire. Spécifie le temps universel coordonné (UTC) pour la demande. Pour plus d'informations, consultez Authentification pour les services Azure Storage.

x-ms-version

Facultatif. Spécifie la version de l'opération à utiliser pour cette demande. Pour plus d'informations, consultez Contrôle de version des services BLOB, de File d'attente et de Table dans Windows Azure.

Accept

Facultatif. Spécifie le type de contenu accepté de la charge utile de réponse. 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, consultez Format de charge utile pour les opérations du service Table.

x-ms-client-request-id

Facultatif. Fournit une valeur opaque générée par le client avec une limite de caractère de 1 Ko qui est enregistrée dans les journaux d'analyse quand la journalisation de l'analyse de stockage est activée. L'utilisation de cet en-tête est recommandée pour la corrélation des activités côté client avec les requêtes reçues par le serveur. Pour plus d'informations, consultez À propos de la journalisation Storage Analytics et Journalisation du stockage Windows Azure : utilisation des journaux pour suivre les demandes de stockage.

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

Une opération ayant réussi renvoie le code d'état 200 (OK).

Pour plus d'informations sur les codes d'état, consultez Codes d'état et d'erreur et Codes d'erreur de service de Table.

La réponse de l'opération inclut les en-têtes suivants. La réponse peut aussi 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

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. Cet en-tête renvoie la valeur de jeton de continuation. Pour plus d'informations sur l'utilisation du jeton de continuation, consultez Délai d'expiration de requête et 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. Pour plus d'informations, consultez Dépannage des opérations de l'API.

x-ms-version

Indique la version du service de Table utilisée pour exécuter la demande. Cet en-tête est renvoyé pour les demandes effectuées avec la version 2009-09-19 ou une version ultérieure.

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.

Content-Type

Indique le type de contenu de la charge utile. La valeur dépend de l'en-tête de demande Accept. 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 du service Table.

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 un flux Atom ou JSON.

Flux Atom

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> 

JSON

Voici un exemple de corps de réponse JSON pour les opérations Query Tables.

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

Métadonnées minimales

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

Aucune métadonnée

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

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

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. 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. Le jeton de continuation peut être utilisé pour construire une demande suivante pour la page de données suivante. Pour plus d'informations sur les jetons de continuation, consultez Délai d'expiration de requête et pagination.

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.

Pour plus d'informations sur les opérations de requête prises en charge pour le service de Table via LINQ, consultez Opérateurs de requête (prise en charge du service de Table) etÉcriture de requêtes LINQ sur le service de Table.

Afficher:
© 2015 Microsoft