销售电话: 1-800-867-1380

创建表

更新时间: 2015年4月

Create Table 操作在存储帐户中创建一个新表。

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

 

方法 请求 URI HTTP 版本

POST

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

HTTP/1.1

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

 

方法 请求 URI HTTP 版本

POST

http://127.0.0.1:10002/devstoreaccount1/Tables

HTTP/1.1

存储模拟器中的表服务在某些方面与 Microsoft® Azure™ 表服务有所不同。有关详细信息,请参阅Differences between Development Storage and Cloud Storage Services

无。

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

 

请求标头 说明

Authorization

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

Datex-ms-date

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

x-ms-version

可选。指定用于此请求的操作的版本。有关详细信息,请参阅Windows Azure 中 BLOB 服务、队列服务和表服务的版本管理

Content-Type

必需。指定负载的内容类型。可能的值有:

  • application/atom+xml

  • application/json

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

Accept

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

  • application/atom+xml

  • application/json;odata=nometadata

  • application/json;odata=minimalmetadata

  • application/json;odata=fullmetadata

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

Prefer

可选。指定响应是否应包含负载中插入的实体。可能的值为 return-no-contentreturn-content

有关此标头的详细信息,请参阅设置 Prefer 标头以管理插入操作上的响应回显

Content-Length

必需。请求正文的长度。

x-ms-client-request-id

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

请求正文指定要创建的表的名称。请注意,表名必须遵循了解表服务数据模型中说明的命名限制。

请求正文是一个 OData 实体集,可以表示为 Atom 馈送或 JSON。

Atom

表示为 Atom 馈送的请求正文具有如下常规格式。

<?xml version="1.0" encoding="utf-8" standalone="yes"?>   
  <entry 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 /> 
    <updated>2009-03-18T11:48:34.9840639-07:00</updated> 
    <author>
      <name/> 
    </author> 
      <id/> 
      <content type="application/xml">
        <m:properties>
          <d:TableName>mytable</d:TableName>
        </m:properties>
      </content> 
    </entry>

JSON

表示为 JSON 的请求正文具有如下常规格式。

{ 
    "TableName":"mytable"
}

有关有效表名称的指南,请参阅了解表服务数据模型中的“表名称”一节。

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

状态代码取决于 Prefer 标头的值。如果 Prefer 标头设置为 return-no-content,则成功的操作将返回状态代码 204 (No Content)。如果未指定 Prefer 标头或者该标头设置为 return-content,则成功的操作将返回状态代码 201 (Created)。有关详细信息,请参阅设置 Prefer 标头以管理插入操作上的响应回显

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

此操作的响应包括以下标头。该响应还可能包括其他标准 HTTP 标头。所有标准标头都符合 HTTP/1.1 协议规范

 

响应标头 说明

x-ms-request-id

此标头唯一地标识发出的请求,并且可用于解决请求问题。有关详细信息,请参阅API 操作故障排除

x-ms-version

指示用于执行请求的表服务的版本。针对 2009-09-19 和更高版本发出的请求将返回此标头。

Date

服务生成的 UTC 日期/时间值指示启动响应的时间。

Preference-Applied

指示是否接受 Prefer 请求标头。如果响应不包含该标头,则不接受 Prefer 标头。如果返回此标头,其值将为 return-contentreturn-no-content

有关详细信息,请参阅设置 Prefer 标头以管理插入操作上的响应回显

Content-Type

指示负载的内容类型。该值取决于为 Accept 请求标头指定的值。可能的值有:

  • application/atom+xml

  • application/json;odata=nometadata

  • application/json;odata=minimalmetadata

  • application/json;odata=fullmetadata

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

如果请求包含的 Prefer 标头具有值 return-no-content,则不返回响应正文。否则,响应正文将是一个 OData 实体集。

Atom

下面是 Create Table 操作的示例 Atom 响应。

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<entry 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"> <id>https://myaccount.table.core.windows.net/Tables('mytable')</id>
  <title type="text"></title>
  <updated>2013-10-24T17: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>

JSON

下面是 JSON 中用于不同控制级别的响应负载。

完整元数据

{

    "odata.metadata":"https://myaccount.table.core.windows.net/$metadata#Tables/@Element",

    "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/@Element",

    "TableName":"mytable"

}

无元数据

{

    "TableName":"mytable"

}

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

无。

本文是否对您有所帮助?
(1500 个剩余字符)
感谢您的反馈
显示:
© 2015 Microsoft