Skip to content
Storage

冰山目录

分析桶需要使用两个不同的服务进行身份验证：

🌐 Analytics buckets require authentication with two distinct services:

架构概览 #

🌐 Architecture overview

Iceberg REST Catalog 作为你的 Iceberg 表的元数据管理系统。它让像 PyIceberg 和 Apache Spark 这样的 Iceberg 客户端可以执行关键操作：

  • 创建和管理表格与命名空间
  • 跟踪模式和处理模式演变
  • 管理分区和表快照
  • 确保交易的一致性和隔离性

REST 目录只存储描述你数据的结构、模式和分区策略的元数据——而不是实际的数据本身。

🌐 The REST Catalog only stores metadata describing your data's structure, schema, and partitioning strategy—not the actual data itself.

S3 兼容存储端点 处理实际的数据存储和检索。它针对存储在 Parquet 格式的大型分析数据集的读写进行了优化，与元数据管理层是分开的。

身份验证设置 #

🌐 Authentication setup

要连接到分析桶，你需要：

🌐 To connect to an analytics bucket, you need:

1. S3 凭证 #

🌐 1. S3 credentials

通过 项目设置 > 存储 创建 S3 凭证。详细说明请参阅 S3 认证指南。

🌐 Create S3 credentials through Project Settings > Storage. See the S3 Authentication Guide for detailed instructions.

你将获得：

🌐 You'll obtain:

  • 访问密钥 ID
  • 秘密访问密钥
  • 地区（例如，us-east-1）

2. Supabase 服务密钥 #

🌐 2. Supabase service key

从 项目设置 > API 获取你的服务密钥。这个密钥用于验证对 Iceberg REST 目录的请求。

🌐 Retrieve your Service Key from Project Settings > API. This key authenticates requests to the Iceberg REST Catalog.

3. 项目参考 #

🌐 3. Project reference

你的 Supabase 项目引用就是你项目 URL 中的子域名（例如，在 https://your-project-ref.supabase.co 中的 your-project-ref）。

🌐 Your Supabase project reference is the subdomain in your project URL (e.g., your-project-ref in https://your-project-ref.supabase.co).

正在测试你的连接 #

🌐 Testing your connection

你可以通过向 Iceberg REST Catalog 直接发起请求来验证你的设置。将你的服务密钥作为 Bearer 令牌提供：

🌐 You can verify your setup by making a direct request to the Iceberg REST Catalog. Provide your Service Key as a Bearer token:

1
curl \
2
  --request GET -sL \
3
  --url 'https://<your-project-ref>.supabase.co/storage/v1/iceberg/v1/config?warehouse=<bucket-name>' \
4
  --header 'Authorization: Bearer <your-service-key>'

成功的响应会返回包含仓库位置和设置的目录配置。

🌐 A successful response returns the catalog configuration including warehouse location and settings.

下一步 #

🌐 Next steps