Blob 내용 쿼리Query Blob Contents

Query Blob ContentsAPI는 blob 내용에 단순 구조적 쿼리 언어 (SQL) 문을 적용 하 고 데이터의 쿼리 된 하위 집합만 반환 합니다.The Query Blob Contents API applies a simple Structured Query Language (SQL) statement on a blob's contents and returns only the queried subset of the data. Query Blob Contents을 호출 하 여 버전이 나 스냅숏의 콘텐츠를 쿼리할 수도 있습니다.You can also call Query Blob Contents to query the contents of a version or snapshot.

요청Request

다음과 같이 Query Blob Contents 요청을 생성할 수 있습니다.The Query Blob Contents request may be constructed as follows. HTTPS를 사용하는 것이 좋습니다.HTTPS is recommended. Myaccount 을 사용자의 저장소 계정 이름으로 바꿉니다.Replace myaccount with the name of your storage account:

POST 메서드 요청 URIPOST Method Request URI HTTP 버전HTTP Version
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=query

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=query&snapshot=<DateTime>

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=query&versionid=<DateTime>
HTTP/1.0HTTP/1.0

HTTP/1.1HTTP/1.1

URI 매개 변수URI Parameters

요청 URI에 다음과 같은 추가 매개 변수를 지정할 수 있습니다.The following additional parameters may be specified on the request URI.

매개 변수Parameter DescriptionDescription
snapshot 선택 사항입니다.Optional. 스냅숏 매개 변수는 불투명 DateTime 값 이며, 있는 경우 쿼리할 blob 스냅숏을 지정 합니다.The snapshot parameter is an opaque DateTime value that, when present, specifies the blob snapshot to query. Blob 스냅숏을 사용 하는 방법에 대 한 자세한 내용은 blob의 스냅숏 만들기를 참조 하세요.For more information on working with blob snapshots, see Creating a Snapshot of a Blob.
versionid 선택 사항, 버전 2019-12-12 이상.Optional, version 2019-12-12 and newer. 이 매개 변수는 있는 경우 검색할 blob의 버전을 지정 하는 불투명 날짜/시간 값입니다.The versionid parameter is an opaque DateTime value that, when present, specifies the Version of the blob to retrieve.
timeout 선택 사항입니다.Optional. timeout 매개 변수는 초 단위로 표시됩니다.The timeout parameter is expressed in seconds. 자세한 내용은 Blob 서비스 작업에 대 한 시간 제한 설정을 참조 하세요.For more information, see Setting Timeouts for Blob Service Operations.

요청 헤더Request Headers

다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.The following table describes required and optional request headers.

요청 헤더Request Header 설명Description
Authorization 필수 요소.Required. 인증 체계, 계정 이름 및 서명을 지정합니다.Specifies the authentication scheme, account name, and signature. 자세한 내용은 Azure Storage Services에 대 한 인증을 참조 하세요.For more information, see Authentication for the Azure Storage Services.
Date 또는 x-ms-dateDate or x-ms-date 필수 요소.Required. 요청에 대한 UTC(협정 세계시)를 지정합니다.Specifies the Coordinated Universal Time (UTC) for the request. 자세한 내용은 Azure Storage Services에 대 한 인증을 참조 하세요.For more information, see Authentication for the Azure Storage Services.
x-ms-version 인증된 모든 요청의 경우 필수이고, 익명 요청의 경우에는 선택 사항입니다.Required for all authenticated requests, optional for anonymous requests. 이 요청에 사용할 작업의 버전을 지정합니다.Specifies the version of the operation to use for this request. 자세한 내용은 Azure Storage Services에 대 한 버전 관리를 참조 하세요.For more information, see Versioning for the Azure Storage Services.
Content-Type 필수 요소.Required. 이 헤더의 값은 application/xml 이어야 합니다. charset = UTF-8.The value of this header should be application/xml; charset=UTF-8.
x-ms-lease-id:<ID> 선택 사항입니다.Optional. 이 헤더가 지정되었으면 다음 조건이 모두 충족될 경우에만 작업이 수행됩니다.If this header is specified, the operation will be performed only if both of the following conditions are met:

-Blob의 임대가 현재 활성 상태입니다.- The blob's lease is currently active.
-요청에 지정 된 임대 ID가 blob의 임대 ID와 일치 합니다.- The lease ID specified in the request matches that of the blob.

