數據表記憶體功能的摘要

Azure 表格記憶體 REST API 符合 OData 通訊協定規格,但有一些差異,如下列各節所述。

數據表記憶體擴充功能

數據表記憶體會以下列方式擴充 的功能 OData

共用金鑰、共用金鑰 Lite 和 Azure Active Directory 授權

數據表記憶體要求每個要求都必須獲得授權。 支援共用金鑰、共用金鑰 Lite 和 Microsoft Entra ID 授權。 Microsoft Entra ID 授權更安全,建議使用 REST API 對數據表記憶體提出的要求。

如需授權要求的詳細資訊,請參閱 授權 Azure 記憶體的要求

查詢分頁的接續令牌

數據表記憶體的查詢一次最多可以傳回 1,000 個專案,而且最多可以執行五秒。 如果結果集包含超過 1,000 個專案,或查詢未在五秒內完成,則回應會包含標頭。 這些標頭會提供開發人員要使用的接續令牌,以便在結果集中的下一個專案繼續查詢。 查詢 數據表 作業或 查詢實體 作業可以傳回接續令牌標頭。

請注意,配置給要求以進行排程和處理查詢的總時間為 30 秒,包括用來執行查詢的五秒。

如需接續令牌的詳細資訊,請參閱 查詢逾時和分頁

主鍵系統屬性

數據表記憶體中的每個實體都有兩個主要屬性: PartitionKey 屬性和 RowKey 屬性。 這些屬性會形成數據表的主鍵,並唯一識別數據表中的每個實體。

這兩個屬性都需要字串值。 開發人員必須負責在插入新實體時提供這些屬性的值,並在實體的任何更新或刪除作業中包含這些屬性。

如需這些必要索引鍵屬性的詳細資訊,請參閱 瞭解數據表記憶體數據模型

Timestamp 系統屬性

數據表記憶體中的每個實體都有 Timestamp 系統屬性。 屬性 Timestamp 是在 DateTime 伺服器端維護的值,用來記錄上次修改實體的時間。 數據表記憶體會在 Timestamp 內部使用 屬性來提供開放式並行存取。 Timestamp 值是單純遞增的值,這表示每次修改實體時都將為該實體遞增 Timestamp 的值。 插入或更新作業則不應設定這個屬性 (會忽略其值)。

如需 屬性的詳細資訊 Timestamp ,請參閱 瞭解數據表記憶體數據模型

批次作業

數據表記憶體支援相同數據表中實體上的批次交易,且屬於相同的分割區群組,這表示它們具有相同 PartitionKey 的值。 如此便能在單一不可部分完成的交易中,支援多項插入、更新、合併及刪除作業。 數據表記憶體支援 OData 通訊協定所提供的功能子集。

如需批次作業的詳細資訊,請參閱 執行實體群組交易

數據表記憶體限制

數據表記憶體對於所提供的 OData功能有下列限制。

認證屬性

數據表記憶體不支援使用 DataServiceContext 類別的 Credentials 屬性來授權要求。 相反地,您必須將標頭新增 Authorization 至要求,以授權對數據表記憶體的要求。 如需詳細資訊,請參閱授權對 Azure 儲存體提出要求

屬性類型

並非所有 支援 OData 的屬性類型。 如需支援的屬性類型清單,請參閱 瞭解數據表記憶體數據模型

數據表記憶體目前不支援資料表之間的連結。 連結是資料之間關聯資料的關聯性。

選取屬性上的作業

投影 是指查詢實體或實體屬性的子集。 當您在語言整合式查詢中查詢 (LINQ) 時,類似於選取數據表的數據行或屬性子集。

投射會藉由指定只在回應中傳回某些屬性,減少必須由查詢傳回的資料數量。 Azure 記憶體的 2011-08-18 版本支援投影。 如需詳細資訊,請參閱 查詢實體針對資料表記憶體撰寫 LINQ 查詢OData:選取系統查詢選項 ($select)

LINQ 查詢運算符

資料表記憶體支援下列 LINQ 查詢運算子:

  • From

  • Where

  • Take

如需詳細資訊,請參閱 數據表記憶體支援的查詢運算符

LINQ 比較運算符

您可以使用 LINQ 所提供的比較運算子集。 如需詳細資訊,請參閱 查詢數據表和實體 ,以及 針對數據表記憶體撰寫 LINQ 查詢

GetMetadataURI 方法

您可以使用 DataServiceContext 類別的 GetMetadataURI 方法,但不會傳回三個固定架構屬性以外的任何架構資訊。 這些屬性是 PartitionKeyRowKeyTimestamp

裝載格式

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 資料服務版本標頭

另請參閱

數據表記憶體 REST API