查詢資料表

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 資料服務版本標頭
狀態和錯誤碼
資料表儲存體錯誤碼