Create Table

A Create Table művelet létrehoz egy új táblát egy tárfiókban.

Kérés

A kérést az Create Table itt látható módon hozhatja létre. Javasoljuk, hogy HTTPS-t használjon. Cserélje le a myaccount kifejezést a tárfiók nevére:

Metódus	Kérés URI-ja	HTTP-verzió
POST	https://myaccount.table.core.windows.net/Tables	HTTP/1.1

Emulált tárolási szolgáltatás kérése

Amikor kérést küld az emulált tárolási szolgáltatásra, adja meg az emulátor gazdanevét és az Azure Table Storage-portot , 127.0.0.1:10002majd az emulált tárfiók nevét:

Metódus	Kérés URI-ja	HTTP-verzió
POST	http://127.0.0.1:10002/devstoreaccount1/Tables	HTTP/1.1

A Storage Emulator Table szolgáltatása többféleképpen különbözik a Table Storage szolgáltatástól. További információ: A storage emulátor és az Azure Storage-szolgáltatások közötti különbségek.

URI-paraméterek

Nincsenek.

Kérésfejlécek

A szükséges és nem kötelező kérésfejléceket az alábbi táblázat ismerteti:

Kérelem fejléce	Leírás
Authorization	Kötelező. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérelmek engedélyezése az Azure Storage-ba.
Date vagy x-ms-date	Kötelező. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. További információ: Kérelmek engedélyezése az Azure Storage-ba.
x-ms-version	Választható. A kérelemhez használandó művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása.
Content-Type	Kötelező. Megadja a hasznos adat tartalomtípusát. Lehetséges értékek: - application/atom+xml (csak a 2015-12-11-nél korábbi verziók) - application/json További információ: A Table Storage-műveletek hasznos adatformátuma.
Accept	Választható. Megadja a válasz hasznos adatának elfogadott tartalomtípusát. Lehetséges értékek: - application/atom+xml (csak a 2015-12-11-nél korábbi verziók) - application/json;odata=nometadata - application/json;odata=minimalmetadata - application/json;odata=fullmetadata További információ: Payload Format for Table Service Operations (A Table Service-műveletek hasznos adatformátuma).
Prefer	Választható. Meghatározza, hogy a válasz tartalmazza-e a beszúrt entitást a hasznos adatban. A lehetséges értékek a következők: return-no-content és return-content. További információ erről a fejlécről: A fejléc beállítása a Prefer beszúrási műveletek visszhangjának kezeléséhez.
Content-Length	Kötelező. A kérelem törzsének hossza.
x-ms-client-request-id	Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kibibyte (KiB) karakterkorláttal, amelyet a naplózás konfigurálásakor rögzít a naplókban. Javasoljuk, hogy ezt a fejlécet használva korrelálja az ügyféloldali tevékenységeket a kiszolgáló által kapott kérésekkel. További információ: Az Azure Table Storage monitorozása.

A kérés törzse

A kérelem törzse adja meg a létrehozandó tábla nevét. A táblaneveknek meg kell felelniük a Table Storage-adatmodell ismertetésében ismertetett elnevezési korlátozásoknak.

A kérelem törzse egy OData-entitáskészlet, amely JSON-ként vagy Atom-adatcsatornaként fejezhető ki.

Megjegyzés

A JSON az ajánlott hasznos adatformátum, és ez az egyetlen olyan formátum, amely a 2015-12-11-es és újabb verziókban támogatott.

Az érvényes táblanevekkel kapcsolatos útmutatásért tekintse meg a Table Storage-adatmodell ismertetése című témakör "Táblanevek" szakaszát.

JSON (2013-08-15-es és újabb verziók)

A kérelem törzse JSON-hírcsatornaként a következő általános formátumban van:

{   
    "TableName":"mytable"  
}  

Atom-hírcsatorna (2015-12-11-nél korábbi verziók)

