> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tinycloud.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# DuckDB

> Query, export, and import DuckDB databases

<Badge>Beta</Badge>

Use `tc duckdb` when you need DuckDB-specific query behavior instead of SQLite.

## Commands

```bash theme={null}
tc duckdb query "SELECT count(*) FROM events" --db analytics
tc duckdb execute "CREATE TABLE events (type VARCHAR)" --db analytics
tc duckdb describe --db analytics
tc duckdb export --db analytics --output analytics.duckdb
tc duckdb import analytics.duckdb --db analytics
```

## Notes

* `--db` chooses the DuckDB database name
* `--params` binds JSON-array parameters to `?` placeholders
* `query` and `describe` emit JSON with `--json`

DuckDB is beta. Prefer `tc sql` for ordinary application data unless you specifically need DuckDB.