Consultar tablas

Artigo
06/27/2023

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.

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

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.

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

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:

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, vea Autorización de solicitudes a Azure Storage.
`Date` o `x-ms-date`	Necesario. Especifica la hora universal coordinada (UTC) de la solicitud. Para obtener más información, vea Autorización de solicitudes a 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, vea Versiones de 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` (versiones anteriores solo a 2015-12-11) - `application/json;odata=nometadata` - `application/json;odata=minimalmetadata` - `application/json;odata=fullmetadata` Para más información, consulte Formato de carga para las operaciones de Table Storage.
`x-ms-client-request-id`	Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 kibibyte (KiB) que se registra en los registros cuando se configura el registro. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes que recibe el servidor.

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 y Có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.

Encabezado de respuesta	Descripción
`x-ms-continuation-NextTableName`	Devuelve el valor del token de continuación. Si el número de tablas que se van a devolver supera los 1000 o la consulta no finaliza dentro del intervalo de tiempo de espera, el encabezado de respuesta incluye el encabezado de `x-ms-continuation-NextTableName` 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`	Identifica de forma única la solicitud que se realizó. Puede usarlo para solucionar problemas de la solicitud. Para más información, consulte Solución de problemas de operaciones de API.
`x-ms-version`	Indica la versión de Table Storage que se usa 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 que indica la hora en la que el servicio envió la respuesta.
`Content-Type`	Indica el tipo de contenido de la carga. El valor depende del encabezado de la `Accept` solicitud. 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 para las operaciones de Table Storage.
`x-ms-client-request-id`	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 de 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.

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.

Nota

Se recomienda JSON como formato de carga. Es el único formato admitido para la versión 2015-12-11 y posteriores.

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.

Nota:

Cuando realice 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, incluya esa opción en las solicitudes posteriores. De lo contrario, las solicitudes posteriores podrían devolver resultados inesperados.

La $top opción de consulta en este caso especifica el número máximo de resultados por página. No especifica el número máximo de resultados en todo el conjunto de respuestas.

Para obtener más información, vea Consulta de tablas y entidades.

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

Compartir por