Manage Warehouses
Warehouses define storage locations where Iceberg table data files reside. Every catalog requires a warehouse, and location mappings use warehouses to translate file paths during replication.
Add a Warehouse
- Navigate to Iceberg > Warehouses
- Click Add New Warehouse
- Enter a Name (e.g.
production-s3) - Enter the Location — the root path to the storage location
- Optionally add Notes
- Click Create
Common location formats:
| Storage | Example |
|---|---|
| S3 | s3://bucket-name/warehouse |
| HDFS | hdfs://nameservice1/warehouse |
| Azure ADLS | abfss://container@account.dfs.core.windows.net/warehouse |
| GCS | gs://bucket-name/warehouse |
| Local filesystem | file:///opt/warehouse |
Edit a Warehouse
- Open the warehouse from Iceberg > Warehouses
- Click the Settings tab
- Modify the name, location, or notes
- Click Save
Delete a Warehouse
- Open the warehouse and click the Settings tab
- Click Delete Warehouse
A warehouse cannot be deleted if it is referenced by any catalog or location mapping. Remove those references first.
Location Mappings
Location mappings define how file paths are translated when replicating between catalogs that use different storage backends. Without a mapping, Ice Flow cannot determine where to write data files on the target.
Create a Location Mapping
- Navigate to Iceberg > Replications and click the Location Mappings tab
- Click Create New Location Mapping
- Select the Source warehouse and enter the Source path
- Select the Target warehouse and enter the Target path
- Click Create
Example
If your source catalog stores data at s3://prod-bucket/warehouse and your
target uses s3://dr-bucket/warehouse:
| Field | Value |
|---|---|
| Source warehouse | production-s3 |
| Source path | s3://prod-bucket/warehouse |
| Target warehouse | dr-s3 |
| Target path | s3://dr-bucket/warehouse |
During replication, a file at s3://prod-bucket/warehouse/db/table/data-001.parquet
will be written to s3://dr-bucket/warehouse/db/table/data-001.parquet.
Associate a Mapping with a Replication
Location mappings are global. To use a mapping with a replication, associate it on the replication's Mappings tab.
Edit or Delete a Mapping
Open the mapping from the Location Mappings list. The detail page shows the full mapping configuration and provides options to edit notes or delete the mapping.