使用表服务实体将复杂对象插入 Azure 表



我正在考虑将整个复杂对象添加到表中。来自老式的SQL方法,我显然会将其分成表格,但我正在尝试不同的方法。所以基本上我有一个对象,它由一个嵌套类(当你反序列化一个 json 集合时得到的东西)组成,它有通常的客户、业务和发票项列表。

public class Business
{
    public string _id { get; set; }
    public string name { get; set; }
    public string street_1 { get; set; }
    public string street_2 { get; set; }
    public string town { get; set; }
    public string county { get; set; }
    public string postcode { get; set; }
 //other fields as needed
}
public class Customer
{
    public string _id { get; set; }
    public string name { get; set; }
    public string street_1 { get; set; }
    public string street_2 { get; set; }
    public string town { get; set; }
    public string county { get; set; }
    public string postcode { get; set; }
    //other fields as needed
 }
public class InvoiceItems
{
    public string item_id { get; set; }
    public string price_per_unit { get; set; }
    public string quanity { get; set; }
    public string date { get; set; }
}
public class WholeObject
{
    public Customer customer { get; set; }
    public Business address { get; set; }
    public List<InvoiceItems> items { get; set; }
}

(真的是示例类)

除了 1MB 大小之外,将其插入表中是否有任何其他限制?我已经阅读了TableServiceEntity,它应该映射C#对象,但它会处理吗?在这个阶段,这是一个非常假设的问题,因为我实际上还没有尝试过编码它。任何帮助将不胜感激。

复杂属性不会保存到表存储中。 只能保留标准数据类型的子集。 有关支持哪些数据类型的详细信息,请查看此链接:https://learn.microsoft.com/rest/api/storageservices/Understanding-the-Table-Service-Data-Model#property-types

但是,你想做的是可能的,只是实施起来有点困难。 有两种方法可以完成此操作:

  • 公开 WholeObject 类上的"客户序列化"、"地址序列化"和"项目序列化"属性。 让这些属性将其关联的复杂对象序列化/反序列化为字节数组、json 或 xml。 此方法的两个缺点:a) 即使只需要 Customer 对象,也始终从 Azure 表存储加载完整的对象树;b) 每个对象的每个属性限制为 64kb,因此最好确保 InvoiceItems 集合可以适应 64kb 序列化

  • 提出一个 PartitionKey/RowKey
  • 架构,允许您将所有类型的相关对象保存为单个实体,但使用 PartitionKey/Rowkey 指示它们的关系。 这将允许您独立获取完整的对象树或单个子对象。 这种方法没有第一种方法的两个缺点,但在实施时绝对是复杂的一面。 它还限制了您根据其他业务需求调整分区键/行键的能力。我曾将这种方法用于一家大型电子商务公司,并取得了很大的成功。

在我的项目中,所有实体(根和子实体)的分区键都映射到"WholeObject"的ID,而RowKey由ParentObjectID,ChildObjectID和ChildObjectType的串联组合组成。 当需要检索 WHoleObject 中的所有对象时,只需对 PartitionKey 发出查询,否则使用 PartitionKey 和部分 RowKey 来获取某些类型的对象(即:所有地址),或使用 PartitionKey 和完整的 RowKey 来获取单个实体。 这种方法支持无限深度的对象树结构,但是,一旦实体数量超过 100 个,将对象存储在一个事务中是一个令人头疼的问题。

我遇到了类似的问题,并实现了一个通用的对象扁平化/重构器API,它将您的复杂实体扁平化为平面EntityProperty字典,并使它们能够以DynamicTableEntity的形式写入表存储。

然后,相同的 API 将从DynamicTableEntityEntityProperty字典中重构整个复杂对象。

看看: https://www.nuget.org/packages/ObjectFlattenerRecomposer/

用法:

//Flatten object of type Order) and convert it to EntityProperty Dictionary
 Dictionary<string, EntityProperty> flattenedProperties = EntityPropertyConverter.Flatten(order);
// Create a DynamicTableEntity and set its PK and RK
DynamicTableEntity dynamicTableEntity = new DynamicTableEntity(partitionKey, rowKey);
dynamicTableEntity.Properties = flattenedProperties;
// Write the DynamicTableEntity to Azure Table Storage using client SDK
//Read the entity back from AzureTableStorage as DynamicTableEntity using the same PK and RK
DynamicTableEntity entity = [Read from Azure using the PK and RK];
//Convert the DynamicTableEntity back to original complex object.
 Order order = EntityPropertyConverter.ConvertBack<Order>(entity.Properties);

从那时起,我与 Azure 团队合作,并将此功能集成到 Azure 存储 SDK 版本 8.0。

需要注意的是,Azure SDK 中的 api 不支持IEnumerableICollection类型属性。但是,如果在上面的链接中获取 nuget 包 v2,则几乎可以将任何对象写入 Azure 表存储,包括具有可枚举集合类型属性的对象。

https://msdn.microsoft.com/en-us/library/microsoft.windowsazure.storage.table.tableentity.flatten.aspx

https://msdn.microsoft.com/en-us/library/azure/mt775432.aspx

我还在 SDK 版本 8.2.0 中添加了TableEntityAdapter类,以便更轻松地使用。只需将复杂实体传递给其构造函数,它就会透明地处理在写入和读取时展平/转换回复杂对象。https://github.com/Azure/azure-storage-net/blob/master/Lib/Common/Table/TableEntityAdapter.cs

相关内容

  • 没有找到相关文章

最新更新