Запросы к таблицам

Статья
06/27/2023

Операция Query Tables возвращает список таблиц в указанной учетной записи.

Запрос

Запрос можно создать Query Tables следующим образом. Рекомендуется использовать ПРОТОКОЛ HTTPS. Замените myaccount именем своей учетной записи хранения.

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

URI эмулированной службы хранилища

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

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

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

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

Операция Query Tables поддерживает параметры запроса, определенные спецификацией протокола OData .

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

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

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

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

Нет.

Ответ

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

Текст ответа

Операция Query Tables возвращает список таблиц в учетной записи как набор сущностей OData. В соответствии со значением заголовка Accept используется либо JSON, либо веб-канал Atom.

Примечание

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

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

Ниже приведен пример текста ответа 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"  
      }  
}

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

{  
    "odata.metadata":"https://myaccount.table.core.windows.net/$metadata#Tables",  
    "value":[{  
        "TableName":"mytable"  
    }]  
}

Ниже приведен пример текста ответа JSON для Query Tables операции без метаданных:

{  
   "value":[{  
       "TableName":"mytable"  
   },  
}

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

Ниже приведен пример текста ответа 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>

Авторизация

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

Запрос к хранилищу таблиц может возвращать не более 1000 таблиц одновременно и выполняться не более пяти секунд. Ответ содержит пользовательский заголовок, содержащий x-ms-continuation-NextTableName маркер продолжения в любом из следующих случаев:

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

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

Примечание

При выполнении последующих запросов, включающих маркеры продолжения, обязательно передайте исходный универсальный код ресурса (URI) в запросе. Например, если вы указали $filterпараметр запроса , $selectили $top как часть исходного запроса, включите этот параметр в последующие запросы. В противном случае последующие запросы могут возвращать непредвиденные результаты.

Параметр $top запроса в этом случае указывает максимальное количество результатов на странице. В нем не указано максимальное количество результатов во всем наборе ответов.

Дополнительные сведения см. в разделе Запрос таблиц и сущностей.

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

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

См. также раздел

Обращение к ресурсам хранилища таблиц
Авторизация запросов к службе хранилища Azure
Установка заголовков версии службы данных OData
Коды состояний и ошибок
Коды ошибок хранилища таблиц

Поделиться через