Consultar tabelas
Recolher sumário
Expandir sumário
Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Consultar tabelas

 

A palavras-chave Async e Await no Visual Basic e a palavras-chave async e await em c# são o coração da programação assíncrona.

A palavras-chave Async e Await no Visual Basic e a palavras-chave async e await em c# são o coração da programação assíncrona. HTTPS é recomendado. Substitua myaccount com o 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 de 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 as diferenças entre o emulador de armazenamento e serviços de armazenamento do Azure.

A palavras-chave Async e Await no Visual Basic e a palavras-chave async e await em c# são o coração da programação assíncrona. Para obter mais informações, consulte protocolo 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ório. 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ório. 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 limite de caractere de 1 KB que será registrado nos logs de análise quando o registro em log da análise de armazenamento for habilitado. O uso desse cabeçalho é altamente recomendável para correlacionar atividades do lado 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 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 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 dentro do intervalo de tempo limite, o cabeçalho de resposta inclui a x-ms-continuation-NextTableName cabeçalho de acompanhamento. 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 da 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 nas 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. Valor depende da solicitação Accept cabeçalho. 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 palavras-chave Async e Await no Visual Basic e a palavras-chave async e await em c# são o coração da programação assíncrona. De acordo com o valor de Accept o conteúdo do cabeçalho é um feed Atom ou JSON.

Feed Atom

Aqui está um exemplo de corpo de resposta de Atom para o 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> 

JSON

Aqui está um exemplo de corpo de resposta JSON para o Query Tables operações.

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 inclui um cabeçalho personalizado que contém o x-ms-continuation-NextTableName token de continuação. 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 da consulta e paginação.

System_CAPS_noteObservação

Ao fazer solicitações subseqüentes que incluem tokens de continuação, certifique-se de passar a URL original na solicitação. Por exemplo, se você tiver especificado um $filter, $select, ou $top opção de consulta como parte da solicitação original, você desejará incluir essa opção nas solicitações subseqüentes. Caso contrário, as solicitações subseqüentes podem retornar resultados inesperados.

Observe que o $top consulta opção nesse caso Especifica o número máximo de resultados por página, não o número máximo de resultados na resposta inteira definido.

Consulte Consultando tabelas e entidades 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 as operações de consulta com suporte no serviço tabela por meio de LINQ, consulte Operadores de consulta (serviço do suporte Tabela) e Gravando consultas LINQ no serviço Tabela.

Mostrar:
© 2016 Microsoft