创建表
折叠目录
展开目录
本文由机器翻译。若要查看英语原文,请勾选“英语”复选框。 也可将鼠标指针移到文本上,在弹出窗口中显示英语原文。
翻译
英语

创建表

 

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™ 表服务有所不同。 有关详细信息,请参阅 差异之间存储仿真程序与 Azure 存储服务

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

请求标头

说明

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

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

无。

显示:
© 2016 Microsoft