Entitás beszúrása

Cikk
06/27/2023

A Insert Entity művelet új entitást szúr be egy táblába.

Kérés

A kérést az Insert Entity alábbiak szerint hozhatja létre. A HTTPS használata ajánlott. Cserélje le a myaccount kifejezést a tárfiók nevére, a mytable értékét pedig a tábla nevére.

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

Emulált tárolási szolgáltatás URI-ja

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/mytable`	HTTP/1.1

A Storage emulátorban található Table Storage többféleképpen különbözik az Azure Table Storage-tó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

A kérelem URI-ján a következő további paramétereket adhatja meg.

Paraméter	Leírás
`timeout`	Választható. A `timeout` paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása a Table Storage-műveletekhez.

Kérésfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket 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 előtti verziók) és `application/json`a . Az érvényes tartalomtípusokkal kapcsolatos további információkért lásd: Payload format for Table Storage operations (Hasznos adatformátum a Table Storage-műveletekhez).
`Content-Length`	Kötelező. A kérelem törzsének hossza.
`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 előtti verziók) - `application/json;odata=nometadata` - `application/json;odata=minimalmetadata` - `application/json;odata=fullmetadata` További információ: A Table Storage-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ó: A Prefer fejléc beállítása a beszúrási műveletek válasz-visszhangjának kezeléséhez.
`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 Insert Entity művelet elküldi a beszúrni kívánt entitást OData entitásként, amely vagy JSON vagy Atom-hírcsatorna. További információ: Entitások beszúrása és frissítése.

Megjegyzés

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

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

Íme egy minta JSON-kérelemtörzs a Insert Entity művelethez:

{  
   "Address":"Mountain View",  
   "Age":23,  
   "AmountDue":200.23,  
   "CustomerCode@odata.type":"Edm.Guid",  
   "CustomerCode":"c9da6455-213d-42c9-9a79-3e9149a57833",  
   "CustomerSince@odata.type":"Edm.DateTime",  
   "CustomerSince":"2008-07-10T00:00:00",  
   "IsActive":true,  
   "NumberOfOrders@odata.type":"Edm.Int64",  
   "NumberOfOrders":"255",  
   "PartitionKey":"mypartitionkey",  
   "RowKey":"myrowkey"  
}

Atom-hírcsatorna (2015-12-11 előtti verziók)

Íme egy atomkérési mintatörzs a Insert Entity művelethez.

<?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>2013-09-18T23:46:19.3857256Z</updated>  
  <author>  
    <name />  
  </author>  
  <id />  
  <content type="application/xml">  
    <m:properties>  
      <d:Address>Mountain View</d:Address>  
      <d:Age m:type="Edm.Int32">23</d:Age>  
      <d:AmountDue m:type="Edm.Double">200.23</d:AmountDue>  
      <d:BinaryData m:type="Edm.Binary" m:null="true" />  
      <d:CustomerCode m:type="Edm.Guid">c9da6455-213d-42c9-9a79-3e9149a57833</d:CustomerCode>  
      <d:CustomerSince m:type="Edm.DateTime">2008-07-10T00:00:00</d:CustomerSince>  
      <d:IsActive m:type="Edm.Boolean">true</d:IsActive>  
      <d:NumOfOrders m:type="Edm.Int64">255</d:NumOfOrders>  
      <d:PartitionKey>mypartitionkey</d:PartitionKey>  
      <d:RowKey>myrowkey1</d:RowKey>  
    </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 értéke return-no-content, akkor a sikeres művelet a 204 -os állapotkódot adja vissza (No Content). Ha a Prefer fejléc nincs megadva, vagy a értékre return-contentvan állítva, akkor a sikeres művelet a 201(Created) állapotkódot adja vissza. További információ: A Prefer fejléc beállítása a beszúrási műveletek válasz-visszhangjának kezeléséhez.

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

Válaszfejlécek

A válasz a következő fejléceket tartalmazza. 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 kérést, amely a kérés hibaelhárításához használható. További információ: API-műveletek hibaelhárítása.
`x-ms-version`	A Table Storage kérés futtatásához használt verzióját jelzi. Ez a fejléc lesz visszaadva a 2009-09-19-es és újabb verzióval kapcsolatos kérésekhez.
`Date`	UTC dátum/idő érték, amely a válasz indításának időpontját jelzi. Ezt az értéket a szolgáltatás hozza létre.
`ETag`	Az `ETag` entitáshoz tartozó.
`Preference-Applied`	Azt jelzi, hogy a `Prefer` kérelemfejlécet figyelembe vették-e. Ha a válasz nem tartalmazza ezt a fejlécet, akkor a `Prefer` fejléc nem lett figyelembeve. Ha ezt a fejlécet adja vissza, az értéke vagy `return-no-content`.`return-content` További információ: A Prefer fejléc beállítása a beszúrási műveletek válasz-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ó. Ennek a fejlécnek az értéke megegyezik a `x-ms-client-request-id` fejléc értékével, ha az szerepel a kérelemben. Az érték legfeljebb 1024 látható ASCII-karakter lehet. Ha a `x-ms-client-request-id` fejléc nem szerepel a kérelemben, akkor az nem jelenik meg 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

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

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

Íme egy minta JSON-válasz minden metaadatszinthez:

Nincsenek metaadatok:

{  
   "PartitionKey":"mypartitionkey",  
   "RowKey":"myrowkey",  
   "Timestamp":"2013-08-22T01:12:06.2608595Z",  
   "Address":"Mountain View",  
   "Age":23,  
   "AmountDue":200.23,  
   "CustomerCode":"c9da6455-213d-42c9-9a79-3e9149a57833",  
   "CustomerSince":"2008-07-10T00:00:00",  
   "IsActive":true,  
   "NumberOfOrders":"255"  
}

Minimális metaadatok:

{  
   "odata.metadata":"https://myaccount.table.core.windows.net/Customer/$metadata#Customers/@Element",  
   "PartitionKey":"mypartitionkey",  
   "RowKey":"myrowkey",  
   "Timestamp":"2013-08-22T01:12:06.2608595Z",  
   "Address":"Mountain View",  
   "Age":23,  
   "AmountDue":200.23,  
   "CustomerCode@odata.type":"Edm.Guid",  
   "CustomerCode":"c9da6455-213d-42c9-9a79-3e9149a57833",  
   "CustomerSince@odata.type":"Edm.DateTime",  
   "CustomerSince":"2008-07-10T00:00:00",  
   "IsActive":true,  
   "NumberOfOrders@odata.type":"Edm.Int64",  
   "NumberOfOrders":"255"  
}

Teljes metaadatok:

{  
   "odata.metadata":"https://myaccount.table.core.windows.net/Customer/$metadata#Customers/@Element",  
   "odata.type":"myaccount.Customers",  
   "odata.id":" https://myaccount.table.core.windows.net/Customers(PartitionKey='mypartitionkey',RowKey='myrowkey')",  
   "odata.etag":"W/\"0x5B168C7B6E589D2\"",  
   "odata.editLink":"Customers(PartitionKey='mypartitionkey',RowKey='myrowkey')",  
   "PartitionKey":"mypartitionkey",  
   "RowKey":"myrowkey",  
   "Timestamp@odata.type":"Edm.DateTime",  
   "Timestamp":"2013-08-22T01:12:06.2608595Z",  
   "Address":"Mountain View",  
   "Age":23,  
   "AmountDue":200.23,  
   "CustomerCode@odata.type":"Edm.Guid",  
   "CustomerCode":"c9da6455-213d-42c9-9a79-3e9149a57833",  
   "CustomerSince@odata.type":"Edm.DateTime",  
   "CustomerSince":"2008-07-10T00:00:00",  
   "IsActive":true,  
   "NumberOfOrders@odata.type":"Edm.Int64",  
   "NumberOfOrders":"255"  
}

Atom-hírcsatorna (2015-12-11 előtti verziók)

Íme egy atomválasz-törzsminta a Insert Entity 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" m:etag="W/"0x5B168C7B6E589D2"" xmlns="https://www.w3.org/2005/Atom">  
  <id>https://myaccount.table.core.windows.net/mytable(PartitionKey='mypartitionkey',RowKey='myrowkey1')</id>  
  <title type="text"></title>  
  <updated>2008-09-18T23:46:19.3857256Z</updated>  
  <author>  
    <name />  
  </author>  
  <link rel="edit" title="mytable" href="mytable(PartitionKey='mypartitionkey',RowKey='myrowkey1')" />  
  <category term="myaccount.Tables" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />  
  <content type="application/xml">  
    <m:properties>  
      <d:PartitionKey>mypartitionkey</d:PartitionKey>  
      <d:RowKey>myrowkey1</d:RowKey>  
      <d:Timestamp m:type="Edm.DateTime">2008-09-18T23:46:19.4277424Z</d:Timestamp>  
      <d:Address>Mountain View</d:Address>  
      <d:Age m:type="Edm.Int32">23</d:Age>  
      <d:AmountDue m:type="Edm.Double">200.23</d:AmountDue>  
      <d:CustomerCode m:type="Edm.Guid">c9da6455-213d-42c9-9a79-3e9149a57833</d:CustomerCode>  
      <d:CustomerSince m:type="Edm.DateTime">2008-07-10T00:00:00</d:CustomerSince>  
      <d:IsActive m:type="Edm.Boolean">true</d:IsActive>  
      <d:NumOfOrders m:type="Edm.Int64">255</d:NumOfOrders>  
    </m:properties>  
  </content>  
</entry>

Engedélyezés

A fióktulajdonos végrehajthatja ezt a műveletet. Emellett bárki, aki rendelkezik a művelet végrehajtásához engedéllyel rendelkező közös hozzáférésű jogosultságkóddal, megteheti.

Megjegyzések

Amikor entitást szúr be egy táblába, meg kell adnia a és RowKey a PartitionKey rendszertulajdonságok értékeit. Ezek a tulajdonságok együttesen alkotják az elsődleges kulcsot, és egyedinek kell lenniük a táblában.

A és RowKey az PartitionKey értéknek sztringértéknek kell lennie. Minden kulcsérték legfeljebb 64 KiB méretű lehet. Ha egész számot használ a kulcsértékhez, az egész számot rögzített szélességű sztringgé kell alakítania, mert azok rendezhetők. A megfelelő rendezés biztosításához például konvertálja az értéket 10000001értékké.

A tulajdonság explicit beírásához adja meg a megfelelő OData adattípust az m:type Atom-hírcsatorna tulajdonságdefiníciójában található attribútum beállításával. További információ a tulajdonságok beírásáról: Entitások beszúrása és frissítése.

A Table Storage nem teszi állandóvá null a tulajdonságok értékeit. Ha egy tulajdonságot értékként null ad meg, azzal egyenértékű, mintha kihagyja ezt a tulajdonságot a kérelemben.

További információ a kötegelt beszúrási műveletek végrehajtásáról: Entitáscsoport-tranzakciók végrehajtása.

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
Entitások beszúrása és frissítése
Állapot- és hibakódok
Table Storage-hibakódok

Entitás beszúrása

Kérés

Emulált tárolási szolgáltatás URI-ja

URI-paraméterek

Kérésfejlécek

A kérés törzse

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

Atom-hírcsatorna (2015-12-11 előtti verziók)

Reagálás

Állapotkód

Válaszfejlécek

Választörzs

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

Atom-hírcsatorna (2015-12-11 előtti verziók)

Engedélyezés

Megjegyzések

Lásd még

További források