Souhrn funkcí Table Storage
Rozhraní REST API služby Azure Table Storage je kompatibilní se specifikací protokolu OData, s několika 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 Microsoft Entra
Table Storage vyžaduje, aby každá žádost byla autorizována. 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 vůči službě 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 pro pokračování pro stránkování dotazů
Dotaz na službu Table Storage může najednou vrátit maximálně 1 000 položek a může běžet maximálně pět sekund. Pokud sada výsledků dotazu obsahuje více než 1 000 položek nebo pokud se dotaz nedokončil do pěti sekund, odpověď obsahuje hlavičky. Tyto hlavičky poskytují vývojáři tokeny pro pokračování, které může použít k obnovení dotazu při další položce v sadě výsledků dotazu. Hlavičky tokenu pro pokračování je možné vrátit pro operaci Tabulky dotazů nebo operace s entitami 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 provedení dotazu.
Další informace o tokenech pro pokračování najdete v tématu Vypršení časového limitu dotazu a stránkování.
Systémové vlastnosti 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 jednoznačně identifikují každou entitu v tabulce.
Obě vlastnosti vyžadují řetězcové hodnoty. Je zodpovědností vývojáře, aby při vložení nové entity zadal hodnoty těchto vlastností a zahrnul je 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 zachovaná na straně serveru, která zaznamenává čas poslední změny entity. Table Storage používá Timestamp vlastnost interně k zajištění optimistické souběžnosti. Hodnota Timestamp je monotónně rostoucí hodnota, což znamená, že pokaždé, když se entita změní, se hodnota Timestamp této entity zvýší. Tato vlastnost by neměla být nastavena při operacích vložení nebo aktualizace (hodnota bude ignorována).
Další informace o vlastnosti najdete v Timestamp tématu Principy datového modelu Table Storage.
Dávkové operace
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í pro funkce poskytované službou OData.
Vlastnost Credentials (Přihlašovací údaje)
Table Storage nepodporuje použití vlastnosti Credentials třídy DataServiceContext k autorizaci požadavku. Místo toho musíte žádost o službu Table Storage autorizovat 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í
Nejsou podporovány všechny typy vlastností, které podporuje OData . Seznam podporovaných typů vlastností najdete v tématu Vysvětlení datového modelu služby 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 odkazuje na dotazování podmnožinu vlastností entity nebo entit. Je to obdobou výběru podmnožině sloupců nebo vlastností tabulky při dotazování v dotazech integrovaných do jazyka (LINQ).
Projekce snižuje množství dat, která musí dotaz vrátit, tím, že v odpovědi určí, že se v odpovědi vrátí jenom určité vlastnosti. Projekce se podporuje jako součást služby Azure Storage z 18. 8. 2011. Další informace najdete v tématech Dotazování entit, Zápis dotazů LINQ do úložiště tabulek 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:
FromWhereTake
Další informace najdete v tématu Podporované operátory dotazů 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 verze rozhraní API 2013-08-15 s OData verzí datové služby nastavenou na 3.0. Předchozí verze nepodporují formát JSON.
Datové části Atom jsou podporované 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ý formát podporovaný 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.