Udostępnij za pośrednictwem

Create Table

  • Artykuł

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

Żądanie

Żądanie można skonstruować Create Table , jak pokazano tutaj. Zalecamy używanie protokołu HTTPS. Zastąp ciąg myaccount nazwą konta magazynu:

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

Żądanie usługi magazynu emulowanego

Podczas wysyłania żądania względem emulowanej usługi magazynu określ nazwę hosta emulatora i port usługi Azure Table Storage jako 127.0.0.1:10002, a następnie nazwę emulowanego 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 Table Storage na kilka sposobów. Aby uzyskać więcej informacji, zobacz Różnice między emulatorem magazynu a usługami Azure Storage.

Parametry identyfikatora URI

Brak.

Nagłówki żądań

Wymagane i opcjonalne nagłówki żądań opisano w poniższej tabeli:

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 Przechowywanie wersji usług Azure Storage.
Content-Type Wymagane. Określa typ zawartości ładunku. Możliwe wartości:

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

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

- application/atom+xml (tylko wersje starsze 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 Ustawianie nagłówka Prefer w celu zarządzania echo odpowiedzi podczas operacji wstawiania.
Content-Length Wymagane. Długość treści żądania.
x-ms-client-request-id Opcjonalny. Udostępnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB), który jest rejestrowany w dziennikach podczas konfigurowania rejestrowania. Zdecydowanie zalecamy używanie tego nagłówka do korelowania działań po stronie klienta z żądaniami odbieranymi przez serwer. Aby uzyskać więcej informacji, zobacz Monitorowanie usługi Azure Table Storage.

Treść żądania

Treść żądania określa nazwę tabeli do utworzenia. Nazwy tabel muszą być zgodne z ograniczeniami nazewnictwa opisanymi w temacie Omówienie modelu danych usługi Table Storage.

Treść żądania to zestaw jednostek OData, który można wyrazić jako dane JSON lub jako źródło danych Atom.

Uwaga

Format JSON jest zalecanym formatem ładunku i jest to jedyny format obsługiwany w wersji 2015-12-11 lub nowszej.

Aby uzyskać wskazówki dotyczące prawidłowych nazw tabel, zobacz sekcję "Nazwy tabel" w temacie Omówienie modelu danych usługi Table Storage.

JSON (wersja 2013-08-15 lub nowsza)

Treść żądania jako źródło danych JSON jest w następującym ogólnym formacie:

{   
    "TableName":"mytable"  
}

Kanał informacyjny atomów (wersje starsze niż 2015-12-11)

Treść żądania jako kanał informacyjny Atom ma następujący ogólny 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>

Reakcja

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

Kod stanu

Kod stanu zależy od wartości nagłówka Prefer . Prefer Jeśli nagłówek ma wartość return-no-content, operacja zakończona powodzeniem zwraca kod stanu 204 (No Content). Prefer Jeśli nagłówek nie jest określony lub jeśli jest ustawiony na return-contentwartość , operacja pomyślna zwraca kod stanu 201 (Created). Aby uzyskać więcej informacji, zobacz Ustawianie nagłówka Prefer w celu zarządzania echo odpowiedzi podczas operacji wstawiania.

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

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera nagłówki opisane w poniższej tabeli. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie nagłówki standardowe są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi Opis
x-ms-request-id Unikatowo identyfikuje wykonane żądanie i można go użyć do rozwiązywania problemów z żądaniem. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z operacjami interfejsu API.
x-ms-version Wskazuje wersję usługi Table Storage, która została użyta do wykonania żądania. Ten nagłówek jest zwracany dla żądań wysyłanych w wersji 2009-09-19 i nowszych.
Date Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę zainicjowania odpowiedzi.
Preference-Applied Wskazuje, czy Prefer nagłówek żądania został uhonorowany. Jeśli odpowiedź nie zawiera tego nagłówka, Prefer nagłówek nie został uhonorowany. Jeśli nagłówek zostanie zwrócony, jego wartość będzie mieć wartość return-content lub return-no-content.

Aby uzyskać więcej informacji, zobacz Ustawianie nagłówka Prefer w celu zarządzania echo odpowiedzi podczas operacji wstawiania.
Content-Type Wskazuje typ zawartości ładunku. Wartość zależy od wartości określonej dla nagłówka Accept żą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 Storage.
x-ms-client-request-id Może służyć do rozwiązywania problemów z żądaniami i odpowiadającymi im odpowiedziami. Wartość tego nagłówka jest równa wartości x-ms-client-request-id nagłówka, jeśli znajduje się w żądaniu, a wartość nie zawiera więcej niż 1024 widocznych znaków ASCII. x-ms-client-request-id Jeśli nagłówek nie jest obecny, nie jest obecny w odpowiedzi.

Treść odpowiedzi

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

Uwaga

Zalecamy użycie formatu JSON jako formatu ładunku. Jest to jedyny format obsługiwany w wersji 2015-12-11 lub nowszej.

JSON (wersja 2013-08-15 lub nowsza)

Poniżej przedstawiono ładunki odpowiedzi w formacie 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"  
  
}

Kanał informacyjny atomów (wersje starsze niż 2015-12-11)

Oto przykładowa odpowiedź Atom 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 Storage