跳至主要內容

dataset.getItem()

新增於: @mastra/core@1.4.0

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

使用範例
「使用範例」的直接連結

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()。