查詢 Blob 內容

此Query Blob Contents作業會在 Blob 的內容上套用簡單的 結構化查詢語言 (SQL) (SQL) 語句，並只傳回查詢的數據子集。 您也可以呼叫 Query Blob Contents 來查詢版本或快照集的內容。

要求

您可以建構 Query Blob Contents 要求，如下所示。 我們建議使用 HTTPS。 以記憶體帳戶的名稱取代 myaccount 。

URI 參數

您可以在要求 URI 上指定下列其他參數：

要求標頭

下表描述必要和選擇性的要求標頭：

只有在符合指定的條件時，此作業也支援使用條件標頭來查詢 Blob 內容。 如需詳細資訊，請參閱 指定 Blob 記憶體作業的條件式標頭。

要求本文

此版本 Query Blob Contents 的要求本文會使用下列 XML 格式：

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

下表說明要求主體的項目：

回應

回應包括 HTTP 狀態碼、一組回應標頭和回應主體。 回應本文是 Avro 二進位格式。 因為響應內容長度未知，所以回應會以區塊編碼進行串流處理。

狀態碼

如果查詢要求格式良好且已獲得授權，則作業會傳回狀態代碼 202 (已接受) 。 回應串流期間發生的任何錯誤或進度訊息都會傳回作為回應本文的一部分。

如需狀態代碼的相關信息，請參閱 狀態和錯誤碼。

回應標頭

這項作業的回應包括下列標頭。 回應也可能包含其他標準 HTTP 標頭。 所有標準標頭都符合 HTTP/1.1 通訊協議規格。

回應本文

回應本文包含以 Avro 二進位格式傳送為一系列訊息的 Blob 篩選內容。 它會使用下列架構：

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

範例回應

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

授權

在 Azure 記憶體中呼叫任何數據存取作業時，需要授權。 您可以授權 Query Blob Contents 作業，如下所示。

備註

• 只有在 Query Blob Contents 類型上 BlockBlob 才支援此作業。
• 此版本的 API 不支援查詢使用客戶提供的金鑰加密的 Blob 內容。
• 已啟用 基礎結構加密 的帳戶中的 Blob 不支援此作業。
• 擷取屬於私人容器的 Blob 時，需要 x-ms-version 標頭。 如果 Blob 屬於可供完整或部分公開存取的容器，則任何用戶端都可以讀取它，而不需要指定版本。 擷取屬於公用容器的 Blob 不需要服務版本。 如需詳細資訊，請參閱限制對容器和 Blob 的存取。
• 您可以使用 Query Blob Contents 作業來查詢具有分隔符/CSV 或 JSON 格式的物件。

計費

定價要求可能源自使用 Blob 記憶體 API 的用戶端，無論是直接透過 Blob 記憶體 REST API，還是來自 Azure 記憶體用戶端連結庫。 這些要求會累算每個交易的費用。 交易類型會影響帳戶的收費方式。 例如，讀取交易會累算到與寫入交易不同的計費類別。 下表顯示根據記憶體帳戶類型的要求計費類別 Query Blob Contents ：

¹除了讀取費用之外，帳戶還會產生 查詢加速 - 數據掃描 和 查詢加速 - 數據傳回 交易類別的費用。 這些類別的定價會出現在 [Azure Data Lake Storage 定價] 頁面上。

另請參閱

授權對 Azure 記憶體狀態的要求和錯誤碼Blob 記憶體錯誤碼設定 Blob 記憶體作業查詢加速的逾時：SQL 語言參考