이 헤더가 지정되었고 이들 조건이 모두 충족되지 않으면 요청이 실패하고 Query Blob Contents 작업이 실패하며 상태 코드 412(전제 조건 실패)가 표시됩니다.If this header is specified and both of these conditions are not met, the request will fail and the Query Blob Contents operation will fail with status code 412 (Precondition Failed).
Origin 선택 사항입니다.Optional. 요청을 실행한 원본을 지정합니다.Specifies the origin from which the request is issued. 이 헤더가 있으면 응답에 CORS(크로스-원본 자원 공유) 헤더가 생성됩니다.The presence of this header results in cross-origin resource sharing (CORS) headers on the response.
x-ms-client-request-id 선택 사항입니다.Optional. 저장소 분석 로깅을 사용 하도록 설정한 경우 분석 로그에 기록 되는 1 KiB 문자 제한이 있는 클라이언트 생성 불투명 값을 제공 합니다.Provides a client-generated, opaque value with a 1 KiB character limit that is recorded in the analytics logs when storage analytics logging is enabled. 이 헤더를 사용하면 클라이언트 쪽 작업을 서버에서 받은 요청과 관련시키는 것이 좋습니다.Using this header is highly recommended for correlating client-side activities with requests received by the server. 자세한 내용은 스토리지 분석 로깅Azure 로깅: 로그를 사용 하 여 저장소 요청 추적을 참조 하세요.For more information, see About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests.

이 작업은 또한 지정 된 조건이 충족 될 경우에만 blob 콘텐츠를 쿼리 하는 조건부 헤더 사용을 지원 합니다.This operation also supports the use of conditional headers to query the blob contents only if a specified condition is met. 자세한 내용은 Blob 서비스 작업의 조건부 헤더 지정을 참조하세요.For more information, see Specifying Conditional Headers for Blob Service Operations.

요청 본문Request Body

이 버전의 Query Blob Contents에 대한 요청 본문에는 다음과 같은 XML 형식이 사용됩니다.The request body for this version of Query Blob Contents uses following XML format:

<?xml version="1.0" encoding="utf-8"?>  
<QueryRequest>
  <QueryType>String</QueryType>
  <Expression>String</Expression>
  <InputSerialization>
    <Format>
      <Type>String</Type>
          <DelimitedTextConfiguration>
            <ColumnSeparator>String</ColumnSeparator>
            <FieldQuote>String</FieldQuote>
            <RecordSeparator>String</RecordSeparator>
            <EscapeChar>String</EscapeChar>
            <HasHeaders>Boolean</HasHeaders>
          </DelimitedTextConfiguration>
          <JsonTextConfiguration>
            <RecordSeparator>String</RecordSeparator>
          </JsonTextConfiguration>
    </Format>
  </InputSerialization>
  <OutputSerialization>
    <Format>
      <Type>String</Type>
      <DelimitedTextConfiguration>
        <ColumnSeparator>String</ColumnSeparator >
        <FieldQuote>String</FieldQuote >
        <RecordSeparator>String</RecordSeparator>
        <EscapeChar>String</EscapeChar>
        <HasHeaders>Boolean</HasHeaders>
      </DelimitedTextConfiguration>
      <JsonTextConfiguration>
        <RecordSeparator>String</RecordSeparator>
      </JsonTextConfiguration>
      <ArrowConfiguration>
        <Schema>
            <Field>
                <Type>String</Type>
                <Name>String</Name>
            </Field>
            <Field>
                <Type>String</Type>
            </Field>
                .
                .
                .
            <Field>
                <Type>String</Type>
                <Precision>Integer</Precision>
                <Scale>Integer</Scale>
            </Field>
        </Schema>
      </ArrowConfiguration>
    </Format>
  </OutputSerialization>
</QueryRequest>

다음 표에서는 요청 본문의 요소에 대해 설명합니다.The following table describes the elements of the request body:

