Souhrn funkcí Table Storage

Rozhraní REST API služby Azure Table Storage je kompatibilní se specifikací protokolu OData s určitými rozdíly, jak je popsáno v následujících částech.

Rozšíření služby Table Storage

Table Storage rozšiřuje funkce OData služby následujícími způsoby.

Sdílený klíč, sdílený klíč Lite a autorizace Azure Active Directory

Table Storage vyžaduje, aby každý požadavek byl autorizovaný. Podporuje se sdílený klíč, sdílený klíč Lite a autorizace Microsoft Entra ID. Microsoft Entra ID autorizace je bezpečnější a doporučuje se pro požadavky na Table Storage pomocí rozhraní REST API.

Další informace o autorizaci požadavků najdete v tématu Autorizace požadavků do služby Azure Storage.

Tokeny pokračování pro stránkování dotazů

Dotaz na Table Storage může vrátit maximálně 1 000 položek najednou a může běžet maximálně pět sekund. Pokud sada výsledků obsahuje více než 1 000 položek nebo pokud se dotaz nedokončil během pěti sekund, bude odpověď obsahovat hlavičky. Tyto hlavičky poskytují vývojáři tokeny pro pokračování, které může použít, aby mohl dotaz obnovit u další položky v sadě výsledků. Hlavičky pokračovacího tokenu je možné vrátit pro operaci Tabulky dotazů nebo pro operaci Entity dotazu .

Všimněte si, že celková doba přidělená požadavku na plánování a zpracování dotazu je 30 sekund, včetně pěti sekund pro provádění dotazu.

Další informace o tokenech pro pokračování najdete v tématu Vypršení časového limitu a stránkování dotazů.

Vlastnosti systému primárního klíče

Každá entita ve službě Table Storage má dvě klíčové vlastnosti: PartitionKey vlastnost a RowKey vlastnost. Tyto vlastnosti tvoří primární klíč tabulky a jedinečně identifikují každou entitu v tabulce.

Obě vlastnosti vyžadují řetězcové hodnoty. Vývojář zodpovídá za zadání hodnot těchto vlastností při vložení nové entity a jejich zahrnutí do jakékoli operace aktualizace nebo odstranění entity.

Další informace o těchto požadovaných klíčových vlastnostech najdete v tématu Principy datového modelu Table Storage.

Systémová vlastnost časového razítka

Každá entita ve službě Table Storage má systémovou Timestamp vlastnost. Vlastnost Timestamp je DateTime hodnota, která se udržuje na straně serveru a zaznamenává čas poslední změny entity. Table Storage používá Timestamp vlastnost interně k zajištění optimistické souběžnosti. Hodnota je Timestamp monotónně rostoucí hodnota, což znamená, že pokaždé, když je entita změněna, se hodnota zvyšuje pro danou entitu Timestamp . Tato vlastnost by neměla být nastavena pro operace vložení nebo aktualizace (hodnota bude ignorována).

Další informace o vlastnosti najdete v Timestamp tématu Principy datového modelu Table Storage.

Operace služby Batch

Table Storage podporuje dávkové transakce u entit, které jsou ve stejné tabulce a patří do stejné skupiny oddílů, což znamená, že mají stejnou PartitionKey hodnotu. To umožňuje podporu více operací vložení, aktualizace, sloučení a odstranění v rámci jedné atomické transakce. Table Storage podporuje podmnožinu funkcí poskytovaných protokolem OData.

Další informace o dávkových operacích najdete v tématu Provádění transakcí skupin entit.

Omezení služby Table Storage

Table Storage má následující omezení funkcí poskytovaných službou OData.

Vlastnost Přihlašovací údaje

Table Storage nepodporuje použití vlastnosti Credentialstřídy DataServiceContext k autorizaci požadavku. Místo toho musíte autorizovat požadavek pro Table Storage přidáním Authorization hlavičky do požadavku. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.

Typy vlastností

Nepodporují se všechny typy vlastností, které OData podporuje. Seznam podporovaných typů vlastností najdete v tématu Principy datového modelu Table Storage.

Operace s odkazy

Table Storage v současné době nepodporuje propojení mezi tabulkami. Propojení jsou asociativní relace mezi daty.

Operace s vybranými vlastnostmi

Projekce označuje dotazování na podmnožinu vlastností entity nebo entit. Při dotazování v jazykových dotazech (LINQ) je to obdobou výběru podmnožina sloupců nebo vlastností tabulky.

Projekce snižuje množství dat, která musí být vrácena dotazem tím, že určuje, že v odpovědi jsou vráceny pouze určité vlastnosti. Projekce se podporuje jako součást verze Azure Storage z 8. 2011. 2011. Další informace najdete v tématech Dotazování entit, Zápis dotazů LINQ do služby Table Storage a OData: Výběr možnosti systémového dotazu ($select).

Operátory dotazů LINQ

Table Storage podporuje následující operátory dotazů LINQ:

• From

• Where

• Take

Další informace najdete v tématu Operátory dotazů podporované pro Table Storage.

Operátory porovnání LINQ

Můžete použít podmnožinu relačních operátorů poskytovaných linq. Další informace najdete v tématech Dotazování tabulek a entit a Zápis dotazů LINQ do služby Table Storage.

Metoda GetMetadataURI

Můžete použít Metodu GetMetadataURI třídy DataServiceContext , ale nevrací žádné informace o schématu nad rámec tří pevných vlastností schématu. Tyto vlastnosti jsou PartitionKey, RowKeya Timestamp.

Formáty datových částí

OData podporuje odesílání datových částí ve formátu JSON. Table Storage podporuje OData formát JSON od rozhraní API verze 2013-08-15 s OData verzí datové služby nastavenou na 3.0. Předchozí verze nepodporují formát JSON.

Datové části Atom jsou podporovány ve všech verzích starších než 2015-12-11. Verze 2015-12-11 a novější podporují pouze datové části JSON.

Poznámka

Json je doporučený formát datové části a je to jediný podporovaný formát pro verzi 2015-12-11 a novější.

Další informace najdete v tématech Formát datové části pro operace Table Storage a Nastavení hlaviček verze datové služby OData.

Viz také

Table Storage REST API