Files
supabase/apps/docs/content/guides/storage/analytics/creating-analytics-buckets.mdx
T
95750574d2 feat(docs): add scaffolding for iceberg docs (#36888)
* feat(docs): add scaffolding for iceberg docs

* docs:(storage/iceberg): Analytical buckets docs

* Apply suggestions from code review

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Charis <26616127+charislam@users.noreply.github.com>

* fix(docs): update analytics buckets docs

* nav reorg

* doc: analytics buckets limit section

* fix ci errors

---------

Co-authored-by: fenos <fabri.feno@gmail.com>
Co-authored-by: Inian <inian1234@gmail.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2025-07-15 14:16:23 +00:00

39 lines
1.6 KiB
Plaintext

---
title: 'Creating Analytics Buckets'
subtitle: ''
---
<Admonition type="caution">
This feature is in **Private Alpha**. API stability and backward compatibility are not guaranteed at this stage. Reach out from this [Form](https://forms.supabase.com/analytics-buckets) to request access
</Admonition>
Analytics Buckets use [Apache Iceberg](https://iceberg.apache.org/), an open-table format for managing large analytical datasets.
You can interact with them using tools such as [PyIceberg](https://py.iceberg.apache.org/), [Apache Spark](https://spark.apache.org/) or any client which supports the [standard Iceberg REST Catalog API](https://editor-next.swagger.io/?url=https://raw.githubusercontent.com/apache/iceberg/main/open-api/rest-catalog-open-api.yaml).
You can create an Analytics Bucket using either the Supabase SDK or the Supabase Dashboard.
### Using the Supabase SDK
```ts
import { createClient } from '@supabase/supabase-js'
const supabase = createClient('https://your-project.supabase.co', 'your-service-key')
supabase.storage.createBucket('my-analytics-bucket', {
type: 'ANALYTICS',
})
```
### Using the Supabase Dashboard
1. Navigate to the Storage section in the Supabase Dashboard.
2. Click on "Create Bucket".
3. Enter a name for your bucket (e.g., my-analytics-bucket).
4. Select "Analytics Bucket" as the bucket type.
<img alt="Storage schema design" src="/docs/img/storage/iceberg-bucket.png" />
Now, that you have created your Analytics Bucket, you can start [connecting to it](/docs/guides/storage/analytics/connecting-to-analytics-bucket) with Iceberg clients like PyIceberg or Apache Spark.