요소 이름Element Name 설명Description
QueryRequestQueryRequest 필수 요소.Required. 쿼리 요청 설정 집합을 그룹화 합니다.Groups the set of query request settings.
QueryTypeQueryType 필수 요소.Required. 제공 된 쿼리 식의 형식입니다.The type of the provided query expression. 현재 버전의 유효한 값은 뿐 SQL 입니다.The only valid value for the current version is SQL.
Expression 필수 요소.Required. SQL의 쿼리 식입니다.The query expression in SQL. 쿼리 식의 최대 크기는 256KiB입니다.The maximum size of the query expression is 256KiB. 식 구문에 대 한 자세한 내용은 쿼리 가속: SQL 언어 참조를 참조 하세요.For more information about the expression syntax, please see Query Acceleration: SQL Language Reference.
InputSerializationInputSerialization 선택 사항입니다.Optional. Blob 콘텐츠의 입력 직렬화와 관련 된 설정을 그룹화 합니다.Groups the settings regarding the input serialization of the blob contents. 지정 하지 않으면 구분 기호로 분리 된 텍스트 구성이 사용 됩니다.If not specified, the delimited text configuration will be used.
FormatFormat Inputserialization 이 지정 된 경우 필수 사항입니다.Required if InputSerialization is specified. Blob 데이터의 형식에 대 한 설정을 그룹화 합니다.Groups the settings regarding the format of the blob data.
TypeType Inputserialization 이 지정 된 경우 필수 사항입니다.Required if InputSerialization is specified. 형식 형식입니다. 유효한 값은 delimited , csv 또는 json 입니다.The format type; valid values are delimited, csv, or json.
DelimitedTextConfigurationDelimitedTextConfiguration 선택 사항입니다.Optional. Blob이 분리 된 텍스트 형식이 면 blob 데이터를 해석 하는 데 사용 되는 설정을 그룹화 합니다.Groups the settings used for interpreting the blob data if the blob is delimited text formatted.
ColumnSeparatorColumnSeparator 선택 사항입니다.Optional. 열을 구분 하는 데 사용 되는 문자열입니다.The string used to separate columns.
FieldQuoteFieldQuote 선택 사항입니다.Optional. 특정 필드를 따옴표로 묶는 데 사용 되는 문자열입니다.The string used to quote a specific field.
RecordSeparatorRecordSeparator 선택 사항입니다.Optional. 레코드를 구분 하는 데 사용 되는 문자열입니다.The string used to separate records.
EscapeCharEscapeChar 선택 사항입니다.Optional. 이스케이프 문자로 사용 되는 문자열입니다.The string used as an escape character.
HasHeadersHasHeaders 선택 사항입니다.Optional. 데이터에 머리글이 있는지 여부를 나타내는 부울입니다.Boolean representing whether the data has headers.
JsonTextConfigurationJsonTextConfiguration 선택 사항입니다.Optional. Blob이 JSON 형식으로 지정 된 경우 blob 데이터를 해석 하는 데 사용 되는 설정을 그룹화 합니다.Groups the settings used for interpreting the blob data if the blob is JSON formatted.
RecordSeparatorRecordSeparator 선택 사항입니다.Optional. 레코드를 구분 하는 데 사용 되는 문자열입니다.The string used to separate records.
OutputSerializationOutputSerialization 선택 사항입니다.Optional. 응답에서 반환 된 blob의 필터링 된 콘텐츠의 serialization 형식입니다.The serialization format of the filtered contents of the blob returned in the response. 지정 하지 않으면 구분 기호로 분리 된 텍스트 구성이 사용 됩니다.If not specified, the delimited text configuration will be used.
FormatFormat Outputserialization 이 지정 된 경우 필수 사항입니다.Required if OutputSerialization is specified. 반환 된 응답의 형식에 대 한 설정을 그룹화 합니다.Groups the settings regarding the format of the response returned.
TypeType Outputserialization 이 지정 된 경우 필수 사항입니다.Required if OutputSerialization is specified. 형식 형식입니다. 유효한 값은 delimited , csv , json 또는 arrow 입니다.The format type; valid values are delimited, csv, json, or arrow.
DelimitedTextConfigurationDelimitedTextConfiguration 선택 사항입니다.Optional. 응답을 구분 기호로 분리 된 텍스트 형식으로 지정 하는 경우 응답의 형식을 지정 하는 데 사용 되는 설정을 그룹화 합니다.Groups the settings used for formatting the response if the response should be delimited text formatted.
ColumnSeparatorColumnSeparator 선택 사항입니다.Optional. 열을 구분 하는 데 사용 되는 문자열입니다.The string used to separate columns.
FieldQuoteFieldQuote 선택 사항입니다.Optional. 특정 필드를 따옴표로 묶는 데 사용 되는 문자열입니다.The string used to quote a specific field.
RecordSeparatorRecordSeparator 선택 사항입니다.Optional. 레코드를 구분 하는 데 사용 되는 문자열입니다.The string used to separate records.
EscapeCharEscapeChar 선택 사항입니다.Optional. 이스케이프 문자로 사용 되는 문자열입니다.The string used as an escape character.
HasHeadersHasHeaders 선택 사항입니다.Optional. 데이터에 머리글이 있는지 여부를 나타내는 부울입니다.Boolean representing whether the data has headers.
JsonTextConfigurationJsonTextConfiguration 선택 사항입니다.Optional. 응답이 JSON 형식 이어야 하는 경우 응답의 형식을 지정 하는 데 사용 되는 설정을 그룹화 합니다.Groups the settings used for formatting the response if the response should be JSON formatted.
RecordSeparatorRecordSeparator 선택 사항입니다.Optional. 레코드를 구분 하는 데 사용 되는 문자열입니다.The string used to separate records.
ArrowConfigurationArrowConfiguration 선택 사항입니다.Optional. 응답의 형식을 지정 하는 데 사용 되는 설정을 그룹화 합니다.Groups the settings used for formatting the response if the response should be Arrow formatted.
스키마Schema ArrowConfiguration 가 지정 된 경우 필수 사항입니다.Required if ArrowConfiguration is specified. 반환 된 화살표 응답의 스키마에 대 한 설정을 그룹화 합니다.Groups the settings regarding the schema of the Arrow response returned.
필드Field 선택 사항입니다.Optional. 특정 필드에 대 한 설정을 그룹화 합니다.Groups settings regarding a specific field.
TypeType Field 가 지정 된 경우 필수입니다.Required if Field is specified. 필드 형식입니다. 유효한 값은 Int , Float , Decimal 또는 Bool 입니다.The field type; valid values are Int, Float, Decimal, or Bool.
정밀도Precision 선택 사항입니다.Optional. 필드의 전체 자릿수입니다.The precision of the field.
크기 조정Scale 선택 사항입니다.Optional. 필드의 소수 자릿수입니다.The scale of the field.

