> Discover all available pages from the documentation index: https://mastra.zisheng.pro/zh-TW/llms.txt

# dataset.getItemHistory()

**新增於：** `@mastra/core@1.4.0`

取得特定項目在所有資料集版本中的完整 SCD-2（緩慢變更維度類型 2）歷史記錄。

## 使用範例

```typescript
import { Mastra } from '@mastra/core'

const mastra = new Mastra({/* storage config */})

const dataset = await mastra.datasets.get({ id: 'dataset-id' })

const history = await dataset.getItemHistory({ itemId: 'item-id' })

for (const row of history) {
  console.log(`Version ${row.datasetVersion}: ${row.isDeleted ? 'deleted' : 'active'}`)
}
```

## 參數

**itemId** (`string`): 要取得歷史記錄的項目 ID。

## 傳回值

**result** (`Promise<DatasetItemRow[]>`): 依版本排序的項目版本記錄陣列。

**result.id** (`string`): 記錄的唯一識別碼。

**result.datasetId** (`string`): 父資料集的 ID。

**result.datasetVersion** (`number`): 此記錄對應的資料集版本。

**result.validTo** (`number | null`): 此記錄被取代時的版本；如果仍為目前記錄，則為 null。

**result.isDeleted** (`boolean`): 此記錄是否表示刪除操作。

**result.input** (`unknown`): 此版本的輸入資料。

**result.groundTruth** (`unknown`): 此版本的 ground truth。

**result.metadata** (`Record<string, unknown>`): 此版本的中繼資料。

**result.createdAt** (`Date`): 此記錄的建立時間。

**result.updatedAt** (`Date`): 此記錄的最後更新時間。