Esporta (0) Stampa
Espandi tutto

Query Tables

Aggiornamento: febbraio 2014

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

La richiesta Query Tables può essere costruita nel modo seguente. Si consiglia di utilizzare HTTPS. Sostituire myaccount con il nome dell'account di archiviazione:

 

Metodo URI della richiesta Versione HTTP

GET

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

HTTP/1.1

Quando si effettua una richiesta nel servizio di archiviazione emulato, specificare il nome host dell'emulatore e la porta del servizio tabelle come 127.0.0.1:10002, seguiti dal nome dell'account di archiviazione emulato:

 

Metodo URI della richiesta Versione HTTP

GET

http://127.0.0.1:10002/devstoreaccount1/Tables

HTTP/1.1

Il servizio tabelle nel servizio di archiviazione emulato differisce dal servizio tabelle di Microsoft® Azure™ sotto diversi aspetti. Per altre informazioni, vedere About Development Storage e Differenze tra l'emulatore di archiviazione e i Servizi di archiviazione Azure.

L'operazione Query Tables supporta le opzioni di query definite dalla specifica del protocollo OData. Per altre informazioni, vedere la pagina relativa alle convenzioni URI OData.

Nella tabella seguente vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

 

Intestazione della richiesta Descrizione

Authorization

Obbligatorio. Specifica lo schema di autenticazione, il nome dell'account e la firma. Per altre informazioni, vedere Autenticazione per i servizi di archiviazione di Azure.

Date o x-ms-date

Obbligatorio. Specifica l'ora UTC (Coordinated Universal Time) per la richiesta. Per altre informazioni, vedere Autenticazione per i servizi di archiviazione di Azure.

x-ms-version

Facoltativo. Specifica la versione dell'operazione da utilizzare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.

Accept

Facoltativo. Specifica il tipo di contenuto accettato del payload di risposta. I valori possibili sono:

  • application/atom+xml

  • application/json;odata=nometadata

  • application/json;odata=minimalmetadata

  • application/json;odata=fullmetadata

Per altre informazioni, vedere Formato di payload per le operazioni del servizio tabelle.

x-ms-client-request-id

Facoltativo. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 KB che viene registrato nei log di analisi quando la registrazione di Analisi archiviazione è abilitata. L'utilizzo di questa intestazione è consigliato per la correlazione tra le attività sul lato client e le richieste ricevute dal server. Per altre informazioni vedere Informazioni sulla registrazione di Analisi archiviazione e l'articolo relativo all'utilizzo di log per tenere traccia delle richiesta di archiviazione nella registrazione di Azure.

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

Un'operazione completata correttamente restituisce il codice di stato 200 (OK).

Per informazioni sui codici di stato, vedere Codici ed errori di stato e Codici di errore del servizio tabelle.

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

 

Intestazione della risposta Descrizione

x-ms-continuation-NextTableName

Se il numero di tabelle da restituire supera 1.000 o la query non viene completata entro l'intervallo di timeout, l'intestazione della risposta include l'intestazione di continuazione x-ms-continuation-NextTableName. Questa intestazione restituisce il valore del token di continuazione. Per altre informazioni sull'utilizzo del token di continuazione, vedere Timeout e paginazione delle query.

x-ms-request-id

Questa intestazione identifica in modo univoco la richiesta effettuata e può essere utilizzata per risolvere i problemi relativi alla richiesta. Per altre informazioni, vedere Risoluzione dei problemi relativi alle operazioni dell'API.

x-ms-version

Indica la versione del servizio tabelle utilizzata per eseguire la richiesta. Questa intestazione viene restituita per le richieste effettuate nella versione 2009-09-19 e successive.

Date

Valore data/ora UTC generato dal servizio che indica l'ora in cui è stata avviata la risposta.

Content-Type

Indica il tipo di contenuto del payload. Il valore dipende dall'intestazione Accept della richiesta. I valori possibili sono:

  • application/atom+xml

  • application/json;odata=nometadata

  • application/json;odata=minimalmetadata

  • application/json;odata=fullmetadata

Per altre informazioni sui tipi di contenuto validi, vedere Formato di payload per le operazioni del servizio tabelle.

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 sarà un feed Atom o un feed JSON.

Feed Atom

Di seguito è riportato 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> 

JSON

Di seguito è riportato un esempio di corpo della risposta JSON per le operazioni Query Tables.

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

Metadati minimi

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

Senza metadati

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

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

Una query nel servizio tabelle può restituire un massimo di 1.000 tabelle contemporaneamente e può essere eseguita per un massimo di cinque secondi. Se il set di risultati contiene più di 1.000 tabelle, se la query non viene completata entro cinque secondi o se la query supera il limite della partizione, la risposta include un'intestazione personalizzata che contiene il token di continuazione x-ms-continuation-NextTableName. Il token di continuazione può essere utilizzato per costruire una richiesta successiva per la pagina di dati successiva. Per altre informazioni sui token di continuazione, vedere Timeout e paginazione delle query.

Si noti che il tempo totale assegnato alla richiesta per la pianificazione e l'elaborazione della query è 30 secondi, inclusi i cinque secondi per l'esecuzione della query.

Per altre informazioni sulle operazioni di query supportate nel servizio tabelle tramite LINQ, vedere Operatori di query supportati per il servizio tabelle e Scrittura di query LINQ nel servizio tabelle.

Mostra:
© 2014 Microsoft