Create Table

Operacja Create Table tworzy nową tabelę na koncie magazynu.

Żądanie

Żądanie Create Table może zostać skonstruowane w następujący sposób. Protokół HTTPS jest zalecany. Zastąp myaccount nazwą konta magazynu:

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
POST https://myaccount.table.core.windows.net/Tables HTTP/1.1

Emulowany adres URI usługi magazynu

Podczas tworzenia żądania względem emulowanej usługi magazynu określ nazwę hosta emulatora i port usługi table jako , a następnie 127.0.0.1:10002 nazwę emulowanej konta magazynu:

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
POST http://127.0.0.1:10002/devstoreaccount1/Tables HTTP/1.1

Usługa Table Service w emulatorze magazynu różni się od usługi Windows® Azure™ table na kilka sposobów. Aby uzyskać więcej informacji, zobacz Differences Between the Storage Emulator and Azure Storage Services (Różnice między usługami Azure Storage Emulator i Azure Storage Services).

Parametry URI

Brak.

Nagłówki żądań

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.

Nagłówek żądania Opis
Authorization Wymagane. Określa schemat autoryzacji, nazwę konta i podpis. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
Date lub x-ms-date Wymagane. Określa dla żądania godzinę w formacie uniwersalnego czasu koordynowanego (UTC). Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
x-ms-version Opcjonalny. Określa wersję operacji do użycia dla tego żądania. Aby uzyskać więcej informacji, zobacz Versioning for the Azure Storage Services(Wersje usług Azure Storage Services).
Content-Type Wymagane. Określa typ zawartości ładunku. Możliwe wartości:

- application/atom+xml (tylko wersje wcześniejsze niż 2015-12-11)
- application/json

Aby uzyskać więcej informacji, zobacz Format ładunku dla operacji usługi Table Service.
Accept Opcjonalny. Określa akceptowany typ zawartości ładunku odpowiedzi. Możliwe wartości:

- application/atom+xml (tylko wersje wcześniejsze niż 2015-12-11)
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Aby uzyskać więcej informacji, zobacz Format ładunku dla operacji usługi Table Service.
Prefer Opcjonalny. Określa, czy odpowiedź powinna zawierać wstawioną jednostkę w ładunku. Możliwe wartości to return-no-content i return-content .

Aby uzyskać więcej informacji na temat tego nagłówka, zobacz Setting the Prefer Header to Manage Response Echo on Insert Operations (Ustawianie preferowanego nagłówka do zarządzania echo odpowiedzi w operacjach wstawiania).
Content-Length Wymagane. Długość treści żądania.
x-ms-client-request-id Opcjonalny. Zapewnia wygenerowaną przez klienta nieprzezroczystą wartość z limitem znaków 1 KiB, który jest rejestrowany w dziennikach analizy, gdy jest włączone rejestrowanie analizy magazynu. Używanie tego nagłówka jest wysoce zalecane do korelowania działań po stronie klienta z żądaniami odebranymi przez serwer. Aby uzyskać więcej informacji, zobacz About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests (Informacje o rejestrowaniu usługi Storage Analytics i rejestrowaniu na platformie Azure: używanie dzienników do śledzenia żądań Storage danych).

Treść żądania

Treść żądania określa nazwę tabeli do utworzenia. Należy pamiętać, że nazwy tabel muszą być zgodne z ograniczeniami nazewnictwa opisanymi w tesłudze Table Service Data Model ( Omówienie modelu danych usługi Table Service).

Treść żądania to zestaw jednostek OData, który może być wyrażony jako JSON lub jako źródło danych Atom.

Uwaga

Format JSON jest zalecanym formatem ładunku i jest jedynym formatem obsługiwanym w wersjach 2015-12-11 i nowszych.

Aby uzyskać wskazówki dotyczące prawidłowych nazw tabel, zobacz sekcję Nazwy tabel w tesłudze Table Service Data Model.

JSON (wersje 2013-08-15 i nowsze)

Treść żądania jako źródło danych JSON ma następujący format ogólny.

