쿼리 테이블

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

요청

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

메서드 요청 URI HTTP 버전
GET https://myaccount.table.core.windows.net/Tables HTTP/1.1

에뮬레이트된 저장소 서비스 URI

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

메서드 요청 URI HTTP 버전
GET http://127.0.0.1:10002/devstoreaccount1/Tables HTTP/1.1

에뮬레이트된 저장소 서비스의 테이블 서비스는 Microsoft® Azure™ 테이블 서비스와 몇 가지 면에서 서로 다릅니다. 자세한 내용은 Storage Emulator 및 Azure Storage Services 간의 차이점을 참조하세요.

URI 매개 변수

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

요청 헤더

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

요청 헤더 Description
Authorization 필수 요소. 권한 부여 체계, 계정 이름 및 서명을 지정합니다. 자세한 내용은 Azure Storage 요청 권한 부여를 참조하세요.
Date 또는 x-ms-date 필수 요소. 요청에 대한 UTC(협정 세계시)를 지정합니다. 자세한 내용은 Azure Storage 요청 권한 부여를 참조하세요.
x-ms-version 선택 사항입니다. 이 요청에 사용할 작업의 버전을 지정합니다. 자세한 내용은 Azure Storage 서비스의 버전 관리를 참조하세요.
Accept 선택 사항입니다. 응답 페이로드의 허용되는 콘텐츠 형식을 지정합니다. 가능한 값은 다음과 같습니다.

- application/atom+xml (2015-12-11 이전 버전만 해당)
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

자세한 내용은 Table Service 작업에 대한 페이로드 형식을 참조하세요.
x-ms-client-request-id 선택 사항입니다. 스토리지 분석 로깅을 사용하도록 설정할 때 분석 로그에 기록되는 1KiB 문자 제한으로 클라이언트에서 생성된 불투명 값을 제공합니다. 이 헤더를 사용하면 클라이언트 쪽 작업을 서버에서 받은 요청과 관련시키는 것이 좋습니다. 자세한 내용은 스토리지 분석 로깅Windows Azure 로깅 정보: 로그를 사용하여 Storage 요청 추적을 참조하세요.

요청 본문

없음

응답

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

상태 코드

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

상태 코드에 대한 자세한 내용은 상태 및 오류 코드 및Table Service 오류 코드를 참조하세요.

응답 헤더

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

응답 헤더 Description
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

유효한 콘텐츠 형식에 대한 자세한 내용은 Table Service 작업에 대한 페이로드 형식을 참조하세요.
x-ms-client-request-id 이 헤더를 사용하여 요청 및 해당 응답 문제를 해결할 수 있습니다. 이 헤더의 값은 요청에 있고 값이 최대 1024자 표시 ASCII 문자인 경우 헤더 값과 같습니다 x-ms-client-request-id . 헤더가 x-ms-client-request-id 요청에 없는 경우 이 헤더는 응답에 없습니다.

응답 본문

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

참고

JSON은 권장 페이로드 형식이며 버전 2015-12-11 이상에서 지원되는 유일한 형식입니다.

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

다음은 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"  
   },  
}  

Atom 피드(2015-12-11 이전 버전)

다음은 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>   

권한 부여

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

설명

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

참고

연속 토큰을 포함하는 후속 요청을 만들 때 요청에 원래 URI를 전달해야 합니다. 예를 들어 원래 요청의 일부로 쿼리 $select$top 또는 쿼리 옵션을 지정$filter한 경우 후속 요청에 해당 옵션을 포함할 수 있습니다. 그렇지 않으면 후속 요청이 예기치 않은 결과를 반환할 수 있습니다.

$top 이 경우 쿼리 옵션은 전체 응답 집합의 최대 결과 수가 아니라 페이지당 최대 결과 수를 지정합니다.

자세한 내용은 테이블 및 엔터티 쿼리를 참조하세요 .

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

LINQ를 통해 Table Service에 대해 지원되는 쿼리 작업에 대한 자세한 내용은 Table Service에 대해 지원되는 쿼리 연산 자 및 Table Service에 대한 LINQ 쿼리 작성을 참조하세요.

참고 항목

Table Service 리소스 주소 지정
Azure Storage 요청 권한 부여
OData 데이터 서비스 버전 헤더 설정
상태 및 오류 코드
테이블 서비스 오류 코드