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

Статья
06/27/2023

Операция Create Table создает таблицу в учетной записи хранения.

Запрос

Запрос можно создать, Create Table как показано здесь. Рекомендуется использовать ПРОТОКОЛ HTTPS. Замените myaccount именем своей учетной записи хранения:

Метод	Универсальный код ресурса (URI) запроса	параметр "Версия HTTP"
`POST`	`https://myaccount.table.core.windows.net/Tables`	HTTP/1.1

Запрос службы эмулированного хранилища

При выполнении запроса к эмулированной службе хранилища укажите имя узла эмулятора и порт хранилища таблиц Azure в качестве 127.0.0.1:10002, а затем имя эмулированной учетной записи хранения:

Метод	Универсальный код ресурса (URI) запроса	параметр "Версия HTTP"
`POST`	`http://127.0.0.1:10002/devstoreaccount1/Tables`	HTTP/1.1

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

Параметры универсального кода ресурса (URI)

Нет.

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

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

Заголовок запроса	Описание
`Authorization`	Обязательный. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure.
`Date` или `x-ms-date`	Обязательный. Задает время запроса в формате UTC. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure.
`x-ms-version`	Необязательный элемент. Задает версию операции, используемой для этого запроса. Дополнительные сведения см. в разделе Управление версиями для служб хранилища Azure.
`Content-Type`	Обязательный. Указывает тип содержимого для полезных данных. Возможны следующие значения: - `application/atom+xml` (только версии, предшествующие 11.12.2015) - `application/json` Дополнительные сведения см. в разделе Формат полезных данных для операций хранилища таблиц.
`Accept`	Необязательный элемент. Указывает приемлемый тип содержимого полезных данных ответа. Возможны следующие значения: - `application/atom+xml` (только версии, предшествующие 11.12.2015) - `application/json;odata=nometadata` - `application/json;odata=minimalmetadata` - `application/json;odata=fullmetadata` Дополнительные сведения см. в разделе Формат полезных данных для операций службы таблиц.
`Prefer`	Необязательный элемент. Указывает, должен ли ответ включать сущность, вставленную в полезные данные. Возможные значения: `return-no-content` и `return-content`. Дополнительные сведения об этом заголовке см. в разделе Настройка заголовка `Prefer` для управления эхом ответа при операциях вставки.
`Content-Length`	Обязательный. Длина текста запроса.
`x-ms-client-request-id`	Необязательный элемент. Предоставляет созданное клиентом непрозрачное значение с ограничением в 1 кибибайт (КиБ), которое записывается в журналы при настройке ведения журнала. Мы настоятельно рекомендуем использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в статье Мониторинг хранилища таблиц Azure.

Текст запроса

В тексте запроса указывается имя создаваемой таблицы. Имена таблиц должны соответствовать ограничениям именования, описанным в разделе Общие сведения о модели данных хранилища таблиц.

Текст запроса представляет собой набор сущностей OData, который может быть выражен как JSON или как веб-канал Atom.

Примечание

JSON — это рекомендуемый формат полезных данных, и это единственный формат, поддерживаемый для версии 2015-12-11 и более поздних версий.

Рекомендации по допустимым именам таблиц см. в разделе "Имена таблиц" статьи Общие сведения о модели данных хранилища таблиц.

JSON (версия 2013-08-15 и более поздние версии)

Текст запроса в виде веб-канала JSON имеет следующий общий формат:

{   
    "TableName":"mytable"  
}

Веб-канал Atom (версии до 11.12.2015)

Текст запроса в качестве веб-канала 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="https://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>

Ответ

Ответ включает код состояния 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` Дополнительные сведения о типах контента см. в разделе Формат полезных данных для операций хранилища таблиц.
`x-ms-client-request-id`	Может использоваться для устранения неполадок с запросами и соответствующими ответами. Значение этого заголовка равно значению заголовка `x-ms-client-request-id` , если он присутствует в запросе и содержит не более 1024 видимых символов ASCII. Если заголовок `x-ms-client-request-id` отсутствует, он отсутствует в ответе.

Текст ответа

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

Примечание

В качестве формата полезных данных рекомендуется использовать JSON. Это единственный формат, поддерживаемый для версии 2015-12-11 и более поздних версий.

JSON (версия 15.08.2013 и более поздняя)

Ниже приведены полезные данные ответа в ФОРМАТЕ 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"  
  
}

Веб-канал Atom (версии, предшествующие 11.12.2015)

Ниже приведен пример ответа 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="https://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>

Авторизация

Вызов этой операции доступен только владельцу учетной записи.

Remarks