Consultar tablas

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

Solicitud

La solicitud Query Tables se puede construir como sigue. Se recomienda HTTPS. Reemplace myaccount por el nombre de la cuenta de almacenamiento:

Método URI de solicitud Versión HTTP
GET https://myaccount.table.core.windows.net/Tables HTTP/1.1

URI de 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, seguido del nombre de la cuenta de almacenamiento emulado:

Método URI de solicitud Versión HTTP
GET http://127.0.0.1:10002/devstoreaccount1/Tables HTTP/1.1

Table service del servicio de almacenamiento emulado presenta algunas diferencias respecto a Windows® Azure™ Table service. Para obtener más información, vea Diferencias entre los servicios de Storage Emulator y Azure Storage.

Parámetros de identificador URI

La operación Query Tables admite las opciones de consulta definidas en la Especificación de protocolo OData. Para obtener más información, vea Protocolo OData.

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

Encabezado de solicitud Descripción
Authorization Necesario. Especifica el esquema de autorización, el nombre de cuenta y la firma. Para obtener más información, consulte Autorización de solicitudes para Azure Storage.
Date o x-ms-date Necesario. Especifica la hora universal coordinada (UTC) de la solicitud. Para obtener más información, consulte Autorización de solicitudes para Azure Storage.
x-ms-version Opcional. Especifica la versión de la operación que se utiliza para esta solicitud. Para obtener más información, consulte Control de versiones para los servicios de Azure Storage.
Accept Opcional. Especifica el tipo de contenido aceptado de la carga de respuesta. Los valores posibles son:

- application/atom+xml (solo versiones anteriores a 2015-12-11)
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Para obtener más información, consulte Formato de carga útil para las operaciones de Table Service.
x-ms-client-request-id Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 KiB que se registra en los registros de análisis cuando se habilita el registro de análisis de almacenamiento. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes recibidas por el servidor. Para más información, consulte Acerca del registro de Storage Analytics y Windows registro de Azure: uso de registros para realizar un seguimiento de las solicitudes de Storage.

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.

Código de estado

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

Para obtener información sobre los códigos de estado, vea Códigos de estado y errores y Códigos de error de Table Service.

Encabezados de respuesta

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

Encabezado de respuesta Descripción
x-ms-continuation-NextTableName Si el número de tablas que se van a devolver es superior a 1.000 o la consulta no se completa dentro del intervalo de tiempo de espera, el encabezado de respuesta incluirá el encabezado de continuación x-ms-continuation-NextTableName. Este encabezado devuelve el valor del token de continuación. Para obtener más información sobre el uso del token de continuación, consulte Tiempo de espera de consulta y Paginación.
x-ms-request-id Este encabezado identifica de forma única la solicitud que se realizó y se puede utilizar para solucionar problemas relacionados con esta. Para más información, consulte Solución de problemas de operaciones de API.
x-ms-version Indica la versión del servicio Tabla utilizada para ejecutar la solicitud. Este encabezado se devuelve para las solicitudes realizadas en la versión 2009-09-19 y versiones posteriores.
Date Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta.
Content-Type Indica el tipo de contenido de la carga. El valor depende del encabezado de solicitud Accept. Los valores posibles son:

- application/atom+xml
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Para obtener más información sobre los tipos de contenido válidos, consulte Formato de carga útil para las operaciones de Table Service.
x-ms-client-request-id Este encabezado se puede usar para solucionar problemas de solicitudes y respuestas correspondientes. El valor de este encabezado es igual al valor del x-ms-client-request-id encabezado si está presente en la solicitud y el valor es como máximo 1024 caracteres ASCII visibles. Si el x-ms-client-request-id encabezado no está presente en la solicitud, este encabezado no estará presente en la respuesta.

Cuerpo de la respuesta

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.

Nota

JSON es el formato de carga recomendado y es el único formato admitido para las versiones 2015-12-11 y posteriores.

JSON (versiones 2013-08-15 y posteriores)

A continuación se muestra un cuerpo de respuesta JSON de ejemplo para las operaciones Query Tables.

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

Metadatos mínimos

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

Sin metadatos

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

Fuente atom (versiones anteriores a 2015-12-11)

A continuación se muestra un cuerpo de respuesta Atom de ejemplo para la operación 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>   

Authorization

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

Notas

Una consulta al servicio Tabla puede devolver un máximo de 1.000 tablas al mismo tiempo, y se puede ejecutar durante cinco segundos como máximo. Si el conjunto de resultados contiene más de 1.000 tablas, si la consulta no se completa en un plazo de cinco segundos o si la consulta cruza el límite de la partición, la respuesta incluirá un encabezado personalizado que contendrá el token de continuación x-ms-continuation-NextTableName. El token de continuación se puede utilizar para crear una solicitud posterior para obtener la página de datos siguiente. Para obtener más información sobre los tokens de continuación, consulte Tiempo de espera de consulta y Paginación.

Nota

Al realizar solicitudes posteriores que incluyan tokens de continuación, asegúrese de pasar el URI original en la solicitud. Por ejemplo, si ha especificado una $filteropción de consulta , $selecto $top como parte de la solicitud original, querrá incluir esa opción en las solicitudes posteriores. De lo contrario, las solicitudes posteriores pueden devolver resultados inesperados.

Tenga en cuenta que la $top opción de consulta en este caso especifica el número máximo de resultados por página, no el número máximo de resultados en todo el conjunto de respuestas.

Consulte Consulta de tablas y entidades para obtener más información.

Tenga presente que el tiempo total asignado a la solicitud para programar y procesar la consulta es de 30 segundos, incluidos los cinco segundos para la ejecución de la consulta.

Para obtener más información sobre las operaciones de consulta admitidas en Table service a través de LINQ, vea Operadores de consulta admitidos para Table Service y Escritura de consultas LINQ en Table Service.

Vea también

Direccionamiento de los recursos de Table Service
Autorización de solicitudes a Azure Storage
Establecer los encabezados de versión del servicio de datos OData
Códigos de estado y error
Códigos de error del servicio Tabla