查詢資料表

發行項
08/05/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

儲存體模擬器中的資料表服務有數種方式與 Azure 資料表儲存體不同。如需詳細資訊，請參閱儲存體模擬器和 Azure 儲存體服務之間的差異。

URI 參數

作業 Query Tables 支援 OData 通訊協定規格所定義的查詢選項。

要求標頭

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

要求標頭	描述
`Authorization`	必要。指定授權配置、帳戶名稱和簽章。如需詳細資訊，請參閱授權對 Azure 儲存體提出要求。
`Date` 或 `x-ms-date`	必要。指定要求的「國際標準時間」(UTC)。如需詳細資訊，請參閱授權對 Azure 儲存體提出要求。
`x-ms-version`	選擇性。指定用於這個要求的作業版本。如需詳細資訊，請參閱 Azure 儲存體服務的版本。
`Accept`	選擇性。指定接受的回應裝載內容類型。可能的值包括： - `application/atom+xml` (2015-12-11 之前的) - `application/json;odata=nometadata` - `application/json;odata=minimalmetadata` - `application/json;odata=fullmetadata` 如需詳細資訊，請參閱資料表儲存體作業的承載格式。
`x-ms-client-request-id`	選擇性。提供用戶端產生的不透明值，其中包含設定記錄時記錄的 1 kibibyte (KiB) 字元限制。強烈建議您使用此標頭，將用戶端活動與伺服器接收的要求相互關聯。

要求本文

無。

回應

回應包括 HTTP 狀態碼、一組回應標頭和回應主體。

狀態碼

成功的作業會傳回狀態碼 200 (OK)。

如需狀態碼的相關資訊，請參閱狀態和錯誤碼和資料表儲存體錯誤碼。

回應標頭

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

回應標頭	描述
`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` 如需有效內容類型的詳細資訊，請參閱資料表儲存體作業的承載格式。
`x-ms-client-request-id`	可用來針對要求和對應的回應進行疑難排解。如果此標頭存在於要求中，且此值最多為 1，024 個可見的 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"  
      }  
}

以下是具有最少中繼資料之 Query Tables 作業的 JSON 回應本文範例：

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

以下是沒有中繼資料之 Query Tables 作業的範例 JSON 回應本文：

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

授權

只有帳戶擁有者可以呼叫這項作業。

備註

資料表儲存體的查詢一次最多可以傳回 1，000 個數據表，最多執行五秒。回應包含自訂標頭，其中包含下列任一情況下的 x-ms-continuation-NextTableName 接續權杖：

結果集包含超過 1，000 個數據表。
查詢未在五秒內完成。
查詢跨越分割區界限。

您可以使用接續來建構下一頁數據的後續要求。如需接續權杖的詳細資訊，請參閱查詢逾時和分頁。

注意

當您提出包含接續權杖的後續要求時，請務必在要求上傳遞原始 URI。例如，如果您已將 $filter 、 $select 或 $top 查詢選項指定為原始要求的一部分，請在後續要求中包含該選項。否則，後續的要求可能會傳回非預期的結果。

在此情況下，查詢 $top 選項會指定每個頁面的結果數目上限。它不會指定整個回應集中的結果數目上限。

如需詳細資訊，請參閱查詢資料表和實體。

配置給排程和處理查詢要求的總時間是 30 秒。該總計包含查詢執行的五秒。

如需透過 LINQ 針對資料表儲存體支援的查詢作業詳細資訊，請參閱資料表儲存體支援的查詢運算子，以及針對資料表儲存體寫入 LINQ 查詢。

另請參閱

定址資料表儲存體資源
 授權對 Azure 儲存體的要求
 設定 OData 資料服務版本標頭
 狀態和錯誤碼
 資料表儲存體錯誤碼

共用方式為