Sdílet prostřednictvím


Create Table

Operace Create Table vytvoří novou tabulku v účtu úložiště.

Žádost

Můžete vytvořit požadavek, Create Table jak je znázorněno tady. Doporučujeme použít https. Nahraďte myaccount názvem vašeho účtu úložiště:

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
POST https://myaccount.table.core.windows.net/Tables HTTP/1.1

Žádost o službu emulovaného úložiště

Když vytváříte požadavek na službu emulovaného úložiště, zadejte název hostitele emulátoru a port služby Azure Table Storage jako 127.0.0.1:10002a název emulovaného účtu úložiště:

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
POST http://127.0.0.1:10002/devstoreaccount1/Tables HTTP/1.1

Služba Table Service v emulátoru úložiště se od služby Table Storage liší několika způsoby. Další informace najdete v tématu Rozdíly mezi emulátorem úložiště a službami Azure Storage.

Parametry identifikátoru URI

Žádné

Hlavičky požadavku

Požadované a volitelné hlavičky požadavků jsou popsané v následující tabulce:

Hlavička požadavku Popis
Authorization Povinná hodnota. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
Date nebo x-ms-date Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
x-ms-version Nepovinný parametr. Určuje verzi operace, která se má použít pro tento požadavek. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
Content-Type Povinná hodnota. Určuje typ obsahu datové části. Možné hodnoty:

- application/atom+xml (pouze verze starší než 2015-12-11)
- application/json

Další informace najdete v tématu Formát datové části pro operace table storage.
Accept Nepovinný parametr. Určuje typ přijatého obsahu datové části odpovědi. Možné hodnoty:

- application/atom+xml (pouze verze starší než 2015-12-11)
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Další informace najdete v tématu Formát datové části pro operace služby Table Service.
Prefer Nepovinný parametr. Určuje, jestli má odpověď obsahovat vloženou entitu v datové části. Možné hodnoty jsou return-no-content a return-content.

Další informace o této hlavičce najdete v tématu Nastavení hlavičky Prefer pro správu odezvy při operacích vložení.
Content-Length Povinná hodnota. Délka textu požadavku.
x-ms-client-request-id Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování služby Azure Table Storage.

Text požadavku

Text požadavku určuje název tabulky, která se má vytvořit. Názvy tabulek musí splňovat omezení pojmenování popsaná v tématu Principy datového modelu úložiště tabulek.

Tělo požadavku je sada entit OData, která se dá vyjádřit jako JSON nebo jako informační kanál Atom.

Poznámka

Json je doporučený formát datové části a je to jediný formát, který je podporovaný pro verzi 2015-12-11 a novější.

Pokyny k platným názvům tabulek najdete v části Názvy tabulek v tématu Principy datového modelu úložiště tabulek.

JSON (verze 2013-08-15 a novější)

Text požadavku jako informační kanál JSON je v následujícím obecném formátu:

{   
    "TableName":"mytable"  
}  

Informační kanál Atom (verze starší než 2015-12-11)

Text požadavku jako informační kanál Atom je v následujícím obecném formátu:

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

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědi a tělo odpovědi.

Stavový kód

Stavový kód závisí na hodnotě hlavičky Prefer . Pokud je hlavička Prefer nastavená na return-no-content, vrátí úspěšná operace stavový kód 204 (No Content). Pokud hlavička Prefer není zadaná nebo pokud je nastavená na return-content, úspěšná operace vrátí stavový kód 201 (Created). Další informace najdete v tématu Nastavení hlavičky Prefer pro správu odezvy při operacích vložení.

Informace o stavových kódech najdete v tématech Stavové kódy a kódy chyb a Kódy chyb služby Table Storage.

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje hlavičky popsané v následující tabulce. Odpověď může také obsahovat další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi Description
x-ms-request-id Jedinečně identifikuje požadavek, který byl proveden, a můžete ho použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API.
x-ms-version Označuje verzi table storage, která se použila ke spuštění požadavku. Tato hlavička se vrátí pro požadavky, které jsou provedeny ve verzi 2009-09-19 a novější.
Date Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy byla odpověď inicializována.
Preference-Applied Označuje, jestli Prefer byla dodržena hlavička požadavku. Pokud odpověď toto záhlaví neobsahuje, Prefer záhlaví se nedodrží. Pokud se vrátí hlavička, bude její hodnota buď return-content nebo return-no-content.

Další informace najdete v tématu Nastavení hlavičky Prefer pro správu odezvy při operacích vložení.
Content-Type Označuje typ obsahu datové části. Hodnota závisí na hodnotě, která je zadaná pro hlavičku Accept požadavku. Možné hodnoty:

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

Další informace o typech obsahu najdete v tématu Formát datové části pro operace table storage.
x-ms-client-request-id Dá se použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě x-ms-client-request-id hlavičky, pokud je v požadavku, a hodnota neobsahuje více než 1 024 viditelných znaků ASCII. x-ms-client-request-id Pokud záhlaví neexistuje, není v odpovědi.

Text odpovědi

Pokud požadavek obsahuje hlavičku Prefer s hodnotou return-no-content, nevrátí se žádné tělo odpovědi. V opačném případě je tělem odpovědi sada entit OData.

Poznámka

Jako formát datové části doporučujeme JSON. Je to jediný formát, který je podporovaný ve verzi 2015-12-11 a novějších.

JSON (verze 2013-08-15 a novější)

Tady jsou datové části odpovědí ve formátu JSON pro různé úrovně řízení.

Úplná metadata

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

Minimální metadata

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

Žádná metadata

{  
  
    "TableName":"mytable"  
  
}  
  

Informační kanál Atom (verze dřívější než 11. 12. 2015)

Tady je ukázková odpověď Atomu Create Table pro operaci.

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

Autorizace

Tuto operaci může volat pouze vlastník účtu.

Poznámky

Žádné

Viz také

Autorizace požadavků do Služby Azure Storage
Nastavení hlaviček verzí datové služby OData
Stavové kódy a kódy chyb
Kódy chyb služby Table Storage