응답Response

응답에는 HTTP 상태 코드, 응답 헤더 집합 및 응답 본문이 포함되어 있습니다.The response includes an HTTP status code, a set of response headers, and the response body. 응답 본문의 Avro\Binary 형식은입니다.The response body is in Avro\Binary format. 응답 콘텐츠 길이를 알 수 없으므로 응답이 청크 분할 인코딩으로 스트리밍됩니다.Since the response content length is unknown, the response is streamed with chunked encoding.

상태 코드Status Code

쿼리 요청이 올바르게 구성 되 고 권한이 부여 된 경우 작업은 상태 코드 202 (수락 됨)를 반환 합니다.If the query request is well-formed and authorized then the operation returns status code 202 (Accepted). 응답 스트리밍 중에 발생 한 오류 또는 진행 메시지는 응답 본문의 일부로 반환 됩니다.Any errors or progress messages encountered during the response streaming will be returned as a part of the response body.

상태 코드에 대 한 자세한 내용은 상태 및 오류 코드를 참조 하세요.For information about status codes, see Status and Error Codes.

응답 헤더Response Headers

이 작업의 응답에는 다음과 같은 헤더가 포함됩니다.The response for this operation includes the following headers. 응답에는 추가 표준 HTTP 헤더가 포함될 수도 있습니다.The response may also include additional standard HTTP headers. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을따릅니다.All standard headers conform to the HTTP/1.1 protocol specification.

구문Syntax DescriptionDescription
Last-Modified Blob을 마지막으로 수정한 날짜/시간입니다.The date/time that the blob was last modified. 날짜 형식은 RFC 1123을 따릅니다.The date format follows RFC 1123.

