Skip to main content
DuckDB is an in-process analytics database that can read files straight from S3 storage and write results back. Its httpfs extension works against a Tapedrive bucket with a secret that holds the gateway and your keys.

Before you start

You need a bucket and a credential. A bucket is a tape that has delegated writes to the gateway, and a credential is an access key pair the gateway operator issues you. Set up a bucket walks through both.

Configure

DuckDB addresses buckets as subdomains by default, which needs a wildcard DNS record on your gateway. If you do not have one, add URL_STYLE 'path' to the secret. Both work.

Everyday queries

A filtered read fetches only the byte ranges it needs, so a query over a large Parquet file does not download the file. Writing 2,000,000 rows to Parquet takes about a second and produces a file identical to the same COPY written locally.

Good to know

  • Each COPY is one object write. Partitioned output writes one object per partition.

Next