Consultar tabelas

Artigo
06/27/2023

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

Solicitação

Você pode construir a solicitação da Query Tables seguinte maneira. Recomendamos HTTPS. Substitua myaccount pelo nome da sua conta de armazenamento.

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

URI do serviço de armazenamento emulado

Ao fazer uma solicitação no serviço de armazenamento emulado, especifique o nome do host do emulador e a porta do serviço de tabela como 127.0.0.1:10002. Siga essas informações com o nome da conta de armazenamento emulada.

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

O serviço Tabela no emulador de armazenamento difere do Armazenamento de Tabelas do Azure de várias maneiras. Para obter mais informações, consulte Diferenças entre o emulador de armazenamento e os serviços de Armazenamento do Azure.

Parâmetros do URI

A Query Tables operação dá suporte às opções de consulta definidas pela especificação do protocolo OData .

Cabeçalhos da 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 saber mais, confira Autorizar solicitações para o Armazenamento do Azure.
`Date` ou `x-ms-date`	Obrigatórios. Especifica o UTC (Tempo Universal Coordenado) para a solicitação. Para saber mais, confira Autorizar solicitações para o 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 antes de 2015-12-11) - `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 Armazenamento de Tabelas.
`x-ms-client-request-id`	Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres KiB (1 kibibyte) que é registrado nos logs quando o registro em log é configurado. É altamente recomendável que você use esse cabeçalho para correlacionar atividades do lado do cliente com solicitações recebidas pelo servidor.

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 status, consulte Códigos de erro e status e códigos de erro do Armazenamento de Tabelas.

Cabeçalhos de resposta

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

Cabeçalho de resposta	Descrição
`x-ms-continuation-NextTableName`	Retorna o valor do token de continuação. Se o número de tabelas a serem retornadas exceder 1.000 ou a consulta não terminar dentro do intervalo de tempo limite, o cabeçalho de resposta incluirá o `x-ms-continuation-NextTableName` cabeçalho de continuação. Para obter mais informações sobre como usar o token de continuação, consulte Tempo limite e paginação de consulta.
`x-ms-request-id`	Identifica exclusivamente a solicitação que foi feita. Você pode usá-lo para solucionar problemas da solicitação. Para obter mais informações, consulte Solucionar problemas de operações de API.
`x-ms-version`	Indica a versão do Armazenamento de Tabelas usada 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 que indica a hora em que o serviço enviou a resposta.
`Content-Type`	Indica o tipo de conteúdo da carga. O valor depende do cabeçalho da `Accept` 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 Armazenamento de Tabelas.
`x-ms-client-request-id`	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 for no máximo 1.024 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

Recomendamos JSON como o formato de conteúdo. É o único formato com suporte para a versão 2015-12-11 e posterior.

JSON (versão 2013-08-15 e posterior)

Aqui está um corpo de resposta JSON de exemplo para uma Query Tables operação com 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"  
      }  
}

Aqui está um corpo de resposta JSON de exemplo para uma Query Tables operação com metadados mínimos:

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

Aqui está um corpo de resposta JSON de exemplo para uma Query Tables operação sem metadados:

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

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

Aqui está um corpo de resposta Atom de exemplo para a Query Tables operação:

<?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 Armazenamento de Tabelas pode retornar no máximo 1.000 tabelas ao mesmo tempo e ser executada por um máximo de cinco segundos. A resposta inclui um cabeçalho personalizado que contém o x-ms-continuation-NextTableName token de continuação em qualquer um dos seguintes casos:

O conjunto de resultados contém mais de 1.000 tabelas.
A consulta não foi concluída em cinco segundos.
A consulta cruza o limite da partição.

Você pode usar a continuação para construir uma solicitação subsequente para a próxima página de dados. 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 se esqueça de passar o URI original na solicitação. Por exemplo, se você tiver especificado uma $filteropção de consulta , $selectou $top como parte da solicitação original, inclua essa opção em solicitações subsequentes. Caso contrário, suas solicitações subsequentes poderão retornar resultados inesperados.

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

Para obter mais informações, consulte Consultar tabelas e entidades.

O tempo total atribuído à solicitação para agendar e processar a consulta é de 30 segundos. Esse total inclui os cinco segundos para execução da consulta.

Para obter mais informações sobre operações de consulta com suporte no Armazenamento de Tabelas por meio do LINQ, consulte Operadores de consulta compatíveis com o Armazenamento de Tabelas e Gravar consultas LINQ no Armazenamento de Tabelas.

Confira também

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

Compartilhar via