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

# dataset.getItemHistory()

**Ajouté dans :** `@mastra/core@1.4.0`

Récupère l’historique complet SCD-2 (dimension à variation lente de type 2) d’un élément précis dans toutes les versions du dataset.

## Exemple d’utilisation

```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'}`)
}
```

## Paramètres

**itemId** (`string`): ID de l’élément dont l’historique doit être récupéré.

## Valeur renvoyée

**result** (`Promise<DatasetItemRow[]>`): Tableau de lignes d’élément versionnées, classées par version.

**result.id** (`string`): Identifiant unique de la ligne.

**result.datasetId** (`string`): ID du dataset parent.

**result.datasetVersion** (`number`): Version du dataset correspondant à cette ligne.

**result.validTo** (`number | null`): Version à laquelle cette ligne a été remplacée, ou null si elle est toujours actuelle.

**result.isDeleted** (`boolean`): Indique si cette ligne représente une suppression.

**result.input** (`unknown`): Données d’entrée dans cette version.

**result.groundTruth** (`unknown`): Vérité terrain dans cette version.

**result.metadata** (`Record<string, unknown>`): Métadonnées dans cette version.

**result.createdAt** (`Date`): Date de création de cette ligne.

**result.updatedAt** (`Date`): Date de la dernière mise à jour de cette ligne.