A Table Storage funkcióinak összefoglalása
Az Azure Table Storage REST API megfelel az OData protokoll specifikációjának, néhány eltéréssel, az alábbi szakaszokban leírtak szerint.
Table Storage-bővítmények
A Table Storage az alábbi módokon bővíti OData
a funkcióját.
Megosztott kulcs, Megosztott kulcs Lite és Azure Active Directory-engedélyezés
A Table Storage megköveteli, hogy minden kérés engedélyezve legyen. A Megosztott kulcs, a Megosztott kulcs Lite és a Microsoft Entra ID engedélyezés támogatott. Microsoft Entra ID engedélyezés biztonságosabb, és ajánlott a Table Storage-ra irányuló kérések esetében a REST API használatával.
A kérelmek engedélyezéséről további információt a Kérések engedélyezése az Azure Storage-ba című témakörben talál.
Folytatási jogkivonatok a lekérdezések lapozásához
A Table Storage-ra vonatkozó lekérdezések egyszerre legfeljebb 1000 elemet adhatnak vissza, és legfeljebb öt másodpercig futtathatók. Ha az eredményhalmaz több mint 1000 elemet tartalmaz, vagy ha a lekérdezés öt másodpercen belül nem fejeződött be, a válasz fejléceket is tartalmaz. Ezek a fejlécek biztosítják a fejlesztőnek a használni kívánt folytatási jogkivonatokat, hogy az eredményhalmaz következő eleménél folytathassa a lekérdezést. A folytatási jogkivonat fejlécei lekérdezéstáblák vagy lekérdezési entitások művelethez is visszaadhatók.
Vegye figyelembe, hogy a lekérdezés ütemezésére és feldolgozására vonatkozó kérelemhez tartozó teljes idő 30 másodperc, beleértve a lekérdezés végrehajtásához szükséges öt másodpercet is.
További információ a folytatási jogkivonatokról: Lekérdezés időtúllépése és lapszámozása.
Elsődleges kulcsrendszer tulajdonságai
A Table Storage minden entitása két fő tulajdonsággal rendelkezik: a PartitionKey
tulajdonsággal és a RowKey
tulajdonsággal. Ezek a tulajdonságok alkotják a tábla elsődleges kulcsát, és egyedileg azonosítják a tábla minden entitását.
Mindkét tulajdonsághoz sztringértékek szükségesek. A fejlesztő felelőssége, hogy új entitás beszúrásakor értékeket adjon meg ezekhez a tulajdonságokhoz, és hogy belefoglalja őket az entitások frissítési vagy törlési műveleteibe.
További információ ezekről a szükséges kulcstulajdonságokról: A Table Storage adatmodell ismertetése.
Időbélyegző rendszertulajdonság
A Table Storage minden entitása rendelkezik rendszertulajdonságsal Timestamp
. A Timestamp
tulajdonság egy DateTime
kiszolgálóoldalon karbantartott érték, amely rögzíti az entitás utolsó módosításának időpontját. A Table Storage a Timestamp
tulajdonságot belsőleg használja az optimista egyidejűség biztosítására. A értéke Timestamp
egy monotonan növekvő érték, ami azt jelenti, hogy az entitás minden módosításakor az adott entitás értéke Timestamp
nő. Ez a tulajdonság nem állítható be beszúrási vagy frissítési műveleteknél (az érték figyelmen kívül lesz hagyva).
A tulajdonságról további információt a Timestamp
Table Storage adatmodell ismertetése című témakörben talál.
Batch-műveletek
A Table Storage támogatja az ugyanazon táblában lévő és ugyanabba a partíciócsoportba tartozó entitásokon végrehajtott kötegelt tranzakciókat, ami azt jelenti, hogy ugyanazzal PartitionKey
az értékkel rendelkeznek. Ez lehetővé teszi több beszúrási, frissítési, egyesítési és törlési művelet támogatását egyetlen atomi tranzakción belül. A Table Storage az OData protokoll által biztosított funkciók egy részét támogatja.
A kötegműveletekkel kapcsolatos további információkért lásd: Entitáscsoport-tranzakciók végrehajtása.
Table Storage-korlátozások
A Table Storage a következő korlátozásokkal rendelkezik a által OData
biztosított funkciókra vonatkozóan.
Hitelesítő adatok tulajdonság
A Table Storage nem támogatja a DataServiceContext osztály Hitelesítő adatok tulajdonságának használatát a kérések engedélyezéséhez. Ehelyett engedélyeznie kell egy kérést a Table Storage-ra, ha hozzáad egy fejlécet Authorization
a kéréshez. További információ: Kérések engedélyezése az Azure Storage-ba.
Tulajdonságtípusok
Nem minden által OData
támogatott tulajdonságtípus támogatott. A támogatott tulajdonságtípusok listáját lásd: A Table Storage adatmodell ismertetése.
Hivatkozásokon végzett műveletek
A Table Storage jelenleg nem támogatja a táblák közötti kapcsolatokat. A hivatkozások az adatok közötti asszociatív kapcsolatok.
Műveletek a kiválasztott tulajdonságokon
A leképezés egy entitás vagy entitás tulajdonságainak egy részhalmazának lekérdezésére utal. Hasonló a táblázat oszlopainak vagy tulajdonságainak egy részhalmazának kiválasztásához, amikor nyelvvel integrált lekérdezésekben (LINQ) kérdez le.
A leképezés csökkenti a lekérdezés által visszaadandó adatok mennyiségét, ha megadja, hogy csak bizonyos tulajdonságok legyenek visszaadva a válaszban. A kivetítés az Azure Storage 2011-08-18-as verziójának részeként támogatott. További információ: Lekérdezési entitások, LINQ-lekérdezések írása a Table Storage-ra és OData: Rendszerlekérdezés kiválasztása ($select).
LINQ-lekérdezési operátorok
A Table Storage a következő LINQ-lekérdezési operátorokat támogatja:
From
Where
Take
További információ: A Table Storage által támogatott lekérdezési operátorok.
LINQ összehasonlító operátorok
A LINQ által biztosított összehasonlító operátorok egy részhalmazát használhatja. További információ: Táblák és entitások lekérdezése ésLINQ-lekérdezések írása a Table Storage-ra.
GetMetadataURI metódus
Használhatja a DataServiceContext osztály GetMetadataURI metódusát, de a három rögzített sématulajdonságon túl nem ad vissza sémaadatokat. Ezek a tulajdonságok a következők: PartitionKey
, RowKey
és Timestamp
.
Adattartalom-formátumok
OData
támogatja a hasznos adatok JSON formátumban történő küldését. A Table Storage támogatja a JSON formátumot az OData
API 2013-08-15-ös verziójától, és az OData
adatszolgáltatás verziója 3.0-ra van állítva. A korábbi verziók nem támogatják a JSON formátumot.
Az Atom hasznos adatai a 2015-12-11 előtti verziókban támogatottak. A 2015-12-11-es és újabb verziók csak a JSON hasznos adatait támogatják.
Megjegyzés
A JSON az ajánlott hasznos adatformátum, és ez az egyetlen támogatott formátum a 2015-12-11-es és újabb verziókhoz.
További információ: A Table Storage-műveletek hasznos adatformátuma és az OData-adatszolgáltatás verziófejléceinek beállítása.