Erstellen einer Tabelle

  • Artikel

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:

Methode Anforderungs-URI HTTP-Version
POST https://myaccount.table.core.windows.net/Tables HTTP/1.1

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:

Methode Anforderungs-URI HTTP-Version
POST http://127.0.0.1:10002/devstoreaccount1/Tables HTTP/1.1

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:

Anforderungsheader BESCHREIBUNG
Authorization Erforderlich. Gibt das Autorisierungsschema, den Kontonamen und die Signatur an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage.
Date oder x-ms-date Erforderlich. Gibt die koordinierte Weltzeit (Coordinated Universal Time, UTC) für die Anforderung an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage.
x-ms-version Optional. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Weitere Informationen finden Sie unter Versionsverwaltung für die Azure-Speicherdienste.
Content-Type Erforderlich. Gibt den Inhaltstyp der Nutzlast an. Mögliche Werte:

- application/atom+xml (nur Versionen vor 2015-12-11)
- application/json

Weitere Informationen finden Sie unter Nutzlastformat für Table Storage-Vorgänge.
Accept Optional. Gibt den akzeptierten Inhaltstyp der Antwortnutzlast an. Mögliche Werte:

- application/atom+xml (nur Versionen vor 2015-12-11)
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Weitere Informationen finden Sie unter Nutzlastformat für Tabellendienstvorgänge.
Prefer Optional. Gibt an, ob die Antwort die eingefügte Entität in der Nutzlast enthalten soll. Mögliche Werte sind return-no-content und return-content.

Weitere Informationen zu diesem Header finden Sie unter Festlegen des Headers zum Verwalten des Prefer Antwortechos bei Einfügevorgängen.
Content-Length Erforderlich. Die Länge des Anforderungstexts.
x-ms-client-request-id Optional. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem Zeichenlimit von 1 Kibibyte (KiB) bereit, der in den Protokollen aufgezeichnet wird, wenn die Protokollierung konfiguriert ist. Es wird dringend empfohlen, diesen Header zu verwenden, um clientseitige Aktivitäten mit Anforderungen zu korrelieren, die der Server empfängt. Weitere Informationen finden Sie unter Überwachen von Azure Table Storage.

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.

Hinweis

JSON ist das empfohlene Nutzlastformat und das einzige Format, das für Version 2015-12-11 und höher unterstützt wird.

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.

Antwortheader BESCHREIBUNG
x-ms-request-id Identifiziert die durchgeführte Anforderung eindeutig, und Sie können sie zur Problembehandlung für die Anforderung verwenden. Weitere Informationen finden Sie unter Problembehandlung für API-Vorgänge.
x-ms-version Gibt die Table Storage-Version an, die zum Ausführen der Anforderung verwendet wurde. Dieser Header wird für Anforderungen zurückgegeben, die für Version 2009-09-19 und höher ausgeführt werden.
Date Ein UTC-Datums-/Uhrzeitwert, der vom Dienst generiert wird, der den Zeitpunkt angibt, zu dem die Antwort initiiert wurde.
Preference-Applied Gibt an, ob der Prefer-Anforderungsheader berücksichtigt wurde. Wenn die Antwort diesen Header nicht enthält, wurde der Prefer Header nicht berücksichtigt. Wenn der Header zurückgegeben wird, lautet sein Wert entweder return-content oder return-no-content.

Weitere Informationen finden Sie unter Festlegen des Headers zum Verwalten des Prefer Antwortechos bei Einfügevorgängen.
Content-Type Gibt den Inhaltstyp der Nutzlast an. Der Wert hängt vom Wert ab, der für den Accept Anforderungsheader angegeben wird. Mögliche Werte:

- application/atom+xml
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Weitere Informationen zu Inhaltstypen finden Sie unter Nutzlastformat für Tabellenspeichervorgänge.
x-ms-client-request-id Kann zur Problembehandlung von Anforderungen und entsprechenden Antworten verwendet werden. Der Wert dieses Headers ist gleich dem Wert des x-ms-client-request-id Headers, wenn er in der Anforderung vorhanden ist und der Wert nicht mehr als 1.024 sichtbare ASCII-Zeichen enthält. Wenn der x-ms-client-request-id Header nicht vorhanden ist, ist er in der Antwort nicht vorhanden.

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.

Hinweis

Wir empfehlen JSON als Nutzlastformat. Dies ist das einzige Format, das ab Version 2015-12-11 unterstützt wird.

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