Zusammenfassung der Tabellenspeicherfunktionen
Die Azure Table Storage-REST-API ist mit der OData-Protokollspezifikation kompatibel, mit einigen Unterschieden, wie in den folgenden Abschnitten beschrieben.
Tabellenspeichererweiterungen
Table Storage erweitert die Funktionalität von OData auf folgende Weise.
Shared Key, Shared Key Lite und Microsoft Entra Autorisierung
Table Storage erfordert, dass jede Anforderung autorisiert wird. Shared Key, Shared Key Lite und Microsoft Entra ID Autorisierung werden unterstützt. Microsoft Entra ID Autorisierung ist sicherer und wird für Anforderungen empfohlen, die mithilfe der REST-API an Table Storage gesendet werden.
Weitere Informationen zum Autorisieren von Anforderungen finden Sie unter Autorisieren von Anforderungen für Azure Storage.
Fortsetzungstoken für die Abfragepa paginierung
Eine Abfrage für Table Storage kann maximal 1.000 Elemente gleichzeitig zurückgeben und maximal fünf Sekunden lang ausgeführt werden. Wenn das Resultset mehr als 1.000 Elemente enthält oder die Abfrage nicht innerhalb von fünf Sekunden abgeschlossen wurde, enthält die Antwort Header. Diese Header stellen dem Entwickler Fortsetzungstoken zur Verfügung, die verwendet werden sollen, um die Abfrage beim nächsten Element im Resultset fortzusetzen. Fortsetzungstokenheader können für einen Abfragetabellen-Vorgang oder einen Abfrageentitätenvorgang zurückgegeben werden.
Beachten Sie, dass die zugewiesene Gesamtzeit für die Anforderung zum Planen und Verarbeiten der Abfrage 30 Sekunden beträgt, einschließlich der fünf Sekunden für die Abfrageausführung.
Weitere Informationen zu Fortsetzungstoken finden Sie unter Abfragetimeout und Paginierung.
Eigenschaften des Primärschlüsselsystems
Jede Entität in Table Storage verfügt über zwei Schlüsseleigenschaften: die PartitionKey -Eigenschaft und die RowKey -Eigenschaft. Diese Eigenschaften bilden den Primärschlüssel der Tabelle und identifizieren jede Entität in der Tabelle eindeutig.
Beide Eigenschaften erfordern Zeichenfolgenwerte. Es liegt in der Verantwortung des Entwicklers, Werte für diese Eigenschaften bereitzustellen, wenn eine neue Entität eingefügt wird, und sie in jeden Aktualisierungs- oder Löschvorgang für eine Entität aufzunehmen.
Weitere Informationen zu diesen erforderlichen Schlüsseleigenschaften finden Sie unter Grundlegendes zum Tabellenspeicherdatenmodell.
Zeitstempelsystemeigenschaft
Jede Entität in Table Storage verfügt über eine Timestamp Systemeigenschaft. Die Timestamp Eigenschaft ist ein DateTime Wert, der auf der Serverseite verwaltet wird, um den Zeitpunkt aufzuzeichnen, zu dem eine Entität zuletzt geändert wurde. Table Storage verwendet die Timestamp Eigenschaft intern, um eine optimistische Parallelität bereitzustellen. Der Wert von Timestamp ist ein monoton steigender Wert, das bedeutet, dass bei jeder Änderung der Entität der Wert von Timestamp für diese Entität steigt. Diese Eigenschaft sollte nicht für Einfüge- und Updatevorgänge festgelegt werden (der Wert wird ignoriert).
Weitere Informationen zur Timestamp -Eigenschaft finden Sie unter Grundlegendes zum Tabellenspeicherdatenmodell.
Batchvorgänge
Table Storage unterstützt Batchtransaktionen für Entitäten, die sich in derselben Tabelle befinden und derselben Partitionsgruppe angehören, was bedeutet, dass sie den gleichen PartitionKey Wert haben. So können in einer einzelnen unteilbaren Transaktion mehrere Einfüge-, Update-, Zusammenführungs- und Löschvorgänge unterstützt werden. Table Storage unterstützt eine Teilmenge der Vom OData-Protokoll bereitgestellten Funktionen.
Weitere Informationen zu Batchvorgängen finden Sie unter Durchführen von Entitätsgruppentransaktionen.
Tabellenspeichereinschränkungen
Table Storage weist die folgenden Einschränkungen für die Funktionalität auf, die von bereitgestellt werden OData.
Credentials-Eigenschaft
Table Storage unterstützt die Verwendung der Credentials-Eigenschaft der DataServiceContext-Klasse zum Autorisieren einer Anforderung nicht. Stattdessen müssen Sie eine Anforderung für Table Storage autorisieren, indem Sie der Anforderung einen Authorization Header hinzufügen. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage.
Eigenschaftentypen
Nicht alle von OData unterstützten Eigenschaftentypen werden unterstützt. Eine Liste der unterstützten Eigenschaftentypen finden Sie unter Grundlegendes zum Tabellenspeicherdatenmodell.
Vorgänge für Links
Tabellenspeicher unterstützt derzeit keine Verknüpfungen zwischen Tabellen. Links sind verknüpfende Beziehungen zwischen Daten.
Vorgänge für ausgewählte Eigenschaften
Projektion bezieht sich auf das Abfragen einer Teilmenge der Eigenschaften für eine Entität oder Entitäten. Dies entspricht der Auswahl einer Teilmenge der Spalten oder Eigenschaften einer Tabelle, wenn Sie in sprachintegrierte Abfragen (LINQ) abfragen.
Durch die Projektion wird die von einer Abfrage zurückzugebende Datenmenge verringert, indem angegeben wird, dass nur bestimmte Eigenschaften in der Antwort zurückgegeben werden. Projektion wird als Teil der Version 2011-08-18 von Azure Storage unterstützt. Weitere Informationen finden Sie unter Abfrageentitäten, Schreiben von LINQ-Abfragen für Tabellenspeicher und OData: Auswählen der Systemabfrageoption ($select).
LINQ-Abfrageoperatoren
Table Storage unterstützt die folgenden LINQ-Abfrageoperatoren:
FromWhereTake
Weitere Informationen finden Sie unter Für Table Storage unterstützte Abfrageoperatoren.
LINQ-Vergleichsoperatoren
Sie können eine Teilmenge der von LINQ bereitgestellten Vergleichsoperatoren verwenden. Weitere Informationen finden Sie unter Abfragen von Tabellen und Entitäten undSchreiben von LINQ-Abfragen für Tabellenspeicher.
GetMetadataURI-Methode
Sie können die GetMetadataURI-Methode der DataServiceContext-Klasse verwenden, gibt jedoch keine Schemainformationen über die drei festen Schemaeigenschaften hinaus zurück. Bei diesen Eigenschaften handelt es sich um PartitionKey, RowKey und Timestamp.
Nutzlastformate
OData unterstützt das Senden von Nutzlasten im JSON-Format. Table Storage unterstützt das OData JSON-Format ab API-Version 2013-08-15, wobei die OData Datendienstversion auf 3.0 festgelegt ist. Frühere Versionen unterstützen das JSON-Format nicht.
Atom-Nutzlasten werden in allen Versionen vor 2015-12-11 unterstützt. Version 2015-12-11 und höher unterstützen nur JSON-Nutzlasten.
Hinweis
JSON ist das empfohlene Nutzlastformat und das einzige Format, das für Version 2015-12-11 und höher unterstützt wird.
Weitere Informationen finden Sie unter Nutzlastformat für Tabellenspeichervorgänge und Festlegen der OData-Datendienstversionsheader.