导出 (0) 打印
全部展开

查询表

更新时间: 2014年2月

Query Tables操作返回指定帐户中的表的列表。

可以按如下方式构建Query Tables请求。建议使用 HTTPS。将 myaccount 替换为你的存储帐户名称:

 

方法 请求 URI HTTP 版本

GET

https://myaccount.table.core.windows.net/Tables

HTTP/1.1

在针对模拟的存储服务发出请求时,请将模拟器主机名和表服务端口指定为 127.0.0.1:10002,后跟模拟的存储帐户名称:

 

方法 请求 URI HTTP 版本

GET

http://127.0.0.1:10002/devstoreaccount1/Tables

HTTP/1.1

模拟的存储服务中的表服务在某些方面与 Windows® Azure™ 表服务有所不同。有关详细信息,请参阅 About Development Storage存储仿真程序与 Azure 存储服务之间的差异

Query Tables操作支持 OData 协议规范定义的查询选项。有关更多信息,请参见 OData URI 约定

下表介绍必需的和可选的请求标头。

 

请求标头 说明

Authorization

必需。指定身份验证方案、帐户名和签名。有关详细信息,请参阅Azure 存储服务身份验证

Datex-ms-date

必需。为请求指定协调世界时 (UTC)。有关详细信息,请参阅Azure 存储服务身份验证

x-ms-version

可选。指定用于此请求的操作的版本。有关详细信息,请参阅Azure 存储服务版本化

Accept

可选。指定响应负载已接受的内容类型。可能的值有:

  • application/atom+xml

  • application/json;odata=nometadata

  • application/json;odata=minimalmetadata

  • application/json;odata=fullmetadata

有关详细信息,请参阅表服务操作的负载格式

x-ms-client-request-id

可选。提供客户端生成的、附带 1 KB 字符限制的不透明值,在启用存储分析日志记录时,将在分析日志中记录该值。强烈建议使用此标头将客户端活动与服务器接收的请求相关联。有关详细信息,请参阅 关于存储分析日志记录Azure 日志记录:使用日志跟踪存储请求

无。

响应包括 HTTP 状态代码、一组响应标头和响应正文。

此操作成功后返回状态代码 200(正常)。

有关状态代码的信息,请参阅状态和错误代码表服务错误代码

此操作的响应包括以下标头。该响应还可能包括其他标准 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

有关有效内容类型的详细信息,请参阅表服务操作的负载格式

Query Tables操作返回帐户中的表列表作为 OData 实体集。根据 Accept 标头的值,内容是 Atom 馈送或 JSON。

Atom 馈送

下面是 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> 

JSON

下面是 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"
      }
}

最少元数据

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

无元数据

{
   "value":[{
       "TableName":"mytable"
   },
}

只有帐户所有者可以调用此操作。

针对表服务的查询每次最多可以返回 1000 个表,最长执行时间为 5 秒。如果结果集包含超过 1,000 个表,查询未在 5 秒内完成或查询跨越分区边界,则响应包括一个包含 x-ms-continuation-NextTableName 继续标记的自定义标头。可以使用继续标记构造后续请求以获取下一页数据。有关继续标记的更多信息,请参见查询超时和分页

请注意分配给计划和处理查询请求的总时间为 30 秒,包括查询执行的 5 秒。

有关支持通过 LINQ 针对表服务执行的查询操作的更多信息,请参见表服务支持的查询运算符编写针对表服务的 LINQ 查询

Microsoft 正在进行一项网上调查,以了解您对 MSDN 网站的意见。 如果您选择参加,我们将会在您离开 MSDN 网站时向您显示该网上调查。

是否要参加?
显示:
© 2014 Microsoft