내보내기(0) 인쇄
모두 확장

테이블 쿼리

업데이트 날짜: 2014년 2월

Query Tables 작업은 지정된 계정의 테이블 목록을 반환합니다.

다음과 같이 Query Tables 요청을 생성할 수 있습니다. HTTPS를 사용하는 것이 좋습니다. myaccount를 사용자의 저장소 계정으로 바꿉니다.

 

메서드 요청 URI HTTP 버전

GET

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

HTTP/1.1

에뮬레이트된 저장소 서비스에 대해 요청을 수행할 때는 에뮬레이터 호스트 이름 및 테이블 서비스 포트를 127.0.0.1:10002로 지정하고 뒤에 에뮬레이트된 저장소 계정 이름을 붙입니다.

 

메서드 요청 URI HTTP 버전

GET

http://127.0.0.1:10002/devstoreaccount1/Tables

HTTP/1.1

에뮬레이트된 저장소 서비스의 테이블 서비스는 Windows® Azure™ 테이블 서비스와 몇 가지 면에서 서로 다릅니다. 자세한 내용은 About Development Storage저장소 에뮬레이터와 Azure 저장소 서비스의 차이점을 참조하십시오.

Query Tables 작업에는 OData 프로토콜 사양에 정의된 쿼리 옵션이 지원됩니다. 자세한 내용은 OData URI 규칙을 참조하십시오.

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

 

요청 헤더 설명

Authorization

필수 사항입니다. 인증 체계, 계정 이름 및 서명을 지정합니다. 자세한 내용은 Azure 저장소 서비스에 대한 인증를 참조하십시오.

Date 또는 x-ms-date

필수 사항입니다. 요청의 UCT(협정 세계시)를 지정합니다. 자세한 내용은 Azure 저장소 서비스에 대한 인증를 참조하십시오.

x-ms-version

선택 사항입니다. 이 요청에 사용할 작업의 버전을 지정합니다. 자세한 내용은 Azure 저장소 서비스 버전 관리를 참조하십시오.

Accept

선택 사항입니다. 응답 페이로드의 허용되는 콘텐츠 형식을 지정합니다. 가능한 값은 다음과 같습니다.

  • application/atom+xml

  • application/json;odata=nometadata

  • application/json;odata=minimalmetadata

  • application/json;odata=fullmetadata

자세한 내용은 테이블 서비스 작업의 페이로드 형식를 참조하십시오.

x-ms-client-request-id

선택 사항입니다. 저장소 분석 로깅을 사용하도록 설정한 경우 분석 로그에 기록된 1KB 문자 제한의 클라이언트에서 생성한 불투명 값을 제공합니다. 클라이언트 쪽 작업과 서버가 받은 요청의 상관 관계를 지정하는 데 이 헤더를 사용하는 것이 좋습니다. 자세한 내용은 저장소 분석 로깅 정보Microsoft Azure 로깅: 로그를 사용하여 저장소 요청 추적을 참조하십시오.

없음.

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

작업에 성공하면 상태 코드 200(정상)이 반환됩니다.

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

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

 

응답 헤더 설명

x-ms-continuation-NextTableName

반환할 테이블 수가 1,000개를 초과하거나 쿼리가 제한 시간 간격 내에 완료되지 않은 경우, 응답 헤더에 x-ms-continuation-NextTableName 연속 헤더가 포함됩니다. 이 헤더는 연속 토큰 값을 반환합니다. 연속 토큰 사용에 대한 자세한 내용은 쿼리 제한 시간 및 페이지 번호 매김을 참조하십시오.

x-ms-request-id

이 헤더는 수행된 요청을 고유하게 식별하며, 이 헤더를 사용해서 요청 문제를 해결할 수 있습니다. 자세한 내용은 API 작업 문제 해결를 참조하십시오.

x-ms-version

요청을 실행하는 데 사용되는 테이블 서비스의 버전을 나타냅니다. 이 헤더는 2009-09-19 버전 이상에 대해 수행된 요청에 대해 반환됩니다.

Date

응답이 시작된 시간을 나타내는 서비스에서 생성된 UTC 날짜/시간 값입니다.

Content-Type

페이로드의 콘텐츠 형식을 나타냅니다. 값은 요청 Accept 헤더에 따라 달라집니다. 가능한 값은 다음과 같습니다.

  • application/atom+xml

  • application/json;odata=nometadata

  • application/json;odata=minimalmetadata

  • application/json;odata=fullmetadata

유효한 콘텐츠 형식에 대한 자세한 내용은 테이블 서비스 작업의 페이로드 형식을 참조하십시오.

Query Tables 작업은 계정의 테이블 목록을 OData 엔터티 집합으로 반환합니다. Accept 헤더의 값에 따라 콘텐츠는 Atom 피드 또는 JSON입니다.

Atom 피드

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

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<feed 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="http://www.w3.org/2005/Atom">
  <title type="text">Tables</title>
  <id>https://myaccount.table.core.windows.net/Tables</id>
  <updated>2009-01-04T17:18:54.7062347Z</updated>
  <link rel="self" title="Tables" href="Tables" />
  <entry>
    <id>https://myaccount.table.core.windows.net/Tables('mytable')</id>
    <title type="text"></title>
    <updated>2009-01-04T17: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>
</feed> 

JSON

다음은 Query Tables 작업의 예제 JSON 응답 본문입니다.

전체 메타데이터

{
   "odata.metadata":"https://myaccount.table.core.windows.net/$metadata#Tables",
   "value":[
      {
         "odata.type":"myaccount.Tables",
         "odata.id":"https://myaccount.table.core.windows.net/Tables('mytable')",
         "odata.editLink":"Tables('mytable')",
         "TableName":"mytable"
      }
}

최소 메타데이터

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

메타데이터 없음

{
   "value":[{
       "TableName":"mytable"
   },
}

계정 소유자만 이 작업을 호출할 수 있습니다.

테이블 서비스에 대한 쿼리는 한 번에 최대 1,000개까지 테이블을 반환할 수 있으며, 최대 5초 동안 실행될 수 있습니다. 결과 집합에 1,000개를 초과하는 테이블이 포함된 경우, 쿼리가 5초 이내에 완료되지 않은 경우 또는 쿼리가 파티션 경계를 벗어날 경우, 응답에는 x-ms-continuation-NextTableName 연속 토큰이 포함된 사용자 지정 헤더가 포함됩니다. 연속 토큰을 사용하면 다음 데이터 페이지에 대한 후속 요청을 생성할 수 있습니다. 연속 토큰에 대한 자세한 내용은 쿼리 제한 시간 및 페이지 번호 매김을 참조하십시오.

쿼리 예약 및 처리에 대한 요청에 할당된 총 시간은 쿼리 실행에 필요한 5초를 포함하여 30초입니다.

LINQ를 사용하여 테이블 서비스에 대해 지원되는 쿼리 작업에 대한 자세한 내용은 테이블 서비스에 지원되는 쿼리 연산자테이블 서비스에 대한 LINQ 쿼리 작성을 참조하십시오.

Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2014 Microsoft