Tabelas de Consulta

Artigo
06/27/2023

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

Pedir

Pode construir o pedido da Query Tables seguinte forma. Recomendamos HTTPS. Substitua myaccount pelo nome da sua conta de armazenamento.

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

URI do serviço de armazenamento emulado

Quando estiver a fazer um pedido relativamente ao serviço de armazenamento emulado, especifique o nome do anfitrião 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 do pedido	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 formas. Para obter mais informações, veja Diferenças entre o emulador de armazenamento e os serviços de Armazenamento do Azure.

Parâmetros do URI

A Query Tables operação suporta as opções de consulta que a especificação do protocolo OData define.

Cabeçalhos do pedido

A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais:

Cabeçalho do pedido	Description
`Authorization`	Obrigatório. Especifica o esquema de autorização, o nome da conta e a assinatura. Para obter mais informações, veja Autorizar pedidos para o Armazenamento do Azure.
`Date` ou `x-ms-date`	Obrigatório. Especifica a Hora Universal Coordenada (UTC) do pedido. Para obter mais informações, veja Autorizar pedidos para o Armazenamento do Azure.
`x-ms-version`	Opcional. Especifica a versão da operação a utilizar para este pedido. Para obter mais informações, veja Controlo de versões dos serviços de Armazenamento do Azure.
`Accept`	Opcional. Especifica o tipo de conteúdo aceite do payload de resposta. Os valores possíveis são: - `application/atom+xml` (apenas versões antes de 2015-12-11) - `application/json;odata=nometadata` - `application/json;odata=minimalmetadata` - `application/json;odata=fullmetadata` Para obter mais informações, veja Formato de payload para operações de Armazenamento de Tabelas.
`x-ms-client-request-id`	Opcional. Fornece um valor opaco gerado pelo cliente com um limite de carateres de 1 kibibyte (KiB) que é registado nos registos quando o registo é configurado. Recomendamos vivamente que utilize este cabeçalho para correlacionar as atividades do lado do cliente com os pedidos que o servidor recebe.

Corpo do pedido

Nenhum.

Resposta

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

Código de estado

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

Para obter informações sobre códigos de estado, veja Códigos de estado e de erro e códigos de erro do Armazenamento de Tabelas.

Cabeçalhos de resposta

A resposta para esta operação inclui os seguintes cabeçalhos. 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`	Devolve o valor do token de continuação. Se o número de tabelas a devolver exceder 1000 ou a consulta não terminar dentro do intervalo de tempo limite, o cabeçalho de resposta inclui o `x-ms-continuation-NextTableName` cabeçalho de continuação. Para obter mais informações sobre como utilizar o token de continuação, veja Tempo limite de consulta e paginação.
`x-ms-request-id`	Identifica exclusivamente o pedido que foi feito. Pode utilizá-lo para resolver o pedido. Para obter mais informações, veja Resolver problemas de operações da API.
`x-ms-version`	Indica a versão do Armazenamento de Tabelas que é utilizada para executar o pedido. Este cabeçalho é devolvido para pedidos feitos na versão 2009-09-19 e posterior.
`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 do payload. O valor depende do cabeçalho do `Accept` pedido. 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, veja Formato de payload para operações de Armazenamento de Tabelas.
`x-ms-client-request-id`	Pode ser utilizado para resolver problemas de pedidos e respostas correspondentes. O valor deste cabeçalho é igual ao valor do `x-ms-client-request-id` cabeçalho, se estiver presente no pedido e o valor for, no máximo, 1024 carateres ASCII visíveis. Se o `x-ms-client-request-id` cabeçalho não estiver presente no pedido, este cabeçalho não estará presente na resposta.

Corpo da resposta

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

Nota

Recomendamos JSON como o formato de payload. É o único formato suportado para a versão 2015-12-11 e posterior.

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

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

Eis 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"  
    }]  
}

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

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

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

Eis um corpo de resposta do 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

Apenas o proprietário da conta pode chamar esta operação.

Observações

Uma consulta no Armazenamento de Tabelas pode devolver um máximo de 1000 tabelas de uma só vez e ser executada durante 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 1000 tabelas.
A consulta não terminou em cinco segundos.
A consulta cruza o limite da partição.

Pode utilizar a continuação para construir um pedido subsequente para a próxima página de dados. Para obter mais informações sobre os tokens de continuação, veja Tempo limite de consulta e paginação.

Nota

Quando estiver a fazer pedidos subsequentes que incluam tokens de continuação, certifique-se de que transmite o URI original no pedido. Por exemplo, se tiver especificado uma $filteropção de consulta , $selectou $top como parte do pedido original, inclua essa opção nos pedidos subsequentes. Caso contrário, os pedidos subsequentes poderão devolver resultados inesperados.

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

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

O tempo total atribuído ao pedido de agendamento e processamento da consulta é de 30 segundos. Esse total inclui os cinco segundos para a execução da consulta.

Para obter mais informações sobre as operações de consulta suportadas no Armazenamento de Tabelas através do LINQ, veja Operadores de consulta suportados para Consultas de Armazenamento de Tabelas e Escrita de consultas LINQ no Armazenamento de Tabelas.

Ver também

Endereçar recursos de Armazenamento de Tabelas
Autorizar pedidos para o Armazenamento do Azure
Definir os cabeçalhos da versão do serviço de dados OData
Códigos de estado e de erro
Códigos de erro do Armazenamento de Tabelas

Partilhar via