Skip to main content

dataset_versions

Creates, updates, deletes, gets or lists a dataset_versions resource.

Overview

Namedataset_versions
TypeResource
Iddatadog.llm_observability.dataset_versions

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringUnique identifier of the dataset version. (example: 3fd6b5e0-8910-4b1c-a7d0-5b84de329012)
attributesobjectAttributes of an Agent Observability dataset version.
typestringResource type of an Agent Observability dataset version. (dataset_version) (example: dataset_version)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_llmobs_dataset_versionsselectproject_id, dataset_idList the active versions of a dataset. A version is created each time a dataset is referenced by an experiment run.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
dataset_idstringThe ID of the Agent Observability dataset. (example: 9f64e5c7-dc5a-45c8-a17c-1b85f0bec97d)
project_idstringThe ID of the Agent Observability project. (example: a33671aa-24fd-4dcd-9b33-a8ec7dde7751)
sitestringThe Datadog site (region) for your organization, for example datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com, ap2.datadoghq.com, datadoghq.eu, ddog-gov.com. Resolved from the DD_SITE environment variable when set. Optional: defaults to datadoghq.com, or the value of the DD_SITE environment variable when set; a WHERE value overrides both.

SELECT examples

List the active versions of a dataset. A version is created each time a dataset is referenced by an experiment run.

SELECT
id,
attributes,
type
FROM datadog.llm_observability.dataset_versions
WHERE project_id = '{{ project_id }}' -- required
AND dataset_id = '{{ dataset_id }}' -- required
;