Exportar (0) Imprimir
Expandir Tudo

Consultar tabelas

Atualizado: fevereiro de 2014

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

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 de solicitação Versão de HTTP

GET

https://myaccount.table.core.windows.net/Tables

HTTP/1.1

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 de 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 About Development Storage e Diferenças entre o emulador de armazenamento e os serviços de armazenamento do Azure.

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 Convenções de URI OData.

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

 

Cabeçalho de solicitação Descrição

Authorization

Obrigatória. Especifica o esquema de autenticação, o nome da conta e a assinatura. Para obter mais informações, consulte Autenticação federada para os Serviços de Armazenamento do Azure.

Date ou x-ms-date

Obrigatória. Especifica o Tempo Universal Coordenado (UTC) para a solicitação. Para obter mais informações, consulte Autenticação federada para os Serviços de 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 possíveis valores são:

  • application/atom+xml

  • application/json;odata=nometadata

  • application/json;odata=minimalmetadata

  • application/json;odata=fullmetadata

Para obter mais informações, consulte Formato de carga para operações do serviço Tabela.

x-ms-client-request-id

Opcional. Fornece um valor opaco, gerado pelo cliente, com um limite de caracteres de 1 KB que é registrado nos logs de análise quando o log de análise de armazenamento está habilitado. É altamente recomendável usar esse cabeçalho para correlacionar atividades do cliente com solicitações recebidas pelo servidor. Para obter mais informações, consulte Sobre o registro em log da Análise de Armazenamento e Log do Windows Azure: Usando logs para rastrear solicitações de armazenamento.

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

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

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

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 obedecem à 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 acompanhamento, 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 Solucionando 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 possíveis valores são:

  • application/atom+xml

  • application/json;odata=nometadata

  • application/json;odata=minimalmetadata

  • application/json;odata=fullmetadata

Para obter mais informações sobre tipos de conteúdo válidos, consulte Formato de carga para operações do serviço Tabela.

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 cabeçalho Accept, o conteúdo é um feed Atom ou JSON.

Feed Atom

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> 

JSON

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

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

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 acompanhamento, consulte Tempo limite de consulta e paginação.

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 de LINQ, consulte Operadores de consulta com suporte do serviço Tabela e Gravando consultas LINQ no serviço Tabela.

Mostrar:
© 2014 Microsoft