쿼리 테이블

아티클
06/27/2023

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

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

URI 매개 변수

이 Query Tables 작업은 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 Storage 작업에 대한 페이로드 형식을 참조하세요.
`x-ms-client-request-id`	선택 사항입니다. 로깅이 구성될 때 로그에 기록되는 1키비바이트(KiB) 문자 제한을 사용하여 클라이언트에서 생성된 불투명 값을 제공합니다. 이 헤더를 사용하여 클라이언트 쪽 활동과 서버가 수신하는 요청의 상관 관계를 지정하는 것이 좋습니다.

요청 본문

없음

응답

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

상태 코드

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

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

응답 헤더

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

응답 헤더	Description
`x-ms-continuation-NextTableName`	연속 토큰 값을 반환합니다. 반환할 테이블 수가 1,000을 초과하거나 쿼리가 시간 제한 간격 내에 완료되지 않으면 응답 헤더에 연속 헤더가 `x-ms-continuation-NextTableName` 포함됩니다. 연속 토큰 사용에 대한 자세한 내용은 쿼리 시간 제한 및 페이지 매김을 참조하세요.
`x-ms-request-id`	만들어진 요청을 고유하게 식별합니다. 이를 사용하여 요청 문제를 해결할 수 있습니다. 자세한 내용은 API 작업 문제 해결을 참조하세요.
`x-ms-version`	요청을 실행하는 데 사용되는 Table Storage의 버전을 나타냅니다. 이 헤더는 2009-09-19 버전 이상에 대해 수행된 요청에 대해 반환됩니다.
`Date`	서비스가 응답을 보낸 시간을 나타내는 UTC 날짜/시간 값입니다.
`Content-Type`	페이로드의 콘텐츠 형식을 나타냅니다. 값은 요청의 `Accept` 헤더에 따라 달라집니다. 가능한 값은 다음과 같습니다. - `application/atom+xml` - `application/json;odata=nometadata` - `application/json;odata=minimalmetadata` - `application/json;odata=fullmetadata` 유효한 콘텐츠 형식에 대한 자세한 내용은 Table Storage 작업에 대한 페이로드 형식을 참조하세요.
`x-ms-client-request-id`	요청 및 해당 응답 문제를 해결하는 데 사용할 수 있습니다. 이 헤더의 값은 헤더의 값 `x-ms-client-request-id` 과 같으며, 요청에 있고 값이 최대 1,024자 표시 ASCII 문자인 경우 입니다. 헤더가 `x-ms-client-request-id` 요청에 없는 경우 이 헤더는 응답에 존재하지 않습니다.

응답 본문

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

참고

페이로드 형식으로 JSON을 사용하는 것이 좋습니다. 버전 2015-12-11 이상에서 유일하게 지원되는 형식입니다.

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

다음은 전체 메타데이터가 있는 작업에 대한 샘플 JSON 응답 본문입니다 Query Tables .

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

다음은 최소한의 메타데이터를 사용하는 작업에 대한 샘플 JSON 응답 본문입니다 Query Tables .

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

다음은 메타데이터가 없는 작업에 대한 Query Tables 샘플 JSON 응답 본문입니다.

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

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

작업에 대한 샘플 Atom 응답 본문은 Query Tables 다음과 같습니다.

<?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 Storage에 대한 쿼리는 한 번에 최대 1,000개의 테이블을 반환하고 최대 5초 동안 실행할 수 있습니다. 응답에는 다음 경우 연속 토큰을 x-ms-continuation-NextTableName 포함하는 사용자 지정 헤더가 포함됩니다.

결과 집합에는 1,000개 이상의 테이블이 포함되어 있습니다.
쿼리가 5초 이내에 완료되지 않았습니다.
쿼리가 파티션 경계를 교차 합니다.

연속을 사용하여 다음 데이터 페이지에 대한 후속 요청을 생성할 수 있습니다. 연속 토큰에 대한 자세한 내용은 쿼리 시간 제한 및 페이지 매김을 참조하세요.

참고

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

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

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

쿼리 예약 및 처리 요청에 할당된 총 시간은 30초입니다. 이 합계에는 쿼리 실행에 대한 5초가 포함됩니다.

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

추가 정보

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