Créer une table

  • Article

L’opération Create Table crée une table dans un compte de stockage.

Requête

Vous pouvez construire la Create Table requête comme indiqué ici. Nous vous recommandons d’utiliser HTTPS. Remplacez moncompte par le nom de votre compte de stockage :

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

Demande de service de stockage émulée

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 de stockage Table Azure en tant que 127.0.0.1:10002, suivis du nom du compte de stockage émulé :

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

Le service Table dans l’émulateur de stockage diffère du service Stockage Table 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

Aucun.

En-têtes de requête

Les en-têtes de requête obligatoires et facultatifs sont décrits dans le tableau suivant :

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.
Content-Type Obligatoire. Spécifie le type de contenu de la charge utile. Les valeurs possibles sont les suivantes :

- application/atom+xml (versions antérieures à 2015-12-11 uniquement)
- application/json

Pour plus d’informations, consultez Format de charge utile pour les opérations de stockage table.
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 service de table.
Prefer Optionnel. Indique si la réponse doit inclure l'entité insérée dans la charge utile. Les valeurs possibles sont return-no-content et return-content.

Pour plus d’informations sur cet en-tête, consultez Définir l’en-tête pour gérer l’écho Prefer de réponse lors des opérations d’insertion.
Content-Length Obligatoire. Longueur du corps de la demande.
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. Pour plus d’informations, consultez Surveiller le Stockage Table Azure.

Corps de la demande

Le corps de la demande spécifie le nom de la table à créer. Les noms de table doivent être conformes aux restrictions d’affectation de noms décrites dans Comprendre le modèle de données stockage table.

Le corps de la requête est un jeu d’entités OData, qui peut être exprimé au format JSON ou en tant que flux Atom.

Notes

JSON est le format de charge utile recommandé, et il s’agit du seul format pris en charge pour la version 2015-12-11 et les versions ultérieures.

Pour obtenir des conseils sur les noms de table valides, consultez la section « Noms de table » dans Comprendre le modèle de données stockage table.

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

Le corps de la demande en tant que flux JSON est au format général suivant :

{   
    "TableName":"mytable"  
}

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

Le corps de la demande en tant que flux Atom est au format général suivant :

<?xml version="1.0" encoding="utf-8" standalone="yes"?>     
  <entry xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices"   
    xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata"  
    xmlns="https://www.w3.org/2005/Atom">   
    <title />   
    <updated>2009-03-18T11:48:34.9840639-07:00</updated>   
    <author>  
      <name/>   
    </author>   
      <id/>   
      <content type="application/xml">  
        <m:properties>  
          <d:TableName>mytable</d:TableName>  
        </m:properties>  
      </content>   
    </entry>

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

Le code d'état dépend de la valeur de l'en-tête Prefer. Si l’en-tête Prefer est défini sur return-no-content, une opération réussie retourne status code 204 (No Content). Si l’en-tête Prefer n’est pas spécifié ou s’il est défini sur return-content, une opération réussie retourne status code 201 (Created). Pour plus d’informations, consultez Définir l’en-tête pour gérer l’écho Prefer de réponse lors des opérations d’insertion.

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 à cette opération inclut les en-têtes décrits dans le tableau suivant. 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-request-id Identifie de manière unique la demande qui a été effectuée et vous pouvez l’utiliser pour résoudre 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 qui a été utilisée pour exécuter la demande. Cet en-tête est retourné pour les demandes effectuées sur la version 2009-09-19 et ultérieure.
Date Valeur de date/heure UTC générée par le service, qui indique l’heure à laquelle la réponse a été lancée.
Preference-Applied Indique si l'en-tête de demande Prefer a été respecté. Si la réponse n’inclut pas cet en-tête, l’en-tête Prefer n’a pas été respecté. Si l’en-tête est retourné, sa valeur est ou return-contentreturn-no-content.

Pour plus d’informations, consultez Définir l’en-tête pour gérer l’écho Prefer de réponse lors des opérations d’insertion.
Content-Type Indique le type de contenu de la charge utile. La valeur dépend de la valeur spécifiée pour l’en-tête de 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, 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 s’il est présent dans la requête et que la valeur ne contient pas plus de 1 024 caractères ASCII visibles. Si l’en-tête x-ms-client-request-id n’est pas présent, il n’est pas présent dans la réponse.

Response body

Si la demande inclut l'en-tête Prefer avec la valeur return-no-content, aucun corps de réponse n'est renvoyé. Sinon, le corps de la réponse est un jeu d'entités OData.

Notes

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

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

Voici les charges utiles de réponse dans JSON pour différents niveaux de contrôle.

Métadonnées complètes

{  
  
    "odata.metadata":"https://myaccount.table.core.windows.net/$metadata#Tables/@Element",  
  
    "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/@Element",  
  
    "TableName":"mytable"  
  
}

Aucune métadonnées

{  
  
    "TableName":"mytable"  
  
}

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

Voici un exemple de réponse Atom pour l’opération Create Table .

<?xml version="1.0" encoding="utf-8" standalone="yes"?>  
<entry 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="https://www.w3.org/2005/Atom"> <id>https://myaccount.table.core.windows.net/Tables('mytable')</id>  
  <title type="text"></title>  
  <updated>2013-10-24T17: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>

Autorisation

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

Notes

Aucun.

Voir aussi

Autoriser les demandes dans le 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