Podsumowanie funkcji usługi Table Storage
Interfejs API REST usługi Azure Table Storage jest zgodny ze specyfikacją protokołu OData, z pewnymi różnicami, zgodnie z opisem w poniższych sekcjach.
Rozszerzenia usługi Table Storage
Usługa Table Storage rozszerza funkcjonalność OData
w następujący sposób.
Klucz wspólny, klucz wspólny Lite i autoryzacja usługi Azure Active Directory
Usługa Table Storage wymaga autoryzacji każdego żądania. Obsługiwane są klucze udostępnione, klucz współużytkowany Lite i autoryzacja Tożsamość Microsoft Entra. Tożsamość Microsoft Entra autoryzacja jest bezpieczniejsza i jest zalecana w przypadku żądań wysyłanych do usługi Table Storage przy użyciu interfejsu API REST.
Aby uzyskać więcej informacji na temat autoryzowania żądań, zobacz Autoryzowanie żądań do usługi Azure Storage.
Tokeny kontynuacji dla stronicowania zapytań
Zapytanie względem usługi Table Storage może zwrócić maksymalnie 1000 elementów jednocześnie i może działać przez maksymalnie pięć sekund. Jeśli zestaw wyników zawiera więcej niż 1000 elementów lub jeśli zapytanie nie zostało zakończone w ciągu pięciu sekund, odpowiedź zawiera nagłówki. Te nagłówki zapewniają deweloperowi tokeny kontynuacji do użycia, aby wznowić zapytanie w następnym elemencie w zestawie wyników. Nagłówki tokenu kontynuacji można zwrócić dla operacji Tabele zapytań lub operacji Jednostki zapytania .
Należy pamiętać, że łączny czas przydzielony do żądania planowania i przetwarzania zapytania wynosi 30 sekund, w tym pięć sekund na potrzeby wykonywania zapytania.
Aby uzyskać więcej informacji na temat tokenów kontynuacji, zobacz Limit czasu zapytania i stronicowanie.
Właściwości systemu klucza podstawowego
Każda jednostka w usłudze Table Storage ma dwie właściwości klucza: PartitionKey
właściwość i RowKey
właściwość. Te właściwości tworzą klucz podstawowy tabeli i jednoznacznie identyfikują każdą jednostkę w tabeli.
Obie właściwości wymagają wartości ciągów. Jest to odpowiedzialność dewelopera za podanie wartości dla tych właściwości po wstawieniu nowej jednostki i dołączenie ich do dowolnej operacji aktualizacji lub usuwania w jednostce.
Aby uzyskać więcej informacji na temat tych wymaganych właściwości klucza, zobacz Omówienie modelu danych usługi Table Storage.
Właściwość systemowa znacznika czasu
Każda jednostka w usłudze Table Storage ma właściwość systemową Timestamp
. Właściwość Timestamp
jest wartością przechowywaną DateTime
po stronie serwera, aby zarejestrować czas ostatniej modyfikacji jednostki. Usługa Table Storage używa Timestamp
właściwości wewnętrznie, aby zapewnić optymistyczną współbieżność. Wartość jest Timestamp
monotonicznie rosnącą wartością, co oznacza, że za każdym razem, gdy jednostka jest modyfikowana, wartość Timestamp
wzrostu dla tej jednostki. Ta właściwość nie powinna być ustawiana w operacjach wstawiania lub aktualizowania (wartość zostanie zignorowana).
Aby uzyskać więcej informacji na temat właściwości, zobacz Understanding the Timestamp
Table Storage data model (Opis modelu danych usługi Table Storage).
Operacje wsadowe
Usługa Table Storage obsługuje transakcje wsadowe dla jednostek znajdujących się w tej samej tabeli i należą do tej samej grupy partycji, co oznacza, że mają taką samą PartitionKey
wartość. Dzięki temu można obsługiwać wiele operacji wstawiania, aktualizowania, scalania i usuwania w ramach jednej transakcji niepodzielnej. Usługa Table Storage obsługuje podzestaw funkcji udostępnianych przez protokół OData.
Aby uzyskać więcej informacji na temat operacji wsadowych, zobacz Wykonywanie transakcji grupy jednostek.
Ograniczenia usługi Table Storage
Usługa Table Storage ma następujące ograniczenia dotyczące funkcjonalności udostępnianej przez program OData
.
Właściwość Credentials
Usługa Table Storage nie obsługuje używania właściwości Credentials klasy DataServiceContext w celu autoryzowania żądania. Zamiast tego należy autoryzować żądanie względem usługi Table Storage, dodając Authorization
nagłówek do żądania. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
Typy właściwości
Obsługiwane są nie wszystkie typy właściwości obsługiwane przez OData
program . Aby uzyskać listę obsługiwanych typów właściwości, zobacz Omówienie modelu danych usługi Table Storage.
Operacje na łączach
Usługa Table Storage nie obsługuje obecnie łączy między tabelami. Łącza to relacje asocjacyjne między danymi.
Operacje na wybranych właściwościach
Projekcja odnosi się do wykonywania zapytań względem podzestawu właściwości jednostki lub jednostek. Jest to analogiczne do wybierania podzestawu kolumn lub właściwości tabeli podczas wykonywania zapytań w zapytaniach zintegrowanych z językiem (LINQ).
Projekcja zmniejsza ilość danych, które muszą być zwracane przez zapytanie, określając, że w odpowiedzi są zwracane tylko określone właściwości. Projekcja jest obsługiwana w ramach wersji 2011-08-18 usługi Azure Storage. Aby uzyskać więcej informacji, zobacz Tworzenie zapytańLINQ względem usługi Table Storage i OData: Wybieranie opcji zapytania systemowego ($select).
Operatory zapytań LINQ
Usługa Table Storage obsługuje następujące operatory zapytań LINQ:
From
Where
Take
Aby uzyskać więcej informacji, zobacz Operatory zapytań obsługiwane dla usługi Table Storage.
Operatory porównania LINQ
Możesz użyć podzestawu operatorów porównania udostępnianych przez LINQ. Aby uzyskać więcej informacji, zobacz Wykonywanie zapytań względem tabel i jednostek oraz Pisanie zapytań LINQ względem usługi Table Storage.
GetMetadataURI, metoda
Można użyć metody GetMetadataURI klasy DataServiceContext , ale nie zwraca żadnych informacji schematu poza trzema stałymi właściwościami schematu. Te właściwości to PartitionKey
, RowKey
i Timestamp
.
Formaty ładunków
OData
obsługuje wysyłanie ładunków w formacie JSON. Usługa Table Storage obsługuje OData
format JSON w wersji 2013-08-15 z wersją OData
usługi danych ustawioną na 3.0. Wcześniejsze wersje nie obsługują formatu JSON.
Ładunki atomów są obsługiwane we wszystkich wersjach wcześniejszych niż 2015-12-11. Wersja 2015-12-11 i nowsza obsługują tylko ładunki JSON.
Uwaga
Format JSON jest zalecanym formatem ładunku i jest jedynym formatem obsługiwanym w wersji 2015-12-11 lub nowszej.
Aby uzyskać więcej informacji, zobacz Format ładunku dla operacji usługi Table Storage i Ustawianie nagłówków wersji usługi danych OData.