영업: 1-800-867-1380

테이블 서비스 데이터 모델 이해

업데이트 날짜: 2014년 8월

테이블 서비스는 테이블 형식으로 구조적 저장소를 제공합니다. 다음 섹션에서는 테이블 서비스 데이터 모델을 개괄적으로 설명합니다.

저장소 계정은 저장소 시스템 내에 있는 전역적으로 고유한 엔터티입니다. 저장소 계정은 테이블 서비스에 대한 부모 네임스페이스이며 인증에 대한 기본입니다. 각 테이블에 고유한 이름을 지정하는 한 특정 저장소 계정 내에 테이블을 원하는 수만큼 만들 수 있습니다.

저장소 계정을 항상 요청 URI에 지정해야 합니다. 테이블 서비스에 액세스하기 위한 기본 URI는 다음과 같습니다.

https://myaccount.table.core.windows.net

테이블에는 데이터가 엔터티 모음으로 저장됩니다. 엔터티는 행과 비슷합니다. 엔터티에는 기본 키와 속성 집합이 있습니다. 속성은 이름-형식화된 값 쌍으로, 열과 비슷합니다.

테이블 서비스는 테이블에 스키마를 적용하지 않으므로 동일한 테이블에 있는 두 엔터티의 속성 집합이 서로 다를 수 있습니다. 개발자는 클라이언트 쪽에서 스키마를 적용할 수 있습니다. 테이블에는 엔터티를 원하는 수만큼 포함할 수 있습니다.

테이블 이름은 다음 규칙을 따라야 합니다.

  • 테이블 이름은 계정 내에서 고유해야 합니다.

  • 테이블 이름에는 영숫자 문자만 포함할 수 있습니다.

  • 테이블 이름은 숫자 문자로 시작할 수 없습니다.

  • 테이블 이름은 대/소문자를 구분하지 않습니다.

  • 테이블 이름은 3에서 63자여야 합니다.

  • "tables"를 비롯한 일부 테이블 이름은 예약되어 있습니다. 예약된 테이블 이름을 사용하여 테이블을 만들려고 하면 오류 코드 404(잘못된 요청)가 반환됩니다.

이러한 규칙은 "^[A-Za-z][A-Za-z0-9]{2,62}$" 정규식으로도 설명됩니다.

테이블 이름의 대/소문자는 만들어진 상태로 유지되지만 사용 시에는 대/소문자가 구분되지 않습니다.

속성 이름은 대/소문자를 구분하며 255자까지 허용됩니다. 속성 이름은 C# 식별자에 대한 이름 지정 규칙을 따라야 합니다.

note참고
일부 C# 식별자는 XML 사양에 따라 적합하지 않습니다. 속성 이름은 테이블 서비스에 대한 요청에서 XML 페이로드를 통해 전송되기 때문에 이러한 식별자를 속성 이름에 사용하면 안 됩니다.

Important중요
속성 이름은 URL을 통해 테이블 서비스로 전달됩니다. 특정 문자는 UTF-8(기본) 또는 MBCS를 사용하여 퍼센트 인코딩되어야 URL에 표시될 수 있습니다. Azure .NET 라이브러리를 사용하거나 속성 이름이 포함된 Uri 개체를 생성하면 이러한 인코딩이 자동으로 발생합니다. 그러나 인코딩해도 URL 경로에 적합하지 않은 문자가 있습니다. 이러한 문자는 속성 이름에 표시될 수 없습니다. \uE000과 같은 코드 포인트는 NTFS 파일 이름에는 적합하지만 유효한 유니코드 문자가 아니므로 사용할 수 없습니다. 제어 문자(0x00-0x1F, \u0081 등)와 같은 일부 ASCII 또는 유니코드 문자도 허용되지 않습니다. HTTP/1.1에서 유니코드 문자열에 적용되는 규칙은 다음을 참조하십시오.

note참고
2009-04-14 버전부터 테이블 서비스에서 속성 이름에 더 이상 대시(-) 문자를 포함할 수 없습니다.

다음 섹션에 설명된 3개의 시스템 속성을 포함하여 최대 255개의 속성을 엔터티에 포함할 수 있습니다. 따라서 사용자는 3개의 시스템 속성을 제외하고 252개의 사용자 지정 속성을 포함할 수 있습니다. 엔터티 속성의 모든 데이터를 더한 크기는 1MB를 초과할 수 없습니다.

엔터티에는 항상 다음 시스템 속성이 있습니다.

  • PartitionKey 속성

  • RowKey 속성

  • Timestamp 속성

