使用進階映射功能

了解 DynamoDB 增強型用戶端 中的進階資料表結構描述功能API。

了解資料表結構描述類型

TableSchema 是 DynamoDB 增強型用戶端 的映射功能的介面API。它可以在 的映射中映射資料物件AttributeValues。TableSchema 物件需要知道要映射之資料表的結構。此結構資訊會儲存在 TableMetadata 物件中。

增強型用戶端API具有數個 實作TableSchema，如下。

從註釋類別產生的資料表結構描述

從TableSchema註釋類別建置 是一項中等昂貴的操作，因此我們建議在應用程式啟動時執行此操作一次。

BeanTableSchema

此實作是根據 Bean 類別的屬性和註釋建置。此方法的範例示範於入門章節 。

注意

如果 BeanTableSchema 的行為不如預期，請啟用 的偵錯記錄software.amazon.awssdk.enhanced.dynamodb.beans。

ImmutableTableSchema

此實作是從不可變的資料類別建置而成。此方法在 使用不可變的資料類別章節中說明。

使用建置器產生的資料表結構描述

下列 TableSchema是使用建置器從程式碼建置。此方法的成本低於使用註釋資料類別的方法。建置器方法可避免使用註釋，且不需要 JavaBean 命名標準。

StaticTableSchema

此實作專為可變資料類別而建置。本指南的入門章節示範如何使用StaticTableSchema建置器 產生 。

StaticImmutableTableSchema

與您建置 的方式類似StaticTableSchema，您可以使用TableSchema建置器來產生此類型 的實作，以搭配不可變的資料類型使用。

無固定結構描述之資料的資料表結構描述

DocumentTableSchema

與其他 實作不同TableSchema，您不會定義DocumentTableSchema執行個體的屬性。一般而言，您只能指定主要金鑰和屬性轉換器提供者。EnhancedDocument 執行個體提供您從個別元素或JSON字串建置的屬性。