엔터티 삽입

Insert Entity 작업은 새 엔터티를 테이블에 삽입합니다.

요청

다음과 같이 요청을 생성할 Insert Entity 수 있습니다. HTTPS를 사용하는 것이 좋습니다. myaccount를 스토리지 계정의 이름으로 바꾸고 mytable을 테이블 이름으로 바꿉니다.

에뮬레이트된 스토리지 서비스 URI

에뮬레이트된 스토리지 서비스에 대해 요청할 때 에뮬레이터 호스트 이름 및 Azure Table Storage 포트를 로 127.0.0.1:10002지정한 다음 에뮬레이트된 스토리지 계정 이름을 지정합니다.

스토리지 에뮬레이터의 Table Storage는 여러 가지 방법으로 Azure Table Storage와 다릅니다. 자세한 내용은 Storage 에뮬레이터와 Azure Storage 서비스 간의 차이점을 참조하세요.

URI 매개 변수

요청 URI에 다음 추가 매개 변수를 지정할 수 있습니다.

요청 헤더

다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.

요청 본문

연산은 Insert Entity 엔터티로 OData 삽입할 엔터티(JSON 또는 Atom 피드)를 보냅니다. 자세한 내용은 엔터티 삽입 및 업데이트를 참조하세요.

JSON(버전 2013-08-15 이상)

작업에 대한 샘플 JSON 요청 본문은 Insert Entity 다음과 같습니다.

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

원자 피드(2015-12-11 이전 버전)

다음은 작업에 대한 샘플 Atom 요청 본문입니다 Insert Entity .

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

응답

응답에는 HTTP 상태 코드, 응답 헤더 집합 및 응답 본문이 포함되어 있습니다.

상태 코드

상태 코드는 Prefer 헤더의 값에 따라 달라집니다. Prefer 헤더가 return-no-content로 설정된 경우 작업에 성공할 경우 상태 코드 204(No Content)가 반환됩니다. 헤더가 Prefer 지정되지 않았거나 로 설정된 return-content경우 성공적인 작업은 상태 코드 201(Created)을 반환합니다. 자세한 내용은 삽입 작업에서 응답 에코를 관리하도록 선호 헤더 설정을 참조하세요.

상태 코드에 대한 자세한 내용은 상태 및 오류 코드 및테이블 서비스 오류 코드를 참조하세요.

응답 헤더

응답에는 다음과 같은 헤더가 포함됩니다. 응답에는 추가 표준 HTTP 헤더도 포함될 수 있습니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 준수합니다.

응답 본문

요청에 return-no-content 값의 Prefer 헤더가 포함된 경우 응답 본문이 반환되지 않습니다. 그렇지 않으면 응답 본문이 엔터티 집합입니다 OData .

JSON(버전 2013-08-15 이상)

각 메타데이터 수준에 대한 샘플 JSON 응답은 다음과 같습니다.

메타데이터 없음:

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

최소 메타데이터:

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

전체 메타데이터:

{  
   "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 피드(2015-12-11 이전 버전)

다음은 Insert Entity 작업의 예제 Atom 응답 본문입니다.

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

권한 부여

계정 소유자는 이 작업을 수행할 수 있습니다. 또한 이 작업을 수행할 수 있는 권한이 있는 공유 액세스 서명이 있는 모든 사용자가 이 작업을 수행할 수 있습니다.

설명

테이블에 엔터티를 삽입할 때 및 RowKey 시스템 속성에 PartitionKey 대한 값을 지정해야 합니다. 이러한 속성은 함께 기본 키를 형성하며 테이블 내에서 고유해야 합니다.

및 RowKey 값은 PartitionKey 모두 문자열 값이어야 합니다. PartitionKey 및 RowKey 값의 크기는 최대 1024자일 수 있습니다. 키 값에 정수 값을 사용하는 경우 정수는 정식으로 정렬되므로 정수 를 고정 너비 문자열로 변환해야 합니다. 예를 들어 값을 1 로 변환하여 0000001적절한 정렬을 보장합니다.

속성을 명시적으로 입력하려면 Atom 피드의 속성 정의 내에서 특성을 설정 m:type 하여 적절한 OData 데이터 형식을 지정합니다. 속성 입력에 대한 자세한 내용은 엔터티 삽입 및 업데이트를 참조하세요.

Table Storage는 속성에 대한 값을 영구적으로 만들지 null 않습니다. 값을 사용하여 속성을 null 지정하는 것은 요청에서 해당 속성을 생략하는 것과 같습니다.

일괄 삽입 작업을 수행하는 방법에 대한 자세한 내용은 엔터티 그룹 트랜잭션 수행을 참조하세요.

추가 정보

Azure Storage에 대한 요청 권한 부여
OData 데이터 서비스 버전 헤더 설정
엔터티 삽입 및 업데이트
상태 및 오류 코드
Table Storage 오류 코드