이러한 시스템 속성은 테이블의 모든 엔터티에 자동으로 포함됩니다. 이러한 속성의 이름은 예약되어 있으며 변경할 수 없습니다. PartitionKeyRowKey의 값은 개발자가 삽입하고 업데이트해야 하며, 수정할 수 없는 Timestamp의 값은 서버에서 관리됩니다.

다음 문자는 PartitionKeyRowKey 속성의 값에 사용할 수 없습니다.

  • 슬래시(/) 문자

  • 백슬래시(\) 문자

  • 숫자 기호(#) 문자

  • 물음표(?) 문자

  • 다음을 포함한 U+0000에서 U+001F까지의 제어 문자:

    • 가로 탭(\t) 문자

    • 줄 바꿈(\n) 문자

    • 캐리지 리턴(\r) 문자

  • U+007F에서 U+009F까지의 제어 문자

테이블은 저장소 노드에서 부하 분산을 지원하기 위해 파티션으로 분할됩니다. 테이블의 엔터티는 파티션별로 구성됩니다. 파티션은 동일한 파티션 키 값을 가지는 일련의 엔터티입니다. 파티션 키는 PartitionKey 속성으로 지정되며, 특정 테이블 내에서 파티션에 대한 고유 식별자로 사용됩니다. 파티션 키는 엔터티 기본 키의 첫 번째 부분을 구성합니다. 파티션 키는 최대 크기가 1KB인 문자열 값일 수 있습니다.

모든 삽입, 업데이트 및 삭제 작업에 PartitionKey 속성이 포함되어야 합니다.

기본 키의 두 번째 부분은 RowKey 속성으로 지정되는 행 키입니다. 행 키는 특정 파티션 내에서 엔터티에 대한 고유 식별자로 사용됩니다. PartitionKeyRowKey는 함께 테이블 내의 모든 엔터티를 고유하게 식별합니다.

행 키는 최대 크기가 1KB일 수 있는 문자열 값입니다.

모든 삽입, 업데이트 및 삭제 작업에 RowKey 속성이 포함되어야 합니다.

Timestamp 속성은 엔터티가 마지막으로 수정된 시간을 기록하기 위해 서버 쪽에서 유지 관리되는 DateTime 값입니다. 테이블 서비스는 Timestamp 속성을 사용하여 내부적으로 낙관적 동시성을 제공합니다. Timestamp 값은 단조 증가 값입니다. 즉, 엔터티가 수정될 때마다 해당 엔터티에 대해 Timestamp 값이 증가합니다. 이 속성은 삽입 또는 업데이트 작업에 대해서는 설정되지 않아야 합니다. 값이 무시됩니다.

테이블 서비스는 OData 프로토콜 사양에 정의된 데이터 형식의 하위 집합을 지원합니다. 다음 표에서는 테이블 서비스에 대해 지원되는 속성 유형을 보여 줍니다.

 

OData 데이터 형식 공용 언어 런타임 유형 세부 정보

Edm.Binary

byte[]

최대 크기가 64KB인 바이트 배열입니다.

Edm.Boolean

bool

부울 값입니다.

Edm.DateTime

DateTime

UTC(협정 세계시)로 표시되는 64비트 값입니다. 지원되는 DateTime 범위는 서기 1601년 1월 1일 자정(UTC)에 시작되어 9999년 12월 31일에 끝납니다.

Edm.Double

double

64비트 부동 소수점 값입니다.

Edm.Guid

Guid

128비트 GUID(Globally Unique Identifier)입니다.

Edm.Int32

Int32 또는 int

32비트 정수입니다.

Edm.Int64

Int64 또는 long

64비트 정수입니다.

Edm.String

String

UTF-16으로 인코딩된 값입니다. 문자열 값의 최대 크기는 64KB입니다.

유형을 지정하지 않으면 기본적으로 속성이 String 유형으로 만들어집니다. 속성의 유형을 명시적으로 지정하려면 엔터티 삽입 또는 엔터티 업데이트 작업에 적합한 OData 데이터 형식을 사용하여 해당 데이터 형식을 지정하십시오. 자세한 내용은 엔터티 삽입 및 업데이트를 참조하십시오.

쿼리 요청 URI에서 다양한 속성 유형을 기준으로 필터링하는 방법을 보여 주는 예는 테이블 및 엔터티 쿼리를 참조하십시오.

참고 항목

이 정보가 도움이 되었습니까?
(1500자 남음)
의견을 주셔서 감사합니다.
표시:
© 2014 Microsoft