Query Tables
Comprimi il sommario
Espandi il sommario
Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Query Tables

 

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

La richiesta Query Tables può essere costruita come segue. È consigliato il protocollo 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 ulteriori informazioni, vedere differenze tra l'emulatore di archiviazione e 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 al protocollo OData.

Nella seguente tabella 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

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

Accept

Facoltativa. 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

Facoltativa. Fornisce un valore un opaco generato dal client con limite di caratteri pari a 1 KB che viene registrato nei log di analisi quando la registrazione di Analisi archiviazione è abilitata. L'uso di questa intestazione è fortemente consigliato per la correlazione delle attività lato client con le richieste ricevute dal server. Per ulteriori informazioni, vedere Informazioni sulla registrazione di Analisi archiviazione e la registrazione di Windows Azure: Utilizzo dei log per tenere traccia delle richieste di archiviazione.

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 200 (OK).

Per informazioni sui codici di stato, vedere Lo stato e i codici di errore 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 di query e la paginazione.

x-ms-request-id

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

x-ms-version

Indica la versione del servizio tabelle usata 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 usato per costruire una richiesta successiva per la pagina di dati successiva. Per altre informazioni sui token di continuazione, vedere Timeout di query e la paginazione.

System_CAPS_noteNota

Quando si effettuano le richieste successive che includono i token di continuazione, assicurarsi di passare l'URI originale nella richiesta. Ad esempio, se è stato specificato un $filter, $select, o $top opzione di query come parte della richiesta originale, si potrebbe voler includere questa opzione per le richieste successive. In caso contrario, le richieste successive possono restituire risultati imprevisti.

Si noti che il $top query opzione specifica in questo caso il numero massimo di risultati per pagina, non imposta il numero massimo di risultati nell'intera risposta.

Vedere Query di tabelle ed entità Per ulteriori dettagli.

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 (supporto del servizio tabelle) e Scrittura di query LINQ nel servizio tabelle.

Mostra:
© 2016 Microsoft