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

# dataset.getItem()

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

依 ID 取得單一資料集項目，也可以指定資料集版本。

## 使用範例

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

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

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

// Get latest version of an item
const item = await dataset.getItem({ itemId: 'item-id' })

// Get item at a specific dataset version
const versionedItem = await dataset.getItem({ itemId: 'item-id', version: 2 })
```

## 參數

**itemId** (`string`): 項目的唯一識別碼。

**version** (`number`): 要取得項目時對應的資料集版本。預設為最新版本。

## 傳回值

**result** (`Promise<DatasetItem | null>`): 資料集項目；如果找不到則為 null。項目結構請參閱 dataset.addItem()。