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 usługi w następujący sposób.
Klucz wspólny, klucz wspólny Lite i autoryzacja Microsoft Entra
Usługa Table Storage wymaga autoryzowania każdego żądania. Obsługiwany jest klucz wspólny, klucz współużytkowany w wersji 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 zwracać maksymalnie 1000 elementów jednocześnie i może być uruchamiane 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 mogą być zwracane dla operacji tabel zapytań lub operacji jednostki kwerendy .
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 kluczowe właściwości: 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ągu. Deweloper jest odpowiedzialny za podanie wartości tych właściwości podczas wstawiania nowej jednostki oraz dołączania ich do dowolnej operacji aktualizacji lub usuwania jednostki.
Aby uzyskać więcej informacji na temat tych wymaganych kluczowych właściwości, zobacz Omówienie modelu danych usługi Table Storage.
Właściwość systemowa sygnatury czasowej
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 w celu zarejestrowania czasu ostatniej modyfikacji jednostki. Usługa Table Storage używa Timestamp właściwości wewnętrznie do zapewnienia optymistycznej współbieżności. Wartość Timestamp jest monotonicznie rosnącą wartością, co oznacza, że za każdym razem, gdy jednostka jest modyfikowana, wartość Timestamp zwiększa się dla tej jednostki. Nie należy ustawiać tej właściwości w operacjach wstawiania ani aktualizowania (wartość zostanie zignorowana).
Aby uzyskać więcej informacji na temat Timestamp właściwości, zobacz Understanding the Table Storage data model (Omówienie 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ą tę 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 funkcji udostępnianych przez ODatausługę .
Właściwość Credentials
Usługa Table Storage nie obsługuje używania właściwości Credentials klasy DataServiceContext do 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
Nie wszystkie typy właściwości obsługiwane przez OData program są obsługiwane. 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 dotyczące wybierania właściwości
Projekcja odnosi się do wykonywania zapytań względem podzbioru właściwości jednostki lub jednostek. Analogicznie jest wybierać podzbiór 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 tylko niektóre właściwości są zwracane w odpowiedzi. Projekcja jest obsługiwana w wersji 2011-08-18 usługi Azure Storage. Aby uzyskać więcej informacji, zobacz Query Entities , Writing LINQ queries against Table Storage (Tworzenie zapytań LINQ względem usługi Table Storage) i OData: Select System Query Option ($select).
Operatory zapytań LINQ
Usługa Table Storage obsługuje następujące operatory zapytań LINQ:
FromWhereTake
Aby uzyskać więcej informacji, zobacz Operatory zapytań obsługiwane przez usługę Table Storage.
Operatory porównania LINQ
Można użyć podzestawu operatorów porównania dostarczonych przez LINQ. Aby uzyskać więcej informacji, zobacz Wykonywanie zapytań dotyczących 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 o schemacie poza trzema stałymi właściwościami schematu. Te właściwości to PartitionKey, RowKeyi 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 OData wersją 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 nowsze obsługują tylko ładunki JSON.
Uwaga
Format JSON jest zalecanym formatem ładunku i jest jedynym obsługiwanym formatem 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.