blob의 메타데이터 또는 속성에 대한 업데이트를 포함하여 Blob을 수정하는 모든 작업은 수행할 경우 blob의 마지막 수정 시간이 변경됩니다.Any operation that modifies the blob, including an update of the blob's metadata or properties, changes the last-modified time of the blob.
Content-Type 결과가 반환될 형식을 지정합니다.Specifies the format in which the results are returned. 현재 이 값은 avro/binary입니다.Currently this value is avro/binary.
ETag ETag에는 조건에 따라 작업을 수행하는 데 사용할 수 있는 값이 포함됩니다.The ETag contains a value that you can use to perform operations conditionally. 자세한 내용은 Blob 서비스 작업에 대 한 조건부 헤더 지정 을 참조 하세요.See Specifying Conditional Headers for Blob Service Operations for more information. 요청 버전이 2011-08-18 이상이면 ETag 값이 따옴표로 표시됩니다.If the request version is 2011-08-18 or newer, the ETag value will be in quotes.
Content-Encoding 이 헤더는 Content-Encoding 요청 헤더에 대해 지정된 값을 반환합니다.This header returns the value that was specified for the Content-Encoding request header.
Content-Language 이 헤더는 Content-Language 요청 헤더에 대해 지정된 값을 반환합니다.This header returns the value that was specified for the Content-Language request header.
Cache-Control 이전에 blob에 대해 지정된 경우 이 헤더가 반환됩니다.This header is returned if it was previously specified for the blob.
Content-Disposition 버전 2013-08-15 이상에 대한 요청에 대해 반환됩니다.Returned for requests against version 2013-08-15 and later. 이 헤더는 x-ms-blob-content-disposition 헤더에 대해 지정된 값을 반환합니다.This header returns the value that was specified for the x-ms-blob-content-disposition header.

Content-Disposition 응답 헤더 필드는 응답 페이로드를 처리하는 방법에 대한 추가 정보를 제공하고 추가 메타데이터를 연결하는 데도 사용할 수 있습니다.The Content-Disposition response header field conveys additional information about how to process the response payload, and also can be used to attach additional metadata. 예를 들어 attachment로 설정되는 경우 사용자 에이전트가 응답을 표시하지 않는 대신 지정된 blob 이름이 아닌 파일 이름으로 다른 이름으로 저장 대화 상자를 표시해야 함을 나타냅니다.For example, if set to attachment, it indicates that the user-agent should not display the response, but instead show a Save As dialog with a filename other than the blob name specified.
x-ms-blob-type: <BlockBlob> blob의 유형을 반환합니다.Returns the blob's type.
x-ms-request-id 이 헤더는 수행된 요청을 고유하게 식별하며, 이 헤더를 사용해서 요청 문제를 해결할 수 있습니다.This header uniquely identifies the request that was made and can be used for troubleshooting the request. 자세한 내용은 API 작업 문제 해결을 참조 하세요.For more information, see Troubleshooting API Operations.
x-ms-version 요청을 실행하는 데 사용되는 Blob 서비스의 버전을 나타냅니다.Indicates the version of the Blob service used to execute the request. 2009-09-19 버전 이상을 사용하여 수행된 요청에 포함됩니다.Included for requests made using version 2009-09-19 and newer.