{   
    "TableName":"mytable"  
}  

Źródło danych Atom (wersje wcześniejsze niż 2015-12-11)

Treść żądania jako źródło danych Atom ma następujący format ogólny.

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

Reakcja

Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi.

Kod stanu

Kod stanu zależy od wartości Prefer nagłówka. Jeśli nagłówek Prefer jest ustawiony na wartość , return-no-content pomyślna operacja zwraca kod stanu 204 ( No Content ). Jeśli nagłówek nie jest określony lub jeśli jest ustawiony na wartość , pomyślna operacja zwraca Prefer return-content kod stanu 201 ( Created ). Aby uzyskać więcej informacji, zobacz Setting the Prefer Header to Manage Response Echo on Insert Operations (Ustawianie nagłówka Preferuj, aby zarządzać echo odpowiedzi w operacjach wstawiania).

Aby uzyskać informacje o kodach stanu, zobacz Kody stanu i błędów oraz Kody błędów usługi tabel.

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi Opis
x-ms-request-id Ten nagłówek unikatowo identyfikuje żądanie, które zostało wykonane, i może służyć do rozwiązywania problemów z żądaniem. Aby uzyskać więcej informacji, zobacz Troubleshooting API Operations (Rozwiązywanie problemów z operacjami interfejsu API).
x-ms-version Wskazuje wersję usługi Table Service używaną do wykonania żądania. Ten nagłówek jest zwracany w przypadku żądań względem wersji 2009-09-19 i nowszych.
Date Wartość daty/czasu UTC wygenerowana przez usługę, która wskazuje czas, o której została zainicjowana odpowiedź.
Preference-Applied Wskazuje, czy Prefer nagłówek żądania został honorowany. Jeśli odpowiedź nie zawiera tego nagłówka, nagłówek Prefer nie został honorowany. Jeśli ten nagłówek jest zwracany, jego wartością będzie return-content lub return-no-content .

Aby uzyskać więcej informacji, zobacz Setting the Prefer Header to Manage Response Echo on Insert Operations (Ustawianie nagłówka Preferuj, aby zarządzać echo odpowiedzi w operacjach wstawiania).
Content-Type Wskazuje typ zawartości ładunku. Wartość zależy od wartości określonej dla Accept nagłówka żądania. Możliwe wartości:

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

Aby uzyskać więcej informacji na temat typów zawartości, zobacz Format ładunku dla operacji usługi Table Service.
x-ms-client-request-id Ten nagłówek może służyć do rozwiązywania problemów z żądaniami i odpowiadającymi odpowiedziami. Wartość tego nagłówka jest równa wartości nagłówka, jeśli jest obecny w żądaniu, a wartość jest co najwyżej 1024 widocznych znaków x-ms-client-request-id ASCII. Jeśli nagłówek x-ms-client-request-id nie jest obecny w żądaniu, ten nagłówek nie będzie obecny w odpowiedzi.

Treść odpowiedzi

Jeśli żądanie zawiera nagłówek Prefer z wartością return-no-content , nie jest zwracana żadna treść odpowiedzi. W przeciwnym razie treść odpowiedzi jest zestawem jednostek OData.

Uwaga

Format JSON jest zalecanym formatem ładunku i jest jedynym formatem obsługiwanym w wersjach 2015-12-11 i nowszych.

JSON (wersje 2013-08-15 i nowsze)

Poniżej znajdują się ładunki odpowiedzi w force JSON dla różnych poziomów kontroli.

Pełne metadane

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

Minimalne metadane

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

Brak metadanych

{  
  
    "TableName":"mytable"  
  
}  
  

Źródło danych Atom (wersje wcześniejsze niż 2015-12-11)

Oto przykładowa odpowiedź atomu dla Create Table operacji.

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

Autoryzacja

Tylko właściciel konta może wywołać tę operację.

Uwagi

Brak.

Zobacz też

Autoryzowanie żądań do usługi Azure Storage
Ustawianie nagłówków wersji usługi danych OData
Kody stanu i błędów
Kody błędów usługi Table Service