Продажи: 1-800-867-1389

Создание таблицы

Обновлено: Ноябрь 2013 г.

Операция 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

Служба таблиц в эмуляторе хранилища отличается от службы таблиц Windows® Azure™ в нескольких аспектах. Дополнительные сведения см. в разделах About Development Storage и Различия между эмулятором хранилища и службами хранилища Azure.

В следующей таблице перечислены обязательные и необязательные заголовки запросов.

 

Заголовок запроса Описание

Authorization

Обязательно. Указывает схему проверки подлинности, имя учетной записи и подпись. Дополнительные сведения см. в Проверка подлинности для служб хранения Azure.

Date или x-ms-date

Обязательно. Задает время в формате UTC для запроса. Дополнительные сведения см. в Проверка подлинности для служб хранения Azure.

x-ms-version

Необязательно. Задает версию операции, используемой для этого запроса. Дополнительные сведения см. в Управление версиями для служб хранилища Azure.

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-content и return-content.

Дополнительные сведения об этом заголовке см. в разделе Установка предпочитаемого заголовка для управления эхо-повтором ответов в операциях вставки.

Content-Length

Обязательно. Длина текста запроса.

x-ms-client-request-id

Необязательно. Предоставляет сформированное клиентом непрозрачное значение с ограничением в 1 КБ, которое записывается в журналы аналитики, когда включено ведение журналов аналитики хранилища. Этот заголовок настоятельно рекомендуется использовать для соотнесения действий, выполняемых на стороне клиента, с запросами, получаемыми сервером. Дополнительные сведения см. в разделах Сведения о ведении журнала службы аналитики хранилища и Ведение журналов в Windows 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). Дополнительные сведения см. в Установка предпочитаемого заголовка для управления эхо-повтором ответов в операциях вставки.

Дополнительные сведения о кодах состояния см. в разделах Коды состояний и ошибок и Коды ошибок для службы таблиц.

Ответ для этой операции включает следующие заголовки. Ответ может также включать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют Спецификации протокола HTTP/1.1.

 

Заголовок ответа Описание

x-ms-request-id

Этот заголовок однозначно определяет выполненный запрос, его также можно использовать для устранения связанных с запросом неполадок. Дополнительные сведения см. в Устранение неполадок при API-операциях.

x-ms-version

Указывает версию службы таблиц, используемую для выполнения запроса. Этот заголовок возвращается для запросов к версии 2009-09-19 и более поздним версиям.

Date

Значение даты и времени в формате UTC, сформированное службой и указывающее время, когда был инициирован ответ.

Preference-Applied

Указывает, был ли учтен заголовок запроса Prefer. Если ответ не содержит этот заголовок, то заголовок Prefer не был учтен. Если этот заголовок возвращен, то он будет иметь значение return-content или return-no-content.

Дополнительные сведения см. в Установка предпочитаемого заголовка для управления эхо-повтором ответов в операциях вставки.

Content-Type

Указывает тип содержимого полезных данных. Значение зависит от значения, указанного для заголовка запроса Accept. Возможные значения:

  • application/atom+xml

  • application/json;odata=nometadata

  • application/json;odata=minimalmetadata

  • application/json;odata=fullmetadata

Дополнительные сведения о типах содержимого см. в разделе Формат полезных данных для операций службы таблиц.

Если запрос содержит заголовок Prefer со значением return-no-content, то текст ответа возвращен не будет. В противном случае текстом ответа будет набор сущностей OData.

Atom

Ниже приведен пример текста ответа в формате Atom для операции Create Table.

<?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 символов осталось)
Спасибо за ваш отзыв
Корпорация Майкрософт проводит интернет-опрос, чтобы выяснить ваше мнение о веб-сайте MSDN. Если вы желаете принять участие в этом интернет-опросе, он будет отображен при закрытии веб-сайта MSDN.

Вы хотите принять участие?
Показ:
© 2014 Microsoft