Erstellen einer Tabelle

Der Create Table Vorgang erstellt eine neue Tabelle in einem Speicherkonto.

Anforderung

Sie können die Create Table Anforderung wie hier gezeigt erstellen. Es wird empfohlen, HTTPS zu verwenden. Ersetzen Sie myaccount durch den Namen Ihres Speicherkontos:

Emulierte Speicherdienstanforderung

Wenn Sie eine Anforderung an den emulierten Speicherdienst stellen, geben Sie den Emulatorhostnamen und den Azure Table Storage-Port als 127.0.0.1:10002an, gefolgt vom emulierten Speicherkontonamen:

Der Tabellendienst im Speicheremulator unterscheidet sich in verschiedener Hinsicht vom Tabellenspeicherdienst. Weitere Informationen finden Sie unter Unterschiede zwischen dem Speicheremulator und den Azure Storage-Diensten.

URI-Parameter

Keine.

Anforderungsheader

Die erforderlichen und optionalen Anforderungsheader werden in der folgenden Tabelle beschrieben:

Anforderungstext

Im Anforderungstext ist der Name der zu erstellenden Tabelle angegeben. Tabellennamen müssen den Benennungseinschränkungen entsprechen, die unter Grundlegendes zum Table Storage-Datenmodell beschrieben werden.

Der Anforderungstext ist ein OData-Entitätssatz, der als JSON oder als Atom-Feed ausgedrückt werden kann.

Eine Anleitung zu gültigen Tabellennamen finden Sie im Abschnitt "Tabellennamen" unter Grundlegendes zum Table Storage-Datenmodell.

JSON (Version 2013-08-15 und höher)

Der Anforderungstext als JSON-Feed hat das folgende allgemeine Format:

{   
    "TableName":"mytable"  
}  

Atom-Feed (Versionen vor 2015-12-11)

Der Anforderungstext als Atom-Feed hat das folgende allgemeine Format:

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

Antwort

Die Antwort enthält den HTTP-Statuscode, einen Satz von Antwortheadern und einen Antworttext.

Statuscode

Der Statuscode hängt vom Wert des Prefer-Headers ab. Wenn der Prefer Header auf return-no-contentfestgelegt ist, gibt ein erfolgreicher Vorgang status Code 204 (No Content) zurück. Wenn der Prefer Header nicht angegeben ist oder auf return-contentfestgelegt ist, gibt ein erfolgreicher Vorgang status Code 201 (Created) zurück. Weitere Informationen finden Sie unter Festlegen des Headers zum Verwalten des Prefer Antwortechos bei Einfügevorgängen.

Informationen zu status-Codes finden Sie unter Status- und Fehlercodes und Tabellenspeicherfehlercodes.

Antwortheader

Die Antwort für diesen Vorgang enthält die Header, die in der folgenden Tabelle beschrieben werden. Die Antwort kann auch zusätzliche HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

Antworttext

Wenn die Anforderung den Prefer-Header mit dem Wert return-no-content einschließt, wird kein Antworttext zurückgegeben. Andernfalls entspricht der Antworttext einer OData-Entitätenmenge.

JSON (Version 2013-08-15 und höher)

Hier finden Sie die Antwortnutzlasten in JSON für verschiedene Steuerungsebenen.

Vollständige Metadaten

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

Minimale Metadaten

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

Keine Metadaten

{  
  
    "TableName":"mytable"  
  
}  
  

Atomfeed (Versionen früher als 2015-12-11)

Hier sehen Sie eine Atom-Beispielantwort für den Create Table Vorgang.

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

Authorization

Dieser Vorgang kann nur vom Kontobesitzer aufgerufen werden.

Bemerkungen

Keine.

Weitere Informationen

Autorisieren von Anforderungen an Azure Storage
Festlegen der OData-Datendienstversionsheader
Status- und Fehlercodes
Tabellenspeicherfehlercodes