數據表記憶體功能的摘要
Azure 數據表記憶體 REST API 符合 OData 通訊協議規格,但有一些差異,如下列各節所述。
數據表記憶體延伸模組
數據表記憶體會以下列方式擴充 的功能 OData
。
共用金鑰、共用金鑰 Lite 和 Microsoft Entra 授權
數據表記憶體要求每個要求都獲得授權。 支援共用金鑰、共用金鑰 Lite 和 Microsoft Entra ID 授權。 Microsoft Entra ID 授權更安全,建議使用 REST API 對數據表記憶體提出的要求。
如需授權要求的詳細資訊,請參閱 授權 Azure 記憶體的要求。
查詢分頁的接續令牌
數據表記憶體的查詢一次最多可以傳回 1,000 個專案,而且最多可以執行五秒。 如果結果集包含超過 1,000 個專案,或查詢未在五秒內完成,則回應會包含標頭。 這些標頭會提供開發人員要使用的接續令牌,以便在結果集中的下一個專案繼續查詢。 您可以針對 查詢數據表 作業或 查詢實體 作業傳回接續令牌標頭。
請注意,配置給要求以進行排程和處理查詢的總時間為 30 秒,包括用來執行查詢的五秒。
如需接續令牌的詳細資訊,請參閱 查詢逾時和分頁。
主鍵系統屬性
數據表記憶體中的每個實體都有兩個主要屬性: PartitionKey
屬性和 RowKey
屬性。 這些屬性會形成數據表的主鍵,並唯一識別數據表中的每個實體。
這兩個屬性都需要字串值。 開發人員必須負責在插入新實體時提供這些屬性的值,並在實體上的任何更新或刪除作業中包含這些屬性。
如需這些必要索引鍵屬性的詳細資訊,請參閱 瞭解數據表記憶體數據模型。
時間戳系統屬性
數據表記憶體中的每個實體都有系統 Timestamp
屬性。 屬性 Timestamp
是在 DateTime
伺服器端維護的值,用來記錄上次修改實體的時間。 數據表記憶體會在 Timestamp
內部使用 屬性來提供開放式並行存取。
Timestamp
值是單純遞增的值,這表示每次修改實體時都將為該實體遞增 Timestamp
的值。 插入或更新作業則不應設定這個屬性 (會忽略其值)。
如需 屬性的詳細資訊 Timestamp
,請參閱 瞭解數據表記憶體數據模型。
批次作業
數據表記憶體支援相同數據表中實體的批次交易,並屬於相同的分割區群組,這表示它們具有相同 PartitionKey
的值。 如此便能在單一不可部分完成的交易中,支援多項插入、更新、合併及刪除作業。 數據表記憶體支援 OData 通訊協定所提供的功能子集。
如需批次作業的詳細資訊,請參閱 執行實體群組交易。
數據表記憶體限制
數據表記憶體對於所提供的 OData
功能有下列限制。
認證屬性
數據表記憶體不支援使用 DataServiceContext 類別的 Credentials 屬性來授權要求。 相反地,您必須將標頭新增 Authorization
至要求,以授權對數據表記憶體的要求。 如需詳細資訊,請參閱授權對 Azure 儲存體提出要求。
屬性類型
並非所有支援的屬性類型 OData
。 如需支援的屬性類型清單,請參閱 瞭解數據表記憶體數據模型。
連結的作業
數據表記憶體目前不支援資料表之間的連結。 連結是資料之間關聯資料的關聯性。
選取屬性上的作業
投影 是指查詢實體或實體之屬性的子集。 當您在語言整合式查詢中查詢 (LINQ) 時,類似於選取數據表的數據行或屬性子集。
投射會藉由指定只在回應中傳回某些屬性,減少必須由查詢傳回的資料數量。 在 2011-08-18 版的 Azure 記憶體中支援投影。 如需詳細資訊,請參閱 查詢實體、 針對資料表記憶體撰寫 LINQ 查詢和 OData:選取系統查詢選項 ($select) 。
LINQ 查詢運算符
資料表記憶體支援下列 LINQ 查詢運算子:
From
Where
Take
如需詳細資訊,請參閱 數據表記憶體支援的查詢運算符。
LINQ 比較運算符
您可以使用 LINQ 所提供的比較運算子集。 如需詳細資訊,請參閱 查詢數據表和實體, 以及 針對數據表記憶體撰寫 LINQ 查詢。
GetMetadataURI 方法
您可以使用 DataServiceContext 類別的 GetMetadataURI 方法,但不會傳回三個固定架構屬性以外的任何架構資訊。 這些屬性是 PartitionKey
、RowKey
和 Timestamp
。
裝載格式
OData
支援以 JSON 格式傳送承載。 數據表記憶體支援 OData
API 2013-08-15 版的 JSON 格式, OData
而數據服務版本設定為 3.0。 舊版不支援 JSON 格式。
2015-12-11 之前的所有版本都支援 Atom 承載。 版本 2015-12-11 和更新版本僅支援 JSON 承載。
注意
JSON 是建議的承載格式,它是 2015-12-11 版和更新版本唯一支援的格式。
如需詳細資訊,請參閱 數據表記憶體作業的承載格式 和 設定 OData 資料服務版本標頭。