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

Таблицы запросов

Обновлено: Февраль 2014 г.

Операция 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. Дополнительные сведения см. в соглашениях об обозначении в URI OData.

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

 

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

Authorization

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

Date или x-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 КБ, которое записывается в журналы аналитики, когда включено ведение журналов аналитики хранилища. Этот заголовок настоятельно рекомендуется использовать для соотнесения действий, выполняемых на стороне клиента, с запросами, получаемыми сервером. Дополнительные сведения см. в разделах Сведения о ведении журнала службы аналитики хранилища и Ведение журналов в Windows Azure: использование журналов для отслеживания запросов к хранилищу.

Ответ включает код состояния HTTP, набор заголовков ответа и текст ответа.

Успешная операция возвращает код состояния 200 (ОК).

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

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

 

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

x-ms-continuation-NextTableName

Если количество возвращаемых таблиц превышает 1000 или запрос не выполняется в пределах интервала времени ожидания, то заголовок ответа включает заголовок продолжения 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

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

<?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

Ниже приведен пример текста ответа JSON для операции Query Tables.

Полные метаданные

{
   "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 секунд. Если результирующий набор содержит более 1000 таблиц, если запрос не завершен в пределах 5 секунд или если запрос пересекает границу секции, то ответ включает пользовательский заголовок, содержащий токен продолжения x-ms-continuation-NextTableName. Токен продолжения может использоваться для создания последующего запроса для следующей страницы данных. Дополнительные сведения о токенах продолжения см. в разделе Время ожидания запроса и разбиение на страницы.

Обратите внимание, что общее время, отводимое запросу на планирование и обработку запроса, составляет 30 секунд, включая 5 секунд для выполнения запроса.

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

Была ли вам полезна эта информация?
(1500 символов осталось)
Спасибо за ваш отзыв
Показ:
© 2014 Microsoft