Sorgu Blobu İçeriği

İşlem, Query Blob Contents blobun içeriğine basit bir Yapılandırılmış Sorgu Dili (SQL) deyimi uygular ve verilerin yalnızca sorgulanan alt kümesini döndürür. Bir sürümün veya anlık görüntünün içeriğini sorgulamak için de çağrısı Query Blob Contents yapabilirsiniz.

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz Query Blob Contents . HTTPS kullanmanızı öneririz. myaccount değerini depolama hesabınızın adıyla değiştirin.

URI parametreleri

İstek URI'sinde aşağıdaki ek parametreleri belirtebilirsiniz:

İstek üst bilgileri

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır:

Bu işlem, yalnızca belirtilen bir koşul karşılandığında blob içeriğini sorgulamak için koşullu üst bilgilerin kullanımını da destekler. Daha fazla bilgi için bkz. Blob Depolama işlemleri için koşullu üst bilgileri belirtme.

İstek gövdesi

bu sürümü Query Blob Contents için istek gövdesi aşağıdaki XML biçimini kullanır:

<?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>

Aşağıdaki tabloda istek gövdesinin öğeleri açıklanmaktadır:

Yanıt

Yanıt bir HTTP durum kodu, yanıt üst bilgileri kümesi ve yanıt gövdesini içerir. Yanıt gövdesi Avro ikili biçimindedir. Yanıt içerik uzunluğu bilinmediğinden, yanıt öbekli kodlama ile akışa aktarılır.

Durum kodu

Sorgu isteği iyi biçimlendirilmiş ve yetkilendirilmişse, işlem 202 (Kabul Edildi) durum kodunu döndürür. Yanıt akışı sırasında karşılaşılan hatalar veya ilerleme iletileri yanıt gövdesinin bir parçası olarak döndürülür.

Durum kodları hakkında bilgi için bkz. Durum ve hata kodları.

Yanıt üst bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt, ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt gövdesi

Yanıt gövdesi, Avro ikili biçiminde bir dizi ileti olarak gönderilen blobun filtrelenmiş içeriğini içerir. Aşağıdaki şemayı kullanır:

{
    "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.  If false, this error does not prevent further query processing."
      },
      {
        "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"
      }
    ]
  }
]

Örnek yanıt

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

Yetkilendirme

Azure Depolama'da herhangi bir veri erişimi işlemi çağrılırken yetkilendirme gereklidir. İşlemi aşağıda açıklandığı gibi yetki Query Blob Contents verebilirsiniz.

Açıklamalar

• İşlem Query Blob Contents yalnızca bir BlockBlob tür üzerinde desteklenir.
• Müşteri tarafından sağlanan anahtarlarla şifrelenmiş bir blobun içeriğini sorgulamak API'nin bu sürümünde desteklenmez.
• Bu işlem, altyapı şifrelemesi etkinleştirilmiş hesaplardaki bloblarda desteklenmez.
• Üst x-ms-version bilgi, özel bir kapsayıcıya ait bir blobu almak için gereklidir. Blob tam veya kısmi genel erişim için kullanılabilen bir kapsayıcıya aitse, herhangi bir istemci bir sürüm belirtmeden bu kapsayıcıyı okuyabilir. Genel kapsayıcıya ait bir blobu almak için hizmet sürümü gerekli değildir. Daha fazla bilgi için bkz. Kapsayıcılara ve blob'lara erişimi kısıtlama.
• yalnızca sınırlandırılmış/CSV veya JSON biçimine sahip nesneleri sorgulamak için işlemini kullanabilirsiniz Query Blob Contents .

Faturalama

Fiyatlandırma istekleri, Blob Depolama API'lerini kullanan istemcilerden, doğrudan Blob Depolama REST API'si aracılığıyla veya bir Azure Depolama istemci kitaplığından kaynaklanabilir. Bu istekler işlem başına ücret tahakkuk eder. İşlem türü, hesabın ücretlendirilmeyi etkiler. Örneğin, okuma işlemleri yazma işlemlerinden farklı bir faturalama kategorisine tahakkuk eder. Aşağıdaki tabloda, depolama hesabı türüne göre istekler için Query Blob Contents faturalama kategorisi gösterilmektedir:

¹Okuma ücretine ek olarak, hesap Sorgu Hızlandırma - Taranan Veriler ve Sorgu Hızlandırma - Döndürülen Veriler işlem kategorileri için ücretlendirilir. Bu kategorilerin fiyatlandırması Azure Data Lake Storage fiyatlandırma sayfasında görünür.

Ayrıca bkz.

Azure Depolama Durumu ve hata kodlarınayönelik istekleri yetkilendirmeBlob Depolama hata kodları Blob Depolamaişlemleri için zaman aşımlarını ayarlamaSorgu hızlandırma: SQL dil başvurusu