Query su tabelle

L'operazione Query Tables restituisce un elenco di tabelle con l'account specificato.

Richiesta

È possibile costruire la Query Tables richiesta come indicato di seguito. È consigliabile usare HTTPS. Sostituire myaccount con il nome dell'account di archiviazione.

URI del servizio di archiviazione emulato

Quando si effettua una richiesta per il servizio di archiviazione emulato, specificare il nome host dell'emulatore e la porta del servizio tabelle come 127.0.0.1:10002. Seguire queste informazioni con il nome dell'account di archiviazione emulato.

Il servizio tabelle nell'emulatore di archiviazione differisce da Archiviazione tabelle di Azure in diversi modi. Per altre informazioni, vedere Differenze tra l'emulatore di archiviazione e i servizi di archiviazione di Azure.

Parametri URI

L'operazione Query Tables supporta le opzioni di query definite dalla specifica del protocollo OData .

Intestazioni della richiesta

La tabella seguente descrive le intestazioni di richiesta obbligatorie e facoltative:

Testo della richiesta

Nessuno.

Risposta

Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni per la risposta e il corpo di una risposta.

Codice stato

Un'operazione completata correttamente restituisce 200 (OK).

Per informazioni sui codici di stato, vedere Codici di errore e di stato e codici di errore di archiviazione tabelle.

Intestazioni di risposta

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; La risposta potrebbe includere anche intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

Corpo della risposta

L'operazione Query Tables restituisce l'elenco delle tabelle nell'account come set di entità OData. In base al valore dell'intestazione Accept , il contenuto è JSON o un feed Atom.

JSON (versione 2013-08-15 e successive)

Ecco un esempio di corpo della risposta JSON per un'operazione Query Tables con metadati completi:

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

Ecco un corpo di risposta JSON di esempio per un'operazione Query Tables con metadati minimi:

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

Ecco un corpo di risposta JSON di esempio per un'operazione Query Tables senza metadati:

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

Feed Atom (versioni precedenti al 2015-12-11)

Ecco un esempio di corpo della risposta Atom per l'operazione 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>   

Autorizzazione

Solo il proprietario dell'account può chiamare questa operazione.

Commenti

Una query su Archiviazione tabelle può restituire un massimo di 1.000 tabelle contemporaneamente ed eseguire per un massimo di cinque secondi. La risposta include un'intestazione personalizzata che contiene il x-ms-continuation-NextTableName token di continuazione in uno dei casi seguenti:

• Il set di risultati contiene più di 1.000 tabelle.
• La query non è stata completata entro cinque secondi.
• La query supera il limite della partizione.

È possibile usare la continuazione per costruire una richiesta successiva per la pagina successiva di dati. Per altre informazioni sui token di continuazione, vedere Timeout delle query e paginazione.

Il tempo totale assegnato alla richiesta di pianificazione ed elaborazione della query è di 30 secondi. Il totale include i cinque secondi per l'esecuzione della query.

Per altre informazioni sulle operazioni di query supportate sull'archiviazione tabelle tramite LINQ, vedere Operatori di query supportati per l'archiviazione tabelle e Scrivere query LINQ su Archiviazione tabelle.

Vedi anche

Indirizzamento delle risorse di archiviazione tabelle
Autorizzare le richieste ad Archiviazione di Azure
Impostare le intestazioni della versione del servizio dati OData
Stato e codici errore
Codici di errore di archiviazione tabelle