Blob 서비스의 2009-09-19 버전을 사용해서 컨테이너가 공용 액세스용으로 표시된 경우 지정된 버전이 없는 익명 요청에 대해서도 이 헤더가 반환됩니다.This header is also returned for anonymous requests without a version specified if the container was marked for public access using the 2009-09-19 version of the Blob service.
Date 응답이 시작된 시간을 나타내는 서비스에서 생성된 UTC 날짜/시간 값입니다.A UTC date/time value generated by the service that indicates the time at which the response was initiated.
Access-Control-Allow-Origin 요청에 Origin 헤더가 포함되고 CORS가 일치 규칙과 함께 설정된 경우 반환됩니다.Returned if the request includes an Origin header and CORS is enabled with a matching rule. 일치할 경우 이 헤더는 원본 요청 헤더의 값을 반환합니다.This header returns the value of the origin request header in case of a match.
Access-Control-Expose-Headers 요청에 Origin 헤더가 포함되고 CORS가 일치 규칙과 함께 설정된 경우 반환됩니다.Returned if the request includes an Origin header and CORS is enabled with a matching rule. 클라이언트 또는 요청 실행자에 노출될 응답 헤더의 목록을 반환합니다.Returns the list of response headers that are to be exposed to the client or issuer of the request.
Vary CORS 규칙이 지정된 경우 Origin 헤더의 값과 함께 반환됩니다.Returned with the value of the Origin header when CORS rules are specified. 자세한 내용은 저장소 서비스에 대 한 CORS 지원 을 참조 하세요.See CORS Support for the Storage Services for details.
Access-Control-Allow-Credentials 요청에 Origin 헤더가 포함되고 CORS가 모든 원본을 허용하지 않는 일치 규칙과 함께 설정된 경우 반환됩니다.Returned if the request includes an Origin header and CORS is enabled with a matching rule that doesn’t allow all origins. 이 헤더는 true로 설정됩니다.This header will be set to true.
x-ms-blob-committed-block-count Blob에 있는 커밋된 블록 수입니다.The number of committed blocks present in the blob. 이 헤더는 추가 blob에 대해서만 반환 됩니다.This header is returned only for append blobs.
x-ms-server-encrypted: true/false 2015-12-11 이상 버전Version 2015-12-11 or newer. true지정 된 알고리즘을 사용 하 여 blob 데이터 및 응용 프로그램 메타 데이터를 완전히 암호화 하는 경우이 헤더의 값은로 설정 됩니다.The value of this header is set to true if the blob data and application metadata are completely encrypted using the specified algorithm. 그렇지 않으면이 값은로 설정 됩니다 false (blob이 암호화 되지 않은 경우 또는 blob/응용 프로그램 메타 데이터의 일부만 암호화 된 경우).Otherwise, the value is set to false (when the blob is unencrypted, or if only parts of the blob/application metadata are encrypted).

응답 본문Response Body

응답 본문에는 다음 스키마를 따라 Avro 이진 형식의 일련의 메시지로 보낸 blob의 필터링 된 내용이 포함 됩니다.The response body contains the filtered contents of the blob sent as a series of messages in Avro Binary format following the below schema.

