Skip to main content
A data catalog is a central registry that tracks a table’s schema, partitions, and file locations, so a query engine can look those up instead of scanning a bucket to rediscover them. If your tables are already registered in one of the catalogs below, StarTree reads that registry directly — you get schema inference, partition awareness, and incremental snapshot sync for free, instead of the raw file-scanning approach in Query Parquet Directly.

​
Which catalog do you have?

All four are reached the same way — catalogType=iceberg-rest — over the Iceberg REST protocol; only the service endpoint and authentication differ. Not sure which authentication method to use for your catalog, or whether a given feature (assumed-role auth, vended credentials, OAuth2) is supported? Each catalog’s onboarding guide has an Authentication section with a runnable config sample per method.

​
How onboarding works, regardless of catalog

Every catalog above follows the same four calls: validate & browse the connection, preview to infer a schema, create the schema, then create the table — after which the controller’s watcher takes over and syncs on a schedule with no further manual steps. Each catalog’s onboarding guide walks through all four with runnable examples.

​
What’s next

Once the table is created, add indexes for the columns you filter and group by, enable caching, and track sync health through Observability.