A kérelemtörzs Atom-hírcsatornaként a következő általános formátumban van:

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

Reagálás

A válasz tartalmaz egy HTTP-állapotkódot, egy válaszfejléceket és egy választörzset.

Állapotkód

Az állapotkód a fejléc értékétől Prefer függ. Ha a Prefer fejléc return-no-contentértéke , a sikeres művelet a 204 -No Contentos () állapotkódot adja vissza. Ha a Prefer fejléc nincs megadva, vagy ha értékre return-contentvan állítva, a sikeres művelet a 201 -Createdos () állapotkódot adja vissza. További információ: A fejléc beállítása a Prefer beszúrási műveletek visszhangjának kezeléséhez.

Az állapotkódokkal kapcsolatos információkért lásd: Állapot- és hibakódok és Table Storage-hibakódok.

Válaszfejlécek

A műveletre adott válasz tartalmazza az alábbi táblázatban ismertetett fejléceket. A válasz további szabványos HTTP-fejléceket is tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.

Válaszfejléc	Description
x-ms-request-id	Egyedileg azonosítja a végrehajtott kérést, és segítségével elháríthatja a kérést. További információ: API-műveletek hibaelhárítása.
x-ms-version	A kérés végrehajtásához használt Table Storage-verziót jelzi. Ezt a fejlécet a rendszer a 2009-09-19-es és újabb verzióval kapcsolatos kérések esetén adja vissza.
Date	A szolgáltatás által létrehozott UTC dátum/idő érték, amely a válasz indításának időpontját jelzi.
Preference-Applied	Azt jelzi, hogy a Prefer kérelemfejlécet figyelembe vették-e. Ha a válasz nem tartalmazza ezt a fejlécet, a Prefer fejlécet nem sikerült figyelembe venni. Ha a fejlécet adja vissza, az értéke vagy return-no-content.return-content További információ: A fejléc beállítása a Prefer beszúrási műveletek visszhangjának kezeléséhez.
Content-Type	A hasznos adat tartalomtípusát jelzi. Az érték a kérelemfejléchez Accept megadott értéktől függ. Lehetséges értékek: - application/atom+xml - application/json;odata=nometadata - application/json;odata=minimalmetadata - application/json;odata=fullmetadata A tartalomtípusokról további információt a Table Storage-műveletek hasznos adatformátuma című témakörben talál.
x-ms-client-request-id	A kérések és a megfelelő válaszok hibaelhárítására használható. A fejléc értéke megegyezik a x-ms-client-request-id kérelemben szereplő fejléc értékével, és az érték legfeljebb 1024 látható ASCII-karaktert tartalmaz. Ha a x-ms-client-request-id fejléc nincs jelen, akkor nem szerepel a válaszban.

Választörzs

Ha a kérés tartalmazza a Prefer fejlécet a értékkel return-no-content, a rendszer nem ad vissza választörzset. Ellenkező esetben a választörzs egy OData-entitáskészlet.

Megjegyzés

Hasznos adatformátumként a JSON-t javasoljuk. Ez az egyetlen formátum, amelyet a 2015-12-11-es és újabb verziók támogatnak.

JSON (2013-08-15-es és újabb verziók)

Íme a válasz hasznos adatai a JSON-ban a különböző vezérlési szintekhez.

Teljes metaadatok

{  
  
    "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ális metaadatok

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

Nincsenek metaadatok

{  
  
    "TableName":"mytable"  
  
}  
  

Atom-hírcsatorna (2015-12-11-nél korábbi verziók)

Íme egy Atom-mintaválasz a Create Table művelethez.

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

Engedélyezés

Ezt a műveletet csak a fióktulajdonos hívhatja meg.

Megjegyzések

Nincsenek.

Lásd még

Kérések engedélyezése az Azure Storage-nak
Az OData-adatszolgáltatás verziófejléceinek beállítása
Állapot- és hibakódok
Table Storage-hibakódok