本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 搭配 DynamoDB Mapper 使用次要索引
<a name="ddb-mapper-secondary-indices"></a>

****  
**DynamoDB Mapper 是開發人員預覽版本。其功能不完整，可能會有所變更。**

## 定義次要索引的結構描述
<a name="ddb-mapper-secondary-indices-schema"></a>

DynamoDB 資料表支援次要索引，該索引可使用與基礎資料表本身上定義的索引鍵不同的索引鍵來存取資料。如同基礎資料表，DynamoDB Mapper 會使用 `[ItemSchema](https://docs.aws.amazon.com/sdk-for-kotlin/api/latest/dynamodb-mapper/aws.sdk.kotlin.hll.dynamodbmapper.items/-item-schema/index.html)`類型與索引互動。

DynamoDB 次要索引不需要包含基礎資料表中的每個屬性。因此，對應至索引的 Kotlin 類別可能與對應至該索引基礎資料表的 Kotlin 類別不同。在這種情況下，必須為索引類別宣告單獨的結構描述。

下列程式碼會手動建立 DynamoDB `cars`資料表的索引結構描述。

```
import aws.sdk.kotlin.hll.dynamodbmapper.items.ItemConverter
import aws.sdk.kotlin.hll.dynamodbmapper.items.ItemSchema
import aws.sdk.kotlin.hll.dynamodbmapper.model.itemOf

// This is a data class for modelling the index of the Car table. Note
// that it contains a subset of the fields from the Car class and also 
// uses different names for them.
data class Model(val name: String, val manufacturer: String)

// We define an item converter.
val modelConverter = object : ItemConverter<Model> {
    override fun convertTo(from: Model, onlyAttributes: Set<String>?): Item  = itemOf(
        "model" to AttributeValue.S(from.name),
        "make" to AttributeValue.S(from.manufacturer),
    )

    override fun convertFrom(to: Item): Model = Model(
        name = to["model"]?.asSOrNull() ?: error("Invalid attribute `model`"),
        manufacturer = to["make"]?.asSOrNull() ?: error("Invalid attribute `make`"),
    )
}
val modelKey = KeySpec.String("model")
val makeKey = KeySpec.String("make")

val modelSchema = ItemSchema(modelConverter, modelKey, makeKey) // The partition key specification is the second parameter.

/* Note that `Model` index's partition key is `model` and its sort key is `make`,
   whereas the `Car` base table uses `make` as the partition key and `model` as the sort key:

        @DynamoDbItem
        data class Car(
            @DynamoDbPartitionKey
            val make: String,
    
            @DynamoDbSortKey
            val model: String,
    
            val initialYear: Int
        )
*/
```

我們現在可以在 操作中使用`Model`執行個體。

## 在 操作中使用次要索引
<a name="ddb-mapper-gs-index-ops"></a>

DynamoDB Mapper 支援索引上的操作子集，即 `queryPaginated`和 `scanPaginated`。若要在索引上調用這些操作，您必須先從資料表物件取得索引的參考。在下列範例中，我們使用先前為`cars-by-model`索引`modelSchema`建立的 （此處未顯示建立）：

```
val table = mapper.getTable("cars", CarSchema)
val index = table.getIndex("cars-by-model", modelSchema)

val modelFlow = index
    .scanPaginated { }
    .items()

modelFlow.collect { model -> println(model) }
```