---
title: Dataset
seo:
  title: Dataset — Python SDK
  description: >-
    Reference for DatasetInfo, DatasetVersion, Dataset,
    example_to_dataset_entry, and example_from_dataset_entry. (Python SDK)
description: >-
  Reference for DatasetInfo, DatasetVersion, Dataset, example_to_dataset_entry,
  and example_from_dataset_entry.
sidebar:
  label: Overview
---

**Classes**

**[DatasetInfo](/sdk-reference/python/datasets/dataset/DatasetInfo)**

**[DatasetVersion](/sdk-reference/python/datasets/dataset/DatasetVersion)**

**[Dataset](/sdk-reference/python/datasets/dataset/Dataset)**

**Functions**

## \_batch\_examples()

Generator that yields batches of examples for efficient memory usage.

Works with any iterable including generators, consuming only batch\_size items at a time.

```python
def _batch_examples(examples, batch_size=100) -> Iterator[List[Example]]:
```

### Parameters

| Prop | Type | Default | Description |
| - | - | - | - |
| `examples` | `Iterable[Example]` | - | |
| `batch_size?` | `int` | `100` | |

### Returns

`Iterator[List[Example]]`

***

## example\_to\_dataset\_entry()

Serialize an `Example` into the dataset example payload shape.

The example's custom properties become the example data fields;
`example_id` and `created_at` are lifted to the top level. For a
trace-typed column (declared `{"type": "trace"}` in the dataset
schema), set the field to the trace id string.

```python
def example_to_dataset_entry(example) -> Dict[str, Any]:
```

### Parameters

| Prop | Type | Default | Description |
| - | - | - | - |
| `example` | `Example` | - | |

### Returns

`Dict[str, Any]`

***

## example\_from\_dataset\_entry()

Build an `Example` from a server dataset example payload.

The server returns examples as `{example_id, created_at, data,
offline_trace_id, metadata, ...}` with the example fields nested
under `data`.

```python
def example_from_dataset_entry(entry) -> Example:
```

### Parameters

| Prop | Type | Default | Description |
| - | - | - | - |
| `entry` | `Dict[str, Any]` | - | |

### Returns

`Example`