Riepilogo delle funzionalità di archiviazione tabelle
L'API REST di Archiviazione tabelle di Azure è conforme alla specifica del protocollo OData, con alcune differenze, come descritto nelle sezioni seguenti.
Estensioni di Archiviazione tabelle
Archiviazione tabelle estende la funzionalità di OData nei modi seguenti.
Chiave condivisa, Shared Key Lite e Microsoft Entra autorizzazione
Archiviazione tabelle richiede che ogni richiesta sia autorizzata. Sono supportate chiavi condivise, Shared Key Lite e Microsoft Entra ID autorizzazione. Microsoft Entra ID'autorizzazione è più sicura e è consigliabile per le richieste effettuate in Archiviazione tabelle usando l'API REST.
Per altre informazioni sull'autorizzazione delle richieste, vedere Autorizzare le richieste ad Archiviazione di Azure.
Token di continuazione per la paginazione delle query
Una query su Archiviazione tabelle può restituire un massimo di 1.000 elementi alla volta e può essere eseguito per un massimo di cinque secondi. Se il set di risultati contiene più di 1.000 elementi o se la query non è stata completata entro cinque secondi, la risposta include intestazioni. Queste intestazioni forniscono allo sviluppatore i token di continuazione da usare, per riprendere la query all'elemento successivo nel set di risultati. Le intestazioni del token di continuazione possono essere restituite per un'operazione Tabelle di query o per un'operazione Entità 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 sui token di continuazione, vedere Timeout query e impaginazione.
Proprietà del sistema chiave primaria
Ogni entità in Archiviazione tabelle ha due proprietà chiave: la PartitionKey proprietà e la RowKey proprietà. Queste proprietà formano la chiave primaria della tabella e identificano in modo univoco ogni entità nella tabella.
Entrambe le proprietà richiedono valori stringa. È responsabilità dello sviluppatore fornire valori per queste proprietà quando viene inserita una nuova entità e includerli in qualsiasi operazione di aggiornamento o eliminazione in un'entità.
Per altre informazioni su queste proprietà chiave necessarie, vedere Informazioni sul modello di dati di archiviazione tabelle.
Proprietà del sistema Timestamp
Ogni entità in Archiviazione tabelle ha una Timestamp proprietà di sistema. La Timestamp proprietà è un DateTime valore, mantenuto sul lato server, per registrare l'ultima modifica di un'entità. Archiviazione tabelle usa la Timestamp proprietà internamente per fornire concorrenza ottimistica. Il valore Timestamp è un valore a incremento progressivo costante, pertanto ogni volta che l'entità viene modificata, il valore Timestamp per tale entità aumenta. È consigliabile non impostare questa proprietà in operazioni di inserimento o aggiornamento (il valore viene ignorato).
Per altre informazioni sulla proprietà, vedere Informazioni sul Timestampmodello di dati di archiviazione tabelle.
Operazioni batch
Archiviazione tabelle supporta le transazioni batch nelle entità che si trovano nella stessa tabella e appartengono allo stesso gruppo di partizioni, il che significa che hanno lo stesso PartitionKey valore. In questo modo, è consentito eseguire più operazioni di inserimento, aggiornamento, unione ed eliminazione in una singola transazione atomica. Archiviazione tabelle supporta un subset delle funzionalità fornite dal protocollo OData.
Per altre informazioni sulle operazioni batch, vedere Esecuzione di transazioni del gruppo di entità.
Restrizioni di archiviazione tabelle
Archiviazione tabelle ha le restrizioni seguenti sulle funzionalità fornite da OData.
Credentials, proprietà
Archiviazione tabelle non supporta l'uso della proprietà Credentials della classe DataServiceContext per autorizzare una richiesta. È invece necessario autorizzare una richiesta in Archiviazione tabelle aggiungendo un'intestazione Authorization alla richiesta. Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure.
Tipi di proprietà
Non tutti i tipi di proprietà supportati da OData sono supportati. Per un elenco dei tipi di proprietà supportati, vedere Informazioni sul modello di dati di archiviazione tabelle.
Operazioni sui collegamenti
Archiviazione tabelle non supporta attualmente collegamenti tra tabelle. I collegamenti sono relazioni associative tra i dati.
Operazioni su proprietà selezionate
La proiezione fa riferimento alla query di un subset delle proprietà per un'entità o entità. È analogo alla selezione di un subset delle colonne o delle proprietà di una tabella quando si esegue una query nelle query integrate nel linguaggio (LINQ).
La proiezione riduce la quantità di dati che deve essere restituita da una query specificando che solo determinate proprietà vengono restituite nella risposta. La proiezione è supportata come parte della versione 2011-08-18 di Archiviazione di Azure. Per altre informazioni, vedere Entità di query, scrittura di query LINQ in Archiviazione tabelle e OData: selezionare l'opzione query di sistema ($select).
Operatori di query LINQ
Archiviazione tabelle supporta gli operatori di query LINQ seguenti:
FromWhereTake
Per altre informazioni, vedere Operatori di query supportati per Archiviazione tabelle.
Operatori di confronto LINQ
È possibile usare un subset degli operatori di confronto forniti da LINQ. Per altre informazioni, vedere Esecuzione di query su tabelle ed entità e scrittura di query LINQ in Archiviazione tabelle.
Metodo GetMetadataURI
È possibile usare il metodo GetMetadataURI della classe DataServiceContext , ma non restituisce informazioni sullo schema oltre le tre proprietà dello schema fisse. Tali proprietà sono PartitionKey, RowKey e Timestamp.
Formati di payload
OData supporta l'invio di payload in formato JSON. Archiviazione tabelle supporta il OData formato JSON a partire dalla versione dell'API 2013-08-15, con la versione del OData servizio dati impostata su 3.0. Le versioni precedenti non supportano il formato JSON.
I payload Atom sono supportati in tutte le versioni precedenti al 2015-12-11. Versione 2015-12-11 e versioni successive supportano solo payload JSON.
Nota
JSON è il formato del payload consigliato ed è l'unico formato supportato per la versione 2015-12-11 e versioni successive.
Per altre informazioni, vedere Formato payload per le operazioni di archiviazione tabelle e Impostazione delle intestazioni della versione del servizio dati OData.