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

# 데이터세트.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`): 이 행이 마지막으로 업데이트된 시점입니다.