Exporter (0) Imprimer
Développer tout

Create Table

Mis à jour: février 2015

L'opération Create Table crée une nouvelle table dans le compte de stockage.

La demande Create Table 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

POST

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

POST

http://127.0.0.1:10002/devstoreaccount1/Tables

HTTP/1.1

Le service de Table dans l'émulateur de stockage et le service de Table de Windows® Azure™ diffèrent sur plusieurs points. Pour plus d'informations, consultez Différences entre l'émulateur de stockage et les services de stockage Azure.

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 de stockage Azure.

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 de stockage Azure.

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.

Content-Type

Obligatoire. Spécifie le type de contenu de la charge utile. Les valeurs possibles sont les suivantes :

  • application/atom+xml

  • application/json

Pour plus d'informations, consultez Format de charge utile pour les opérations du service Table.

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.

Prefer

Facultatif. 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 Affectation de la valeur Manage Response Echo à l'en-tête Prefer sur les opérations d'insertion.

Content-Length

Obligatoire. Longueur du corps de la demande.

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 demandes reçues par le serveur. Pour plus d'informations, consultez À propos de la journalisation Storage Analytics et Journalisation du stockage Azure : utilisation des journaux pour suivre les demandes de stockage.

Le corps de la demande spécifie le nom de la table à créer. Notez que les noms de table doivent respecter les restrictions d'attribution de noms décrites dans Présentation du modèle de données du service de Table.

Le corps de la demande est un jeu d'entités OData, qui peut être exprimé sous forme de flux Atom ou JSON.

Atom

Le corps de la demande sous forme de flux Atom a le format standard 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="http://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>

JSON

Le corps de la demande sous forme de flux JSON a le format standard suivant.

{ 
    "TableName":"mytable"
}

Pour obtenir de l'aide sur les noms de table valides, consultez la section Noms de table dans Présentation du modèle de données du service de Table.

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

Le code d'état dépend de la valeur de l'en-tête Prefer. Si l'en-tête Prefer a la valeur return-no-content, une opération réussie renvoie le code d'état 204 (No Content). Si l'en-tête Prefer n'est pas spécifié ou a la valeur return-content, une opération réussie renvoie le code d'état 201 (Created). Pour plus d'informations, consultez Affectation de la valeur Manage Response Echo à l'en-tête Prefer sur les opérations d'insertion.

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

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 cet en-tête est renvoyé, sa valeur est return-content ou return-no-content.

Pour plus d'informations, consultez Affectation de la valeur Manage Response Echo à l'en-tête Prefer sur les opérations d'insertion.

Content-Type

Indique le type de contenu de la charge utile. La valeur de cet en-tête dépend de la valeur spécifiée pour 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, consultez Format de charge utile pour les opérations du service Table.

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.

Atom

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="http://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>

JSON

Voici les charges utiles de réponse dans un flux 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ée

{

    "TableName":"mytable"

}

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

Aucun.

Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2015 Microsoft