---
warning: DO NOT CHANGE THIS MANUALLY, THIS IS GENERATED BY https://github/duckdb/community-extensions repository, check README there
title: rrd
excerpt: |
  DuckDB Community Extensions
  Read and write Rerun .rrd recording files, including live recordings

extension:
  name: rrd
  description: Read and write Rerun .rrd recording files, including live recordings
  version: 0.1.0
  language: Rust
  build: cargo
  license: MIT
  excluded_platforms: "wasm_mvp;wasm_eh;wasm_threads;windows_amd64_rtools;linux_amd64_musl"
  requires_toolchains: "rust;python3"
  maintainers:
    - rozgo

repo:
  github: VertexStudio/duckdb-rrd
  ref: v0.1.0

docs:
  hello_world: |
    -- Scan a Rerun recording (works while it is still being written)
    SELECT * FROM read_rrd('recording.rrd', entity => '/metrics/**', timeline => 'frame');

    -- What is inside?
    SELECT * FROM rrd_schema('recording.rrd');

    -- Export query results as a new Rerun recording
    COPY (SELECT frame, loss FROM training_metrics)
    TO 'metrics.rrd' (FORMAT rrd, ENTITY '/metrics', TIMELINE 'frame', COLUMNS 'frame,loss');
  extended_description: |
    Query [Rerun](https://rerun.io) `.rrd` recordings with SQL: one row per
    time point, one column per entity/component, with real DuckDB types
    (nested lists, structs, blobs). Scans tolerate a partially-written tail,
    so live recordings can be polled while another process appends to them.
    `COPY ... TO (FORMAT rrd)` writes query results back out as recordings
    the Rerun viewer opens natively.

extension_star_count: 0
extension_star_count_pretty: 0
extension_download_count: 643
extension_download_count_pretty: 643
image: '/images/community_extensions/social_preview/preview_community_extension_rrd.png'
layout: community_extension_doc
---

### Installing and Loading
```sql
INSTALL {{ page.extension.name }} FROM community;
LOAD {{ page.extension.name }};
```

{% if page.docs.hello_world %}
### Example
```sql
{{ page.docs.hello_world }}```
{% endif %}

{% if page.docs.extended_description %}
### About {{ page.extension.name }}
{{ page.docs.extended_description }}
{% endif %}

### Added Functions

<div class="extension_functions_table"></div>

| function_name  | function_type | description | comment | examples |
|----------------|---------------|-------------|---------|----------|
| read_rrd       | table         | NULL        | NULL    |          |
| rrd_entities   | table         | NULL        | NULL    |          |
| rrd_recordings | table         | NULL        | NULL    |          |
| rrd_schema     | table         | NULL        | NULL    |          |

### Overloaded Functions

<div class="extension_functions_table"></div>

This extension does not add any function overloads.

### Added Types

<div class="extension_types_table"></div>

This extension does not add any types.

### Added Settings

<div class="extension_settings_table"></div>

This extension does not add any settings.