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

# dataset.getItemHistory()

**追加バージョン：** `@mastra/core@1.4.0`

特定の項目について、すべてのデータセットバージョンにわたる完全な SCD-2（Slowly Changing Dimension Type 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`): このバージョンの正解データ。

**result.metadata** (`Record<string, unknown>`): このバージョンのメタデータ。

**result.createdAt** (`Date`): この行が作成された日時。

**result.updatedAt** (`Date`): この行が最後に更新された日時。