Consultar tablas

La operación Query Tables devuelve una lista de las tablas existentes en la cuenta especificada.

Request

Puede construir la solicitud de la Query Tables siguiente manera. Se recomienda HTTPS. Reemplace myaccount por el nombre de la cuenta de almacenamiento.

URI del servicio de almacenamiento emulado

Cuando realice una solicitud en el servicio de almacenamiento emulado, especifique el nombre de host del emulador y el puerto de Table Service como 127.0.0.1:10002. Siga esa información con el nombre de la cuenta de almacenamiento emulada.

Table service en el emulador de almacenamiento difiere de Azure Table Storage de varias maneras. Para más información, consulte Diferencias entre el emulador de almacenamiento y los servicios de Azure Storage.

Parámetros del identificador URI

La Query Tables operación admite las opciones de consulta que define la especificación del protocolo OData .

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud obligatorios y opcionales:

Cuerpo de la solicitud

Ninguno.

Response

La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.

status code

Una operación correcta devuelve el código de estado 200 Correcto.

Para obtener información sobre los códigos de estado, consulte Códigos de error y estado yCódigos de error de Table Storage.

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir encabezados HTTP estándar adicionales. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.

Response body

La operación Query Tables devuelve la lista de tablas en la cuenta como un conjunto de entidades de OData. Según el valor del Accept encabezado, el contenido es JSON o una fuente Atom.

JSON (versión 2013-08-15 y posteriores)

Este es un cuerpo de respuesta JSON de ejemplo para una Query Tables operación con metadatos 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"  
      }  
}  

Este es un cuerpo de respuesta JSON de ejemplo para una Query Tables operación con metadatos mínimos:

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

Este es un cuerpo de respuesta JSON de ejemplo para una Query Tables operación sin metadatos:

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

Fuente Atom (versiones anteriores al 2015-12-11)

Este es un cuerpo de respuesta atom de ejemplo para la Query Tables operación:

<?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>   

Authorization

Solo el propietario de la cuenta puede llamar a esta operación.

Comentarios

Una consulta en Table Storage puede devolver un máximo de 1000 tablas a la vez y ejecutarse durante un máximo de cinco segundos. La respuesta incluye un encabezado personalizado que contiene el x-ms-continuation-NextTableName token de continuación en cualquiera de los casos siguientes:

• El conjunto de resultados contiene más de 1000 tablas.
• La consulta no finalizó en cinco segundos.
• La consulta supera el límite de la partición.

Puede usar la continuación para construir una solicitud posterior para la página siguiente de datos. Para obtener más información sobre los tokens de continuación, consulte Tiempo de espera de consulta y paginación.

El tiempo total asignado a la solicitud de programación y procesamiento de la consulta es de 30 segundos. Ese total incluye los cinco segundos para la ejecución de consultas.

Para obtener más información sobre las operaciones de consulta admitidas en Table Storage a través de LINQ, consulte Operadores de consulta compatibles con Table Storage y Escritura de consultas LINQ en Table Storage.

Consulte también

Direccionamiento de los recursos de Table Storage
Autorización de solicitudes a Azure Storage
Establecimiento de los encabezados de versión del servicio de datos de OData
Estado y códigos de error
Códigos de error de Table Storage