rembrembdocs
← supabaseoriginal source ↗

Creating Analytics Buckets

Set up your first analytics bucket using the SDK or dashboard.

This feature is in Private Alpha. API stability and backward compatibility are not guaranteed at this stage. Request access through this form.

Analytics buckets use Apache Iceberg, an open-table format for efficient management of large analytical datasets. You can interact with analytics buckets using tools such as PyIceberg, Apache Spark, or any client supporting the Iceberg REST Catalog API.

About replication

Analytics Buckets are still available, but managed replication into Analytics Buckets through Supabase ETL is no longer supported. If you need managed replication today, use Database Replication with BigQuery. If you want to use Analytics Buckets, bring your own ingestion pipeline.

Creating an Analytics bucket#

You can create an analytics bucket using either the Supabase SDK or the Supabase Dashboard.

Using the Supabase SDK#

1import { createClient } from '@supabase/supabase-js'23const supabase = createClient('https://your-project-id.supabase.co', 'your-service-key')45const { data, error } = await supabase.storage.analytics.createBucket('analytics-data')67if (error) {8  console.error('Failed to create analytics bucket:', error)9} else {10  console.log('Analytics bucket created:', data)11}

Using the Supabase Dashboard#

  1. Navigate to the Storage section in the Supabase Dashboard.
  2. Click Create Bucket.
  3. Enter a name for your bucket (e.g., my-analytics-bucket).
  4. Select Analytics Bucket as the bucket type.
  5. Click Create.

Create Analytics Bucket in Dashboard

Next steps#

Once you've created your analytics bucket, you can: