Podsumowanie funkcji usługi Table Service

Interfejs API REST usługi Table Service jest zgodny ze specyfikacją protokołu ODataz pewnymi różnicami, zgodnie z opisem w poniższych sekcjach.

Rozszerzenia usługi Table Service

Ograniczenia usługi Table Service

Rozszerzenia usługi Table Service

Usługa Table Service rozszerza funkcjonalność usługi OData w następujący sposób.

Klucz wspólny, klucz wspólny i autoryzacja Azure Active Directory współdzielona

Usługa Table Service wymaga autoryzacji każdego żądania. Obsługiwana jest autoryzacja klucza współużytk Azure Active Directory (Azure AD). Autoryzacja w usłudze Azure AD jest bezpieczniejsza i zalecana w przypadku żądań względem usługi Tabel 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 do stronicowania zapytań

Zapytanie względem usługi Table Service może zwrócić maksymalnie 1000 elementów jednocześnie i może być wykonywane przez maksymalnie pięć sekund. Jeśli zestaw wyników zawiera więcej niż 1000 elementów lub jeśli zapytanie nie zostało ukończone w ciągu pięciu sekund, odpowiedź zawiera nagłówki, które zapewniają deweloperowi tokeny kontynuacji do użycia w celu wznowienia zapytania przy następnym wierszu w zestawie wyników. Nagłówki tokenu kontynuacji mogą być zwracane dla operacji tabel zapytań lub operacji jednostki zapytania.

Należy pamiętać, że łączny czas dla żądania planowania i przetwarzania zapytania wynosi 30 sekund, w tym pięć sekund na wykonanie zapytania.

Aby uzyskać więcej informacji na temat tokenów kontynuacji, zobacz Query Timeout and Pagination (Limitczasu zapytania i stronicowanie).

Właściwości systemu klucza podstawowego

Każda jednostka w usłudze Table Service ma dwie kluczowe właściwości: PartitionKey właściwość i RowKey właściwość . Te właściwości razem tworzą klucz podstawowy tabeli i jednoznacznie identyfikują każdą jednostkę w tabeli.

Obie właściwości wymagają wartości ciągu. Deweloper odpowiada za podanie wartości dla tych właściwości po wstawieniu nowej jednostki i dołączeniu ich do dowolnej operacji aktualizacji lub usuwania w jednostce.

Aby uzyskać więcej informacji na temat tych wymaganych właściwości klucza, zobacz Understanding the Table Service Data Model (Omówienie modelu danych usługi Table Service).

Właściwość systemowa znacznika czasu

Każda jednostka w usłudze Table Service ma Timestamp właściwość systemową. Właściwość Timestamp jest wartością, która jest utrzymywana po stronie serwera w celu rekordu czasu ostatniej DateTime modyfikacji jednostki. Usługa Table Service używa Timestamp właściwości wewnętrznie do zapewnienia optymistycznej współbieżności. Wartość jest wartością monotonicznie zwiększającą się, co oznacza, że przy każdej modyfikacji jednostki wartość zwiększa Timestamp Timestamp się dla tej jednostki. Tej właściwości nie należy ustawiać dla operacji wstawiania ani aktualizowania (wartość zostanie zignorowana).

Aby uzyskać więcej informacji na temat Timestamp właściwości, zobacz Understanding the Table Service Data Model (Omówienie modelu danych usługi Table Service).

Operacje wsadowe

Usługa Table Service obsługuje transakcje wsadowe dla jednostek, które znajdują się w tej samej tabeli i należą do tej samej grupy partycji, co oznacza, że mają taką samą PartitionKey wartość. Dzięki temu wiele operacji wstawiania, aktualizowania, scalania i usuwania może być obsługiwanych w ramach jednej transakcji niepodzielnej. Usługa Table Service obsługuje podzbiór funkcji zapewnianych przez protokół OData.

Aby uzyskać więcej informacji na temat operacji wsadowych, zobacz Performing Entity Group Transactions (Wykonywanie transakcji grupy jednostek).

Ograniczenia usługi Table Service

Usługa Table Service ma następujące ograniczenia dotyczące funkcji zapewnianych przez usługę OData.

Credentials, właściwość

Usługa Table Service nie obsługuje autoryzowania żądania przy użyciu właściwości Credentials klasy DataServiceContext. Zamiast tego należy autoryzować żądanie względem usługi Table, 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 usługę OData są obsługiwane przez usługę Tabel. Aby uzyskać listę obsługiwanych typów właściwości, zobacz Understanding the Table Service Data Model (Omówienie modelu danych usługi Table Service).

Usługa Table Service obecnie nie obsługuje połączeń między tabelami. Linki są relacjami asocjacyjnymi między danymi.

Operacje na wybieranie właściwości

Projekcja odnosi się do wykonywania zapytań o podzbiór właściwości dla jednostki lub jednostek. Jest to analogiczne do wybierania podzestawu kolumn lub właściwości tabeli podczas wykonywania zapytań w linq. Projekcja zmniejsza ilość danych, które muszą być zwracane przez zapytanie, określając, że w odpowiedzi są zwracane tylko niektóre właściwości. Projekcja jest obsługiwana w ramach wersji 2011-08-18 usług Azure Storage. Aby uzyskać więcej informacji, zapoznaj się z tematami Query Entities(Jednostki zapytań), Writing LINQ Queries Against the Table Service(Pisanie zapytań LINQ względem usługi Table Service) i OData: Select System Query Option ($select) (OData: wybieranie opcji zapytania systemowego ($select).

Operatory zapytań LINQ

Usługa Table Service obsługuje korzystanie z zapytań zintegrowanych z językiem (LINQ). Tylko te operatory zapytań LINQ są obsługiwane w usłudze Table Service:

  • From

  • Where

  • Take

Aby uzyskać więcej informacji, zobacz Operatory zapytań obsługiwane w usłudze Table Service.

Operatory porównania LINQ

Usługa Table Service obsługuje użycie podzestawu operatorów porównania dostarczonych przez LINQ. Aby uzyskać więcej informacji, zobacz Querying Tables and Entities (Wykonywanie zapytań dotyczących tabel i jednostek) oraz Writing LINQ Queries Against the Table Service (Pisanie zapytań LINQ względem usługi Table Service).

GetMetadataURI, metoda

Usługa Table Service obsługuje metodę GetMetadataURI klasy DataServiceContext, ale nie zwraca żadnych informacji o schemacie wykraczających poza trzy stałe właściwości schematu. Te właściwości to PartitionKey , RowKey i Timestamp .

Formaty ładunków

Dane OData obsługują wysyłanie ładunków w formacie JSON. Usługa Azure Table Service obsługuje format JSON OData zgodnie z wersją interfejsu API 2013-08-15 z wersją usługi danych OData ustawioną na 3.0; Wcześniejsze wersje nie obsługują formatu JSON.

Ładunki Atom 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 formatem obsługiwanym w wersjach 2015-12-11 i nowszych.

Aby uzyskać więcej informacji, zobacz Format ładunku dla operacji usługi Table Service i Ustawianie nagłówków wersji usługi danych OData.

Zobacz też

Interfejs API REST usługi Table (Tabela)