VENTAS: 1-800-867-1389

Query Tables

Actualizado: febrero de 2015

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

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 de HTTP

GET

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

HTTP/1.1

Cuando realice una solicitud en el servicio de almacenamiento emulado, especifique el nombre de host del emulador y el puerto del servicio Tabla como 127.0.0.1:10002, seguido del nombre de la cuenta de almacenamiento emulado:

 

Método URI de solicitud Versión de HTTP

GET

http://127.0.0.1:10002/devstoreaccount1/Tables

HTTP/1.1

El servicio Tabla del servicio de almacenamiento emulado presenta algunas diferencias respecto al servicio Tabla de Windows® Azure™. Para obtener más información, vea Diferencias entre el emulador de almacenamiento y los servicios de almacenamiento de Azure.

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.

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

 

Encabezado de solicitud Descripción

Authorization

Requerido. Especifica el esquema de autenticación, el nombre de la cuenta y la firma. Para obtener más información, vea Autenticación para los servicios de almacenamiento de Azure.

Date o x-ms-date

Requerido. Especifica la hora universal coordinada (UTC) para la solicitud. Para obtener más información, vea Autenticación para los servicios de almacenamiento de Azure.

x-ms-version

Opcional. Especifica la versión de la operación que se utiliza para esta solicitud. Para obtener más información, vea Versiones de los servicios Blob, Cola y Tabla de Windows Azure.

Accept

Opcional. Especifica el tipo de contenido aceptado de la carga de respuesta. 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, vea Formato de carga para las operaciones del servicio Tabla.

x-ms-client-request-id

Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 KB que se graba en los registros de análisis cuando el registro de análisis de almacenamiento está habilitado. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes recibidas por el servidor. Para obtener más información, vea Acerca del registro del análisis de almacenamiento y Registro de Windows Azure: usar registros para realizar el seguimiento de las solicitudes de almacenamiento.

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

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

Para obtener información acerca de los códigos de estado, vea Códigos de estado y de error y Códigos de error del servicio Tabla.

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 cumplen 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 cómo utilizar los tokens de continuación, vea Tiempo de espera y paginación de las consultas.

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 obtener más información, vea Solucionar problemas relacionados con las operaciones de la 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 acerca de los tipos de contenido válidos, vea Formato de carga para las operaciones del servicio Tabla.

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 encabezado Accept, el contenido es una fuente Atom o JSON.

Fuente Atom

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> 

JSON

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

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

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 acerca de los tokens de continuación, vea Tiempo de espera y paginación de las consultas.

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 acerca de las operaciones de consulta admitidas en el servicio Tabla mediante LINQ, vea Operadores de consulta admitidos para el servicio Tabla y Escribir consultas LINQ con el servicio Tabla.

¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios
Mostrar:
© 2015 Microsoft