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 le funzionalità di OData nei modi seguenti.
Chiave condivisa, chiave condivisa Lite e autorizzazione di Azure Active Directory
Archiviazione tabelle richiede che ogni richiesta sia autorizzata. Sono supportate chiavi condivise, Chiave condivisa Lite e Microsoft Entra ID l'autorizzazione. Microsoft Entra ID l'autorizzazione è più sicura ed è consigliabile per le richieste effettuate nell'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 sull'archiviazione tabelle può restituire un massimo di 1.000 elementi contemporaneamente e può essere eseguita 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 le intestazioni. Queste intestazioni forniscono allo sviluppatore 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 Query Tables o un'operazione Query Entities .
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 delle query e paginazione.
Proprietà del sistema di chiave primaria
Ogni entità in Archiviazione tabelle ha due proprietà chiave: la PartitionKey proprietà e la RowKey proprietà . Queste proprietà costituiscono 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à di sistema Timestamp
Ogni entità in Archiviazione tabelle ha una Timestamp proprietà di sistema. La Timestamp proprietà è un DateTime valore gestito sul lato server per registrare l'ora dell'ultima modifica di un'entità. Archiviazione tabelle usa internamente la Timestamp proprietà 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 Timestamp proprietà, vedere Informazioni sul modello 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, ovvero 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 presenta 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
L'archiviazione tabelle attualmente non supporta i collegamenti tra le tabelle. I collegamenti sono relazioni associative tra i dati.
Operazioni sulle proprietà selezionate
La proiezione fa riferimento all'esecuzione di query su 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 eseguono query in 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 Query Entities, Writing LINQ queries against Table Storage e OData: Select System Query Option ($select).
Operatori di query LINQ
Archiviazione tabelle supporta gli operatori di query LINQ seguenti:
FromWhereTake
Per altre informazioni, vedere Operatori di query supportati per l'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 su 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 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 alla versione 2015-12-11. La versione 2015-12-11 e successive supporta solo i payload JSON.
Nota
JSON è il formato di payload consigliato ed è l'unico formato supportato per la versione 2015-12-11 e successive.
Per altre informazioni, vedere Formato payload per le operazioni di archiviazione tabelle e Impostazione delle intestazioni della versione del servizio dati OData.