{"type": "record", "name": ".com. \Omcontents. resultData", "doc": "이 쿼리에 대해 지정 된 형식으로 결과 데이터를 저장 합니다 (CSV, JSON 등).", "fields": [{"name": "data", "type": "bytes"}]}, {"type": "record", "name": "com.. c o m. c o m. c o m. c o m. c o m e. c o m. c o m e. c o m. c l e": "쿼리를 처리 하는 동안 오류가 발생 했습니다.", "fields": [{"name": "치명적"{ "type": "record", "name": "com.microsoft.azure.storage.queryBlobContents.resultData", "doc": "Holds result data in the format specified for this query (CSV, JSON, etc.).", "fields": [ { "name": "data", "type": "bytes" } ] }, { "type": "record", "name": "com.microsoft.azure.storage.queryBlobContents.error", "doc": "An error that occurred while processing the query.", "fields": [ { "name": "fatal", "type": "boolean", "doc": "If true, this error prevents further query processing. 더 많은 결과 데이터가 반환 될 수 있지만 모든 원본 데이터가 처리 되는 것은 아닙니다.More result data may be returned, but there is no guarantee that all of the original data will be processed. False 이면이 오류로 인해 쿼리를 추가로 처리할 수 없습니다. "If false, this error does not prevent further query processing." }, {"name": "name", "type": "string", "doc": "오류 이름"}, {"name": "description", "type": "string", "doc": "오류에 대 한 설명"}, {"name": "position", "type": "long", "doc": "오류가 발생 한 blob 오프셋"}]}, {"type": "record", "name": ".com", "doc": "쿼리 진행에 대 한 정보", "fields": [{"name": "bytesScanned", "type": "long", "doc": "검색 된 바이트 수"}, {"name": "totalBytes" , "type": "long", "doc": "이 쿼리에서 검색 되는 총 바이트 수"}]}, {"type": "record", "name": ".com. microsoft. azure. 저장소. queryBlobContents. end", "doc": "를 응답의 마지막 메시지로 보내 모든 결과가 전송 되었음을 나타냅니다.", "fields": [{"name": "totalBytes", "type": "long", "doc": "이 쿼리에서 검색 되는 총 바이트 수"}]}]}, { "name": "name", "type": "string", "doc": "The name of the error" }, { "name": "description", "type": "string", "doc": "A description of the error" }, { "name": "position", "type": "long", "doc": "The blob offset at which the error occurred" } ] }, { "type": "record", "name": "com.microsoft.azure.storage.queryBlobContents.progress", "doc": "Information about the progress of the query", "fields": [ { "name": "bytesScanned", "type": "long", "doc": "The number of bytes that have been scanned" }, { "name": "totalBytes", "type": "long", "doc": "The total number of bytes to be scanned in this query" } ] }, { "type": "record", "name": "com.microsoft.azure.storage.queryBlobContents.end", "doc": "Sent as the final message of the response, indicating that all results have been sent.", "fields": [ { "name": "totalBytes", "type": "long", "doc": "The total number of bytes to be scanned in this query" } ] } ]

샘플 응답Sample Response

      "StatusCode": 200,
      "ResponseHeaders": {
        "Content-Type": "avro/binary",
        "Date": "Fri, 24 Apr 2020 20:25:42 GMT",
        "ETag": "\u00220x8D7E88DA9C0A75B\u0022",
        "Last-Modified": "Fri, 24 Apr 2020 20:25:43 GMT",
        "Transfer-Encoding": "chunked",
        "x-ms-blob-type": "BlockBlob",
        "x-ms-client-request-id": "f6d1983c-55e5-9f95-6d3d-80d74862d99e",
        "x-ms-creation-time": "Fri, 24 Apr 2020 20:25:43 GMT",
        "x-ms-lease-state": "available",
        "x-ms-lease-status": "unlocked",
        "x-ms-request-id": "46c09ab1-b01e-0001-1076-1acef2000000",
        "x-ms-version": "2019-12-12"
    },
    "ResponseBody":{...}
  

권한 부여Authorization

컨테이너의 ACL(액세스 제어 목록)이 blob에 대한 익명 액세스를 허용하도록 설정된 경우 클라이언트가 이 작업을 호출할 수 있습니다.If the container's access control list (ACL) is set to allow anonymous access to the blob, any client may call this operation. 컨테이너가 전용 컨테이너인 경우 계정 소유자 및 blob 읽기 권한이 있는 공유 액세스 서명을 갖는 모든 사용자가 이 작업을 수행할 수 있습니다.If the container is private, this operation can be performed by the account owner and by anyone with a Shared Access Signature that has permission to read the blob.

설명Remarks

  • Query Blob ContentsAPI는 BlockBlob 유형에만 지원 됩니다.Query Blob Contents API is only supported on BlockBlob type.
  • 고객 공급자 키로 암호화 된 blob의 콘텐츠 쿼리는이 API 버전에서 지원 되지 않습니다.Querying the contents of a blob which is encrypted with Customer Provider Keys is not supported in this version of the API.
  • 전용 컨테이너에 속하는 Blob을 검색하려면 x-ms-version 헤더가 필요합니다.The x-ms-version header is required to retrieve a blob that belongs to a private container. blob가 전체 또는 일부 공용 액세스에 사용할 수 있는 컨테이너에 속하는 경우 버전을 지정하지 않고도 모든 클라이언트가 이를 읽을 수 있습니다. 공용 컨테이너에 속하는 Blob을 검색할 때는 서비스 버전이 필요하지 않습니다.If the blob belongs to a container that is available for full or partial public access, any client can read it without specifying a version; the service version is not required for retrieving a blob that belongs to a public container. 자세한 내용은 컨테이너 및 Blob에 대한 액세스 제한 을 참조하세요.See Restrict Access to Containers and Blobs for more information.
  • Query Blob ContentsAPI는 또는 형식이 인 개체만 쿼리 하는 데 사용할 수 있습니다 Delimited/CSV JSON .Query Blob Contents API can be used to query only objects that have Delimited/CSV or JSON format.

참고 항목See Also

Azure Storage 서비스에 대 한 인증 Authentication for the Azure Storage Services
상태 및 오류 코드 Status and Error Codes
Blob 서비스 오류 코드 Blob Service Error Codes
Blob 서비스 작업에 대 한 시간 제한 설정 쿼리 가속: SQL 언어 참조Setting Timeouts for Blob Service Operations Query Acceleration: SQL Language Reference