---
title: "Split data into multiple rows with iterators"
description: "Transform a single document, video, image, or audio file into multiple rows for granular processing."
url: "https://www.pixeltable.com/notebooks/data-split-rows"
updated: "2026-06-03"
---

# Split data into multiple rows with iterators

Transform a single document, video, image, or audio file into multiple rows for granular processing.

- **Type:** Notebook
- **Group:** Core Operations

## What it covers

- Split documents into text chunks for RAG
- Extract frames or segments from videos
- Tile images for high-resolution analysis
- Chunk audio files for transcription

## What it uses

- **Install:** `pip install pixeltable spacy tiktoken click`
- **Pixeltable calls:** `document.document_splitter()`, `video.frame_iterator()`, `video.video_splitter()`, `string.string_splitter()`, `image.tile_iterator()`, `audio.audio_splitter()`, `pxt.create_table()`, `pxt.create_view()`, `insert()`, `sample()`

## A look at the code

```python
from pixeltable.functions.video import frame_iterator

videos = pxt.create_table('split_demo/videos', {'video': pxt.Video})
videos.insert(
    [
        {
            'video': 'https://github.com/pixeltable/pixeltable/raw/main/docs/resources/bangkok.mp4'
        }
    ]
)
```

## Open it

- **Open in Colab:** https://colab.research.google.com/github/pixeltable/pixeltable/blob/release/docs/release/howto/cookbooks/core/data-split-rows.ipynb
- **Docs page:** https://docs.pixeltable.com/howto/cookbooks/core/data-split-rows
- **Source on GitHub:** https://github.com/pixeltable/pixeltable/blob/release/docs/release/howto/cookbooks/core/data-split-rows.ipynb