Consultar tabelas

A operação Query Tables retorna uma lista de tabelas na conta especificada.

Solicitação

A solicitação Query Tables pode ser criada da seguinte maneira. HTTPS é recomendado. Substitua myaccount pelo nome da sua conta de armazenamento:

Método URI da solicitação Versão de HTTP
GET https://myaccount.table.core.windows.net/Tables HTTP/1.1

URI de serviço de armazenamento emulado

Ao fazer uma solicitação no serviço de armazenamento emulado, especifique o nome de host do emulador e a porta do serviço Tabela como 127.0.0.1:10002, seguido pelo nome da conta de armazenamento emulado:

Método URI da solicitação Versão de HTTP
GET http://127.0.0.1:10002/devstoreaccount1/Tables HTTP/1.1

O serviço Tabela no serviço de armazenamento emulado difere de muitas maneiras do serviço Tabela do Windows® Azure™. Para obter mais informações, consulte Diferenças entre o Armazenamento Emulator e os Serviços de Armazenamento do Azure.

Parâmetros de URI

A operação Query Tables dá suporte às opções de consulta definidas pela Especificação de protocolo OData. Para obter mais informações, consulte o Protocolo OData.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Cabeçalho da solicitação Descrição
Authorization Obrigatórios. Especifica o esquema de autorização, o nome da conta e a assinatura. Para obter mais informações, consulte Autorizar solicitações ao Armazenamento do Azure.
Date ou x-ms-date Obrigatórios. Especifica o UTC (Tempo Universal Coordenado) para a solicitação. Para obter mais informações, consulte Autorizar solicitações ao Armazenamento do Azure.
x-ms-version Opcional. Especifica a versão da operação a ser usada para esta solicitação. Para obter mais informações, consulte Controle de versão para os Serviços de Armazenamento do Azure.
Accept Opcional. Especifica o tipo de conteúdo aceito da carga de resposta. Os valores possíveis são:

- application/atom+xml (somente versões anteriores a 12-11 de 2015)
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Para obter mais informações, consulte Formato de carga para operações de serviço de tabela.
x-ms-client-request-id Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres de 1 KiB que é registrado nos logs de análise quando o log de análise de armazenamento está habilitado. O uso desse cabeçalho é altamente recomendável para correlacionar as atividades do lado do cliente com as solicitações recebidas pelo servidor. Para obter mais informações, consulte Sobre Análise de Armazenamento registro em log e Windows registro em log do Azure: usando logs para acompanhar solicitações de Armazenamento.

Corpo da solicitação

Nenhum.

Resposta

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Código de status

Uma operação bem-sucedida retorna o código de status 200 (OK).

Para obter informações sobre códigos de status, consulte Códigos de Status e Erro e Códigos de Erro do Serviço de Tabela.

Cabeçalhos de resposta

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação de protocolo HTTP/1.1.

Cabeçalho de resposta Descrição
x-ms-continuation-NextTableName Se o número de tabelas a serem retornadas exceder 1.000 ou a consulta não for concluída no intervalo de tempo limite, o cabeçalho de resposta incluirá o cabeçalho de acompanhamento x-ms-continuation-NextTableName. Esse cabeçalho retorna o valor de token de acompanhamento. Para obter mais informações sobre como usar o token de continuação, consulte Tempo limite de consulta e paginação.
x-ms-request-id Esse cabeçalho identifica a solicitação que foi feita de forma exclusiva e pode ser usado para solucionar problemas na solicitação. Para obter mais informações, consulte Solução de problemas de operações de API.
x-ms-version Indica a versão do serviço Tabela usado para executar a solicitação. Esse cabeçalho é retornado para solicitações feitas na versão 2009-09-19 e mais recente.
Date Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada.
Content-Type Indica o tipo de conteúdo da carga. O valor depende do cabeçalho Accept da solicitação. Os valores possíveis são:

- application/atom+xml
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Para obter mais formação sobre tipos de conteúdo válidos, consulte Formato de Carga para Operações de Serviço de Tabela.
x-ms-client-request-id Esse cabeçalho pode ser usado para solucionar problemas de solicitações e respostas correspondentes. O valor desse cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho se ele estiver presente na solicitação e o valor estiver no máximo 1024 caracteres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente na solicitação, esse cabeçalho não estará presente na resposta.

Corpo da resposta

A operação Query Tables retorna a lista de tabelas na conta como um conjunto de entidades de OData. De acordo com o valor do Accept cabeçalho, o conteúdo é JSON ou um feed Atom.

Observação

JSON é o formato de carga recomendado e é o único formato com suporte para versões 2015-12-11 e posteriores.

JSON (versões 2013-08-15 e posterior)

Veja a seguir um exemplo de corpo de resposta JSON para as operações Query Tables.

Metadados completos

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

Metadados mínimos

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

Sem metadados

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

Atom Feed (versões anteriores a 2015-12-11)

Veja a seguir um exemplo de corpo de resposta Atom para a operação 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>   

Autorização

Somente o proprietário da conta pode chamar essa operação.

Comentários

Uma consulta no serviço Tabela pode retornar, no máximo, 1.000 tabelas simultaneamente e pode ser executada por até cinco segundos. Se o conjunto de resultados contiver mais de 1.000 tabelas, se a consulta não for concluída em até cinco segundos ou se a consulta ultrapassar o limite da partição, a resposta incluirá um cabeçalho personalizado que contêm o token de acompanhamento x-ms-continuation-NextTableName. O token de acompanhamento pode ser usados para criar uma solicitação subsequente para a página de dados seguinte. Para obter mais informações sobre tokens de continuação, consulte Tempo limite e paginação de consulta.

Observação

Ao fazer solicitações subsequentes que incluem tokens de continuação, não deixe de passar o URI original na solicitação. Por exemplo, se você tiver especificado uma $filteropção , $selectou $top consulta como parte da solicitação original, você desejará incluir essa opção em solicitações subsequentes. Caso contrário, suas solicitações subsequentes podem retornar resultados inesperados.

Observe que a opção $top de consulta nesse caso especifica o número máximo de resultados por página, não o número máximo de resultados em todo o conjunto de respostas.

Consulte tabelas e entidades de consulta para obter mais detalhes.

Observe que o tempo total distribuído à solicitação para agendar e processar a consulta é de 30 segundos, incluindo os cinco segundos para a execução da consulta.

Para obter mais informações sobre operações de consulta com suporte no serviço Tabela por meio do LINQ, consulte operadores de consulta com suporte para o Serviço de Tabela e escrevendo consultas LINQ no Serviço de Tabela.

Consulte Também

Endereçando recursos de serviço de tabela
Autorizar solicitações ao Azure Armazenamento
Definindo os cabeçalhos da versão do serviço de dados OData
Status e códigos de erro
Códigos de erro